claude-code-harness
为Claude Code设计的结构化开发工作流，将AI编码转化为可重复、可验证的交付循环。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：claude-code-harness。 它的用途是：为Claude Code设计的结构化开发工作流，将AI编码转化为可重复、可验证的交付循环。 完整的 Skill 内容见：https://321skill.com/skills/claude-code-harness/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“/harness-plan 为用户登录模块添加JWT令牌验证功能”，它会生成包含验收标准、技术方案和子任务的详细计划文档供你审核。审核通过后，你说“/harness-work 1.2.3”，AI便会开始实现“编写JWT生成与验证的中间件”这个具体子任务，并将代码和测试结果输出到指定文件。
介绍
Claude Code Harness旨在解决AI辅助编码时常见的计划分散、测试缺失、审查滞后和发布证据不可靠等问题。它将原本随意的聊天式编码，转变为“规划、实施、审查、发布”的严谨交付循环，通过五个核心指令（plan, work, review, sync, release）来约束和引导AI的工作路径。
使用方式非常直接：安装后，用户通过 /harness-plan 指令描述需求，AI会生成详细的规格说明和任务计划；用户审核并批准后，使用 /harness-work 执行具体任务；完成后再通过 /harness-review 进行独立验证。整个过程将计划、代码和验证证据固化在文件中，而非仅存于聊天记忆。
它特别适合需要将AI生成代码集成到正式项目中的开发者，尤其是那些对代码质量、可追溯性和团队协作有要求的场景。无论是修复Bug、开发新功能还是重构代码，Harness都能提供结构化的保障。
建议新用户从一个非常小的任务开始（如“改进README的登录流程”），以熟悉整个工作循环。重要的是理解你的角色是“合同的审核者”，而非手写计划者。批准AI生成的计划是控制项目范围和确保方向正确的关键步骤。
核心特点
与同类工具相比，其核心区别在于强制性的“验证门控”和“证据固化”。所有在README中声明的功能都必须通过CI测试验证其可达性，确保“描述即运行”，杜绝了声称支持但实际代码未接入的情况。它通过文件系统（spec.md, Plans.md）而非聊天记录来建立单一事实来源，使AI的工作成果可审计、可复用。
注意事项
不适合用于快速、探索性的代码片段编写或一次性脚本任务，其结构化流程会带来一定的启动开销。
常见问题
Harness会减慢我的开发速度吗？
对于小型、探索性任务，初期会有额外步骤。但对于需要集成、测试和协作的中大型任务，它通过减少返工和明确范围，最终能提升整体交付效率和代码质量。
我必须严格按照Plan→Work→Review的顺序吗？
是的，这是Harness的核心设计。它强制进行前期规划和后期验证，以避免AI编码常见的范围蔓延和测试缺失问题。但计划本身可以迭代更新。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/claude-code-harness/raw/index.md 读取 claude-code-harness 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/claude-code-harness/raw/index.md（查看排版版本）