Claude Code Harness Progress Tracker 实战:自动追踪 AI 开发进度的 WIP/TODO 看板

Claude Code Harness Progress Tracker 实战:自动追踪 AI 开发进度的 WIP/TODO 看板 Claude Code Harness Progress Tracker 实战自动追踪 AI 开发进度的 WIP/TODO 看板【免费下载链接】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 的Progress Tracker进度追踪看板是一款面向 AI 辅助开发的自动进度看板它以 Plans.md 为唯一事实来源自动统计cc:WIP/cc:TODO/cc:done任务数、完成率、耗时与成本把 AI 会话的实时进展渲染成一张可浏览器查看的 HTML 快照。对于不熟悉代码细节的用户来说它是理解AI 现在干到哪了、还差多少、花了多少钱的 3 秒速览工具。为什么 AI 开发需要一块进度看板让 Claude Code 长时间自主跑任务时最常见的问题不是做不出来而是看不清楚哪些任务还没开始TODO哪些正在做WIP整体完成了百分之几预计还要多久已经消耗了多少 token 成本会不会超预算AI 有没有跑偏——改了计划外的文件、反复测试失败Progress Tracker 把 Plans.md 里的任务表当作看板数据源一次性回答以上所有问题。核心机制用 WIP/TODO 标记驱动看板Harness 在 Plans.md 中约定了一套标准状态标记AI 每完成一步就更新任务状态看板随之变化标记含义看板上的位置cc:todo/cc:TODO未着手任务TODO 列表cc:wip/cc:WIPAI 正在实现中WIP 列表cc:done/cc:完了已完成等待人工确认完成列表附 commit hashpm:requested/pm:approved人工侧的起票 / 验收不计入 AI 统计状态正常流转路径为pm:requested → cc:todo → cc:wip → cc:done → pm:approved规则详解见 Plans.md 的マーカー凡例小节标记计数逻辑由 scripts/plans-marker-count.sh 实现。一键启动/harness-progress无需写任何脚本在 Claude Code 中直接输入命令即可/harness-progress—— 生成并打开当前项目的进度看板/harness-progress --no-open—— 只生成不打开浏览器/harness-progress --out path—— 指定输出路径默认out/progress-snapshot.html底层由两个脚本协作完成定义见 skills/harness-progress/SKILL.md快照scripts/progress-snapshot.sh 解析 Plans.md输出符合 progress-snapshot.v1 模式 的 JSON完成率、任务清单、耗时、成本渲染scripts/render-html.sh 基于 templates/html/progress.html.template 渲染出单文件 HTML手机/桌面自适应可离线打开。看板一眼看到什么区块内容回答的问题进度条progress_pct完成数 ÷ 总任务数 × 100整体完成了多少任务三栏TODO / WIP / done 清单done 附 commit 短 hash具体卡在哪个任务时间已耗时 / 预估总耗时分钟还要等多久成本已花费 / 预估总额USD钱包还安全吗告警区drift alert见下节有没有异常信号数据缺失时看板会优雅降级没有耗时数据就显示 0Plans.md 里一个任务都没有就提示タスクなし不会报错。自动刷新60 秒级实时看板这是自动追踪的关键——你不需要手动点刷新。Harness 注册了一个 PostToolUse 钩子 scripts/hook-handlers/posttool-progress-regen.shAI 每次编辑文件或执行命令后钩子都会在后台静默重新生成看板 HTML且内置 60 秒限流不阻塞 AI 的主流程。也就是说只要 AI 在干活你浏览器里的那张看板就在持续更新。5 种 Drift 告警提前发现跑偏看板不只是数字还能亮黄灯。scripts/progress-detect-drift.sh 会检测 5 类漂移信号并标注严重级别告警类型触发条件级别scope-creep修改了计划外的文件warntime-overrun实际耗时超过预估 1.5 倍2 倍为 criticalwarn / criticalrepeated-failure测试连续失败 ≥ 3 次criticalcost-warning花费达到预算上限的 80%warn / criticalhigh-risk-file触碰了harness.toml中禁止修改的路径critical有了这些告警普通用户也能在 AI悄悄跑偏时第一时间介入。相关资源清单技能定义skills/harness-progress/SKILL.md快照脚本scripts/progress-snapshot.sh漂移检测scripts/progress-detect-drift.shHTML 模板templates/html/progress.html.template自动再生成钩子scripts/hook-handlers/posttool-progress-regen.sh数据源Plans.md常见问题Q不开 Claude Code 能看进度吗可以。生成的out/progress-snapshot.html是单文件静态页随时可直接用浏览器打开也可发给同事。Q它和 harness-plan-brief、harness-accept 是什么关系三者组成认知减负三件套Plan Brief 是开工前的说明会Accept 是收尾时的验收单Progress Tracker 是进行中的仪表盘对照关系见 skills/harness-progress/SKILL.md 的 Related 一节。Q看板数据多久更新一次AI 每次工具调用触发后台刷新60 秒限流手动执行/harness-progress则立即更新。上手只需记住一件事把任务写进 Plans.md 并打好标记剩下的交给看板——AI 负责干活和刷新你只负责 3 秒扫一眼全局。【免费下载链接】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),仅供参考