Claude Code Harness 快速开始：第一次运行 /harness-setup 到 /harness-plan 完整教程
【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harness
Claude Code Harness 是一个专为 Claude Code 打造的自主开发框架（Development Harness），通过"计划 → 执行 → 审查"的闭环，让 AI 编程稳定产出高质量代码。本文将带你从零开始，完成第一次/harness-setup初始化与/harness-plan计划生成，10 分钟内跑通完整工作流。
它解决什么问题？
用过 AI 编程工具的人都有过这样的体验：需求写在聊天记录里转眼就忘、测试在赶工期时被"省略"、代码合入后才发现没做审查。
Claude Code Harness 把流程固定为一条可重复的交付路径：
写规格 → 只实现已批准的切片 → 验证 → 独立审查 → 打包证据
它的核心理念是：不依赖模型变得更聪明，而是把流程和边界固定下来，模型升级后流程依然可靠。每个阶段都会留下下一阶段需要的产物：
| 阶段 | 命令 | 产出 |
|---|---|---|
| 📋 计划 | /harness-plan | spec.md+Plans.md（范围、验收标准、依赖、停止条件） |
| 🔧 执行 | /harness-work | 代码 + 测试（按任务要求自动走 TDD） |
| 🔍 审查 | /harness-review | 独立审查结论，严重问题会阻止完成 |
| 🔄 同步 | /harness-sync | 计划与实际实现的漂移报告 |
| 🚀 发布 | /harness-release | CHANGELOG、标签与发布证据包 |
此外，它内置了双层安全机制：运行时底线（不可关闭，覆盖计费、网络外发、密钥读取等 5 类高危操作）和防护栏 R01–R15（可按项目配置）。所有拦截都会记录到日志，而不是静默放行。
准备工作：安装插件（约 30 秒）
在终端启动 Claude Code 后，依次输入以下命令即可完成安装：
claude /plugin marketplace add Chachamaru127/claude-code-harness /plugin install claude-code-harness@claude-code-harness-marketplace💡 如果你使用 Codex CLI 或 Cursor，也可以先克隆仓库再执行对应的安装脚本，地址为
https://gitcode.com/GitHub_Trending/cl/claude-code-harness，脚本见scripts/setup-codex.sh与scripts/setup-cursor.sh。本文以 Claude Code 为主线。
安装完成后，项目里已经能看到 Harness 的 5 个核心"动词"技能：plan、work、review、sync、release。
第一步：运行 /harness-setup 初始化项目
在项目根目录启动claude，输入：
/harness-setup它会自动完成：
- 📄 生成
CLAUDE.md（项目规则文件）与Plans.md（任务台账） - 🪝 配置 hooks 与工具链
- 🧠 初始化记忆目录（harness-mem）
- 🩺 最后运行自检（doctor），确认环境健康
执行/harness-setup时还可以指定子命令，常用的一览：
| 子命令 | 作用 |
|---|---|
/harness-setup init | 全新项目初始化（CLAUDE.md + Plans.md + hooks） |
/harness-setup codex | 配置 Codex CLI 作为执行后端 |
/harness-setup ci | 配置 CI/CD 流水线 |
/harness-setup harness-mem | 配置记忆系统 |
/harness-setup localize | 本地化 CLAUDE.md 规则 |
✅成功的标志：会话中能看到 Harness 工作流技能，Plans.md状态可读，下一步建议是 plan / work / review 而不是"自由发挥式"编码。
第二步：运行 /harness-plan 生成你的第一份计划
初始化完成后，交给它一个具体的小任务，例如：
/harness-plan Improve the README onboarding flow/harness-plan create会执行一套完整的计划质量流程：
- 最多问 3 个问题，确认你要做什么
- 联网调研最新信息
- 从 Product / Architecture / Security / QA / Skeptic 多个视角交叉评审
- 输出
spec.md（产品契约：什么是对的）与Plans.md（任务台账：要做什么）
生成的Plans.md是一张 5 列任务表（任务 / 内容 / DoD / 依赖 / 状态），每个任务带cc:TODO等状态标记，DoD（完成定义）必须是可打勾验证的一行，禁止"写得好看一点"这类模糊描述。
⚠️你的角色不是写计划，而是在执行前批准或修正它。对于影响产品行为的计划，Harness 会输出Spec delta（规格变更）或Spec skip reason（跳过理由），并生成"事前确认"清单，把计划中可能触发的敏感操作一次性前置审批，避免执行途中反复打断你。
常用子命令：
| 输入 | 作用 |
|---|---|
/harness-plan create | 生成/更新计划（spec.md + Plans.md） |
/harness-plan add 任务名: 描述 | 追加新任务（标记为 cc:TODO） |
/harness-plan update 任务号 完成 | 更新状态标记 |
/harness-plan sync | 对照实现情况，同步 Plans.md |
计划确认后，如果你不是工程师或想快速核对，可以让它生成一份计划概要（单页 HTML，含理解、选项、风险、验收条件），不用读代码也能做决策。
下一步：从计划走向执行
create完成后，Harness 会直接告诉你新会话该怎么启动，典型导流方式：
- 只有一件事要做 → 新会话中输入
/harness-work <任务号> - 多件独立任务 → 输入
/breezing all并行推进 - 长时间任务 → 用带缓存的启动命令配合
/harness-loop all
任务执行完毕后用/harness-review独立审查，/harness-sync检查漂移，最终/harness-release打包发布。至此，你就完整走通了 Claude Code Harness 的自主交付闭环。
延伸阅读
- 📖 技能定义：
skills/harness-setup/SKILL.md、skills/harness-plan/SKILL.md - 📖 安装与多工具指南：
docs/onboarding/install.md - 📖 计划与规格单一事实源：
docs/plans/spec-ssot.md - 📖 安全策略与运行时底线：
docs/known-limitations.md、README.md中的 Safety layer 章节
总结：Claude Code Harness 的入门路径只有三步——安装插件 →/harness-setup初始化 →/harness-plan生成计划。流程的纪律性由框架保证，你只需要专注于一件事：批准或修正计划，然后让 Plan→Work→Review 循环替你守住质量底线。
【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harness
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
