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-harness

Claude 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:WIP`	AI 正在实现中	WIP 列表
`cc:done`/`cc:完了`	已完成，等待人工确认	完成列表（附 commit hash）
`pm: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（见下节）	有没有异常信号？

数据缺失时看板会优雅降级：没有耗时数据就显示 0，Plans.md 里一个任务都没有就提示"タスクなし"，不会报错。

自动刷新：60 秒级实时看板

这是"自动追踪"的关键——你不需要手动点刷新。

Harness 注册了一个 PostToolUse 钩子 scripts/hook-handlers/posttool-progress-regen.sh：AI 每次编辑文件或执行命令后，钩子都会在后台静默重新生成看板 HTML，且内置 60 秒限流，不阻塞 AI 的主流程。也就是说，只要 AI 在干活，你浏览器里的那张看板就在持续更新。

5 种 Drift 告警：提前发现"跑偏"

看板不只是数字，还能亮"黄灯"。scripts/progress-detect-drift.sh 会检测 5 类漂移信号并标注严重级别：

告警类型	触发条件	级别
scope-creep	修改了计划外的文件	warn
time-overrun	实际耗时超过预估 1.5 倍（2 倍为 critical）	warn / critical
repeated-failure	测试连续失败 ≥ 3 次	critical
cost-warning	花费达到预算上限的 80%	warn / critical
high-risk-file	触碰了`harness.toml`中禁止修改的路径	critical

有了这些告警，普通用户也能在 AI"悄悄跑偏"时第一时间介入。

常见问题

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 秒扫一眼全局。📊

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考