Harness 怎么扩展？skill、配置目录与 hook 是什么关系？
Harness 的扩展能力主要依赖 skill、配置目录和 hook 三者的协同工作。理解这三者之间的关系，能帮助开发者更高效地定制 AI 工具的行为，让 Agent 在不同场景下保持一致性和可控性。
Harness 扩展的核心概念
Harness 本质上是一个模型之外的工程系统，它通过 skill、配置目录和 hook 把模型的推理能力与实际工作流程、约束机制、安全边界连接起来。skill 是可复用的工作方法或工程经验，配置目录负责存放和管理这些 skill 的元数据，hook 则定义了 skill 在何时、以何种方式被触发。
三者相互配合：skill 提供内容，配置目录提供组织方式，hook 提供触发时机。只有把三者设计好，Harness 才能真正从单人提示词升级为团队可维护的工程资产。
配置文件与 hook 的对比
不同工具对 hook 的实现方式存在差异。以 Codex 和另一个常见平台为例：
| 项目 | Codex（.codex/hooks.toml） | 另一平台（settings.json） |
|---|---|---|
| 配置文件格式 | TOML | JSON |
| 事件总数 | 10 个 | 32 个 |
| 处理器类型 | command / prompt / agent | command / http / mcp_tool / prompt / agent |
| 独有事件 | SubagentStart、PreCompact 等 | SessionEnd、PermissionDenied 等 |
| 信任机制 | trusted_hash 校验 | 依赖文件系统权限 |
Codex 的 hook 数量较少，但事件更聚焦于工程流程；另一平台事件更丰富，适合需要精细权限控制的场景。开发者可根据团队实际需求选择。
如何寻找、安装和管理 AI Skill
公开 Skill 主要通过以下目录获取：
- https://skills-hub.ai/：通用国际目录，分类清晰，适合按用途筛选。
- https://skillhub.cn/：国内镜像，访问更快，中文内容更丰富。
- https://github.com/bytedance/deer-flow：字节生态示例，可学习 Skill 的组织方式。
寻找 Skill 时不必被数量左右，重点查看原仓库和 SKILL.md 文件。优质 Skill 的判断标准包括：来源可靠（官方或大厂维护）、仓库活跃、安装量高、描述与内容匹配。安装前务必阅读 SKILL.md，确认触发时机、具体流程及是否与现有 Skill 冲突。
如何从零开发一个工业级 Skill
工业级 Skill 建议使用 skill-forge 目录结构，命令如下：
mkdir -p skill-forge/{references,assets,scripts,agents}
完成后目录应呈现如下层级：
cases/
skill-forge/ 工作区
skill-forge/ 真正的 Skill 包
references/
assets/
scripts/
agents/
外层 cases/skill-forge 用于存放文章、测试记录等临时材料，内层 skill-forge 才是可分发、可迁移的 Skill 包。开发时把核心工程判断写在 agents 和 scripts 中，把平台差异隔离在 references 和 assets 中。
如何让 Skill 同时运行在 Cursor、Codex 和 Claude Code 里
Skill 的核心价值在于封装团队经验，而非绑定单一工具。编写时应把平台胶水代码放在边缘，核心流程保持通用。显式触发高风险操作（如刷板、提交代码），把可验证部分交给脚本。
如果暂时没有精力做跨平台适配，可直接让当前 AI 工具把现有 Skill 改写为目标平台可识别的形式，同时保留原有工程流程和安全边界。这样写出的 Skill 才能真正成为团队可长期维护的工程资产。
小白速通 Codex App：插件与 Skill 的创建
小白使用 Codex App 时，建议先安装少量必要插件，避免权限和上下文过于复杂。Skill 可理解为可复用的工作方法，例如“先读项目再改文件”“改完必须说明变动”“不确定时明确说明”。
Codex App 提供了快捷的 Skill 创建入口，建议先创建三个常用 Skill，逐步积累后再扩展。插件和 Skill 配合使用，能让 Codex 在不同项目中保持一致的行为规范。
通过合理设计 skill、配置目录与 hook 的关系，Harness 的扩展能力将从个人提示词逐步演进为团队级的工程基础设施。