SuperAPI AI 工具集

tracking-progress

通用与其它

查看项目

更新于 10-15 23:49

技能介绍

用途:扫描当前项目 .scratch 目录下的 spec、票面(ticket)和 checkpoint 清单,生成一张任务进度网页,回答“手上有哪些活、做到哪了、现在能开工的是哪张票”。

主要能力:识别 <spec>/issues/NN-slug.md、<spec>/impl/NN-slug.md、<spec>/NN-slug.md 等任务文件,读取 / 状态: 行、issues/open/ 与 issues/done/ 目录名、memory.md 的 - [x]/- [ ]/- [~] 行,以及 wayfinder map.md 及其子项的 Status: claimed/resolved 与 Blocked by: NN。状态字符串宽松匹配,resolved/done/已完成/定稿 视为完成,claimed/in-progress/进行中 视为进行中,其余为 open。页面含每个 spec 的依赖图(mermaid,随主题配色)、可复制按钮(票 id 复制为 spec#id)、指向源 map.md/spec.md 的链接,并列出未能识别的文件。

使用方式:运行 python3 skills/project/tracking-progress/scripts/tracking_progress.py,脚本会写出 .scratch/progress.html 并打印路径;可用 open .scratch/progress.html 打开。传入仓库根目录作为第一个参数可扫描其他项目。页面默认深色,右上角亮色按钮切换并记忆选择。

适用场景:需要快速了解项目任务分布、依赖关系与当前可开工项时。

限制:memory/ 与顶层 research/ 不扫描;spec 级 <spec>/research/*.md 仅列出链接、无状态。Blocked by 引用不存在的 id 显示为悬空引用,不计为阻塞;互相阻塞的票以虚线琥珀色边标出。进度口径为 done ÷ total,阻塞项计入分母,一张票等于一个票文件或一条 memory.md 清单行。页面为单文件、无网络无依赖,约 1 MB。若“未能识别的文件”非空且确实含任务,需向用户确认是否在 .scratch/tracking-progress/issues/ 提 issue 并补充规则。