Claude Code Harness Plans.md 任务账本深度解析AI 自主执行的任务清单设计【免费下载链接】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-harnessClaude Code Harness是一个面向 Claude Code 的专用开发脚手架Development Harness它的核心是一个由 AI 自主驱动的 Plan → Work → Review 循环。而贯穿这个循环的关键就是根目录下的 Plans.md——一份被称为「任务账本」task ledger的清单文件。本文带你完整解析这份任务账本是怎么设计的AI 如何把需求拆成任务、如何标记状态、如何依赖排序、如何归档最终实现AI 自主执行、人类只做最终判断的开发方式。为什么 AI 自主开发需要一本任务账本让 AI 自己写代码并不难难的是让它长时间可靠地工作任务做到哪了哪些依赖还没完成哪些是人工批准过的Claude Code Harness 的答案是把所有状态沉淀到一个纯文本文件里而不是散落在对话中。在 Harness 中两个文件分工明确见 spec.md文件角色内容spec.md产品契约product contract范围、验收标准、未知项、停止条件Plans.md任务账本task ledger计划中的工作、任务状态、实施顺序、验证证据/harness-plan命令会把你的一句话意图转写成这两个文件你的工作不是写计划而是批准或修正它。之后/harness-work依据账本实施、/harness-review独立评审、/harness-sync检查计划与实际代码的偏差drift。每一阶段都留下下一阶段所需的材料这就是自主循环能持续运转的基础。状态标记体系AI 与人类共用的五态状态机Plans.md 最有特色的设计是状态标记status markers。每个任务行尾都会带上一个反引号包裹的标记它既是给人看的注释也是给机器解析的协议值。标准流转路径是一条清晰的五态状态机pm:requested → cc:todo → cc:wip → cc:done → pm:approved标记含义谁负责打标记pm:requested产品经理人类提出任务并发起请求PMcc:todo尚未开工实施方cc:wipClaude Code 正在执行实施方cc:done实施完成等待人类确认实施方pm:approved人类最终确认完成PM完整的标记规范见 Plans.md 标记图例还有两个重要的补充状态cc:withdrawn实施方主动撤销的任务被取代或合并进别的任务属于终态不会重开blocked阻塞任务必须附带阻塞原因方便人类一眼定位需要介入的地方。这套设计的巧妙之处在于兼容别名cc:TODO、pm:确认済、cursor:依頼中等旧写法都被视为同义保证历史账本和不同宿主工具Claude / Codex / Cursor的记录都能被统一解析而不是互相打架。任务如何书写从简单清单到依赖与并行Harness 提供了一个开箱即用的模板 templates/Plans.md.template新项目初始化后Plans.md 会包含四个固定分区In Progress进行中cc:wipNot Started未开始cc:todoCompleted已完成cc:done/pm:approvedArchive归档区最简单的写法就是普通 Markdown 勾选清单例如- [ ] 搭建项目基础目录与依赖 cc:todo进阶语法任务 ID、依赖声明与并行标记当任务多了起来模板支持一套可选的扩展语法让 AI 可以自主做任务排序和并行调度语法含义示例T001:可选任务 ID供引用和依赖- [ ] T001: 用户认证 cc:tododepends:ID声明前置依赖任务depends:T001,T003[P]标记该任务可与其他就绪任务并行执行T003: 商品 API [P]依赖关系让 AI 知道先做什么、后做什么并行标记则允许它把无依赖的任务分给多个 worker 同时处理——这是 Harness 能跑完整份计划/harness-work all而不乱序的关键。真实账本长什么样Phase 化的任务表看仓库自己的 Plans.md 就能体会到生产级账本的形态每个 Phase 是一个独立的 H2 小节包含 Purpose为什么做、设计原则以及一张Task | 内容 | DoD | Depends | Status五列任务表。其中DoDDefinition of Done完成定义一列尤其重要——它要求把算完成写成机器可验证的判据测试通过、退出码、可实测的 RED→GREEN 记录而不是实现某某功能这种模糊描述。状态列则直接回填执行证据例如cc:done [commit hash; 实测记录摘要]做到每一项完成都有据可查。账本不会无限膨胀Phase 归档机制一个长期运转的 AI 项目任务会越积越多。Harness 的解法是定期归档当一个 Phase 的全部任务都变成cc:done后该 Phase 会被整体切出到归档目录如.claude/memory/archive/Plans-*.mdPlans.md 中只留下一条指向归档文件的索引记录。仓库根目录的 Plans.md 就展示了这种最近几期 历史索引的结构活跃的 Phase 134–138 保留完整任务表而 Phase 119–133 早已退避为归档链接。这样账本始终只保留 AI 当前需要操作的上下文历史又随时可追溯。谁来守护账本技能与脚本的自动化配套Plans.md 不是写完就完的静态文档而是一整套工具链的共享数据源。仓库中有大量脚本围绕它工作脚本职责scripts/plans-marker-count.sh统计各状态标记的任务行数量化还剩多少没做scripts/plans-watcher.sh监听 Plans.md 变化触发后续动作scripts/plans-format-check.sh校验账本格式是否合规scripts/plans-format-migrate.sh迁移旧格式账本配套的三个技能各司其职harness-plan负责把需求写入账本harness-work负责从账本领取任务实施实施契约见 agents/worker.mdharness-sync负责核对账本、git 状态与实际实现是否对齐。更严格的是worker 被禁止直接改写Plans.md的状态标记会被安全规则拦截状态只能按协议流转防止 AI自报成绩。快速上手三步拥有你的任务账本安装 Harness在 Claude Code 中通过插件市场安装 claude-code-harness然后执行一次/harness-setup生成账本输入/harness-plan 你的需求描述AI 会生成spec.mdPlans.md供你审批自主执行批准后运行/harness-work allAI 会依据账本的依赖与并行标记自主跑完整个计划最后用/harness-review独立验收。更多命令说明可查阅 README.md 与 docs/plans/named-plans.md。小结任务账本是 AI 自主性的外部记忆Claude Code Harness 的 Plans.md 本质上是为 AI 设计的一本外置工作记忆状态标记让多方人类 PM、多个 AI worker、CI 脚本对进度达成共识依赖与并行标记让 AI 能自主编排执行顺序DoD 让完成变得可验证归档机制让账本长期保持精简。理解了这个设计你就理解了自主式 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），仅供参考