Claude Code 作为 Anthropic 推出的智能编程助手，具备强大的代码理解与生成能力。然而，在实际生产环境中，未经约束的代理工作往往会出现计划漂移、测试遗漏、评审滞后等问题。claude-code-harness 正是为解决这一痛点而设计的专用开发框架，它通过结构化的 Plan→Work→Review→Ship 循环，将 AI 辅助开发转化为可复现、可审计的工程实践。
核心循环：从混沌到有序
claude-code-harness 的设计哲学源于对 AI 代理工作模式的深度观察。原始状态下，开发计划往往散落在对话历史中，测试成为可选步骤，代码审查发生在实现完成后，发布证据依赖人工回忆重建。Harness 通过五个动词技能 ——plan、work、review、sync、release—— 将这一过程固化为可重复的交付路径。
这一循环的入口是 /harness-plan 命令。开发者用自然语言描述期望的产出，框架自动生成 spec.md（规格定义）和 Plans.md（执行计划）两份契约文件。spec.md 明确范围、验收标准、未知项和停止条件；Plans.md 则将工作拆解为可独立执行的任务单元。对于非平凡的计划，框架会启用 team_validation_mode，从子代理视角、手动验证视角等多维度检查规格与计划的匹配性、记忆复用性、产品契合度、安全合规性以及实践可行性。
契约驱动：计划即真相
Harness 的核心创新在于将 spec.md 和 Plans.md 确立为单一事实来源（source of truth）。代理未见过的数据被标记为 unknown，而非被静默虚构。这种设计有效遏制了 AI 幻觉对代码质量的侵蚀。
用户在这一流程中的角色并非手动编写计划，而是审批或修正生成的契约。当计划获得批准后，开发者通过 /harness-work 执行特定任务（如 /harness-work 1.1.1），或运行 /harness-work all 批量处理整个计划。执行阶段强制要求测试驱动开发（TDD），确保每个实现都伴随验证，且工作始终被约束在已批准的计划范围内。
独立评审与证据打包
代码审查与实现分离是 Harness 的另一关键设计。/harness-review 命令触发独立的评审流程，将重大发现视为阻塞项（blocker），而非可忽略的建议。这种机制模拟了人工代码审查的严格性，防止 AI 自我验证时的确认偏误。
通过评审后，/harness-release 负责检查发布就绪状态、CHANGELOG 边界和标签规范，最终打包验证证据。值得注意的是，Harness 明确区分 "PR 就绪" 与 "发布就绪"，强调发布前检查必须在发布路径上通过，而非仅在开发分支上验证。
多工具兼容与渐进采用
claude-code-harness 不仅服务于 Claude Code，还提供对 Codex CLI、OpenCode 的兼容支持，并将 Cursor、GitHub Copilot CLI 列为候选适配目标。这种设计体现了框架的开放性：核心工作流模式可以迁移到不同 AI 编程工具，而不仅限于单一平台。
对于已有项目的迁移，框架提供 bin/harness doctor --migration-report 命令，在不删除任何数据的前提下，清点旧的插件缓存、重复的 Codex 技能、符号链接和内存状态，为平滑过渡提供安全保障。
可落地的参数配置
在实际部署中，建议采用以下配置策略：
项目初始化：运行 /harness-setup 安装项目指导、命令表面、钩子和检查点，确保工作流从已知基线启动。
任务粒度：首次使用选择小型请求（如 "改进 README onboarding 流程"），验证 /harness-plan 生成的契约质量后再扩展至复杂功能。
执行模式选择：简单任务使用 Solo 模式单代理端到端处理；独立任务可采用 Parallel 模式并行加速；复杂依赖任务启用 Breezing 模式，通过 Planner/Critic/Worker 角色分工协作。
风险控制：保持 "未观测不等于不存在"（not_observed != absent）的认知，缺失本地证明意味着 "此处未验证"，而非 "不可能" 或 "已支持"。
局限与边界
需要清醒认识的是，claude-code-harness 并非完全自主的 "设定后遗忘" 方案。用户必须参与计划审批环节，在 AI 生成的契约上做出批准或修正决策。对于高度复杂的项目，Breezing 模式虽然提供团队协作能力，但仍受计划质量和评审把关的约束。框架的文档明确声明：候选路径（如 Cursor 集成）仅提供研究级别的支持，不继承其他项目的支持声明。
结语
claude-code-harness 代表了 AI 辅助开发向工程化迈进的重要尝试。通过 Plan→Work→Review→Ship 的结构化循环，它将 Claude Code 的强大能力封装在可预测、可审计的流程中。对于希望将 AI 编程助手投入生产环境的团队而言，这种契约驱动、阶段把关的工作流模式，提供了从实验性使用到规模化部署的桥梁。
资料来源
- GitHub - Chachamaru127/claude-code-harness: Claude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle
- Reddit r/ClaudeAI: Built a workflow harness specifically for Claude Code after 5 months of daily production use
- Anthropic: Enabling Claude Code to work more autonomously
内容声明：本文无广告投放、无付费植入。
如有事实性问题，欢迎发送勘误至 i@hotdrydog.com。