Harness 面向 Codex 智能体与技能设计，是在目标项目中构建、迁移、扩展、检查和同步项目级 harness 的元技能。
用途
- 为项目生成合适的角色、执行流程与协作契约，并进行验证。主会话是编排者：智能体定义角色，技能定义可复用流程。
- 在显式调用 $harness 或 $codex-harness:harness 时，把构建或更新 harness 作为默认任务；即使伴随请求是“就这个主题调研并写文章”这类普通表述，也先为目标项目搭建可复用 harness，再在该项目中完成伴随任务。空目录也可作为目标项目。
- 未显式调用时，仅在用户要求构建、修改或检查 harness 本身时才应用。普通调研、写作、代码修改或智能体概念问答不会被转成自动构建 harness 的请求。
主要能力
- 目标项目范围为用户指定路径；未指定时为当前工作目录的项目，不把插件缓存或技能源码仓库误认为目标项目。
- 角色定义固定放在目标项目的 .codex/agents/*.toml；技能、AGENTS.md、所需项目配置、.harness/ 运行记录和 _workspace/communications/ 记录也放在目标项目下，不写入个人范围 ~/.codex/agents/ 或插件缓存。
- 流程分为阶段：Phase 0 现状审计、Phase 1 领域分析、Phase 2 团队架构设计、Phase 3 智能体定义生成、Phase 4 技能生成、Phase 5 集成与编排、Phase 6 验证与测试、Phase 7 演进与维护。
- 团队架构可选择流水线、扇出/扇入、专家池、生成-验证、监督者、层级委派等模式的组合，并为每个任务明确项目根、输入指纹、决定、技能路径、依赖、负责角色、可写路径、产物、验证方式与重试上限。
- 可生成基础角色 harness_explorer、harness_architect、harness_worker、harness_reviewer、harness_qa 中所需的部分；角色文件与同时执行数量是两件事。
- 提供 create_agent.py、validate.py、run.py 等脚本用于生成角色、验证结构、初始化运行计划与登记结果；validate.py 只检查结构，不证明实际执行成功。
使用方式示例（在目标项目根执行）
python3 .agents/skills/harness/scripts/create_agent.py
--target . --name domain_worker
--description '도메인 변환 규칙을 구현하는 워커'
--instructions-file .harness/domain-worker-instructions.md
--sandbox-mode workspace-write
验证： python3 .agents/skills/harness/scripts/validate.py --project .
限制与约束
- 需要先确认目标项目与子智能体工具的实际暴露情况，不能仅凭工具暴露或静态验证判断可执行；父会话不在目标项目目录时，不创建用于项目任务的子智能体，需在目标项目新开 Codex 会话后重新确认。
- 不假设子智能体自动加载技能、不假设存在 Skill 调用工具、不假设整体对话继承或特定 fork 选项；默认子智能体不再递归委派。
- 修改同一文件的任务需串行化或由主会话整合；模型与推理等级继承父设置，除非明确要求不固定特定模型，且不改全局配置。
- 若 .agents/skills/ 或 .codex/agents/ 写入被沙箱拒绝，需报告失败路径与原始错误并保持未完成，不把技能或角色定义改写到他处，也不擅自更改权限模式。
- 测试与构建共用缓存时需串行执行；QA 修改默认最多迭代 2 次，之后仍失败的必须项保持失败；未执行的测试不报告为通过。
适用场景 需要为 Codex 项目建立可复用角色与流程、迁移或检查既有 harness、让调研/写作/代码等伴随任务在项目级 harness 下执行，以及需要结构验证与运行记录管理的场景。