用途:扫描代码库中的未完成工作,并按功能分组维护一份 TODO.md,供后续 /prd 使用。该技能只做清点与整理,不编写或实现代码。
主要能力:检测代码注释中的 TODO、FIXME、HACK、XXX、PLACEHOLDER;发现非测试文件里的 mock 数据(硬编码数组、faker、seed 等);识别空组件占位(空 div、<!-- TODO -->、stub 模板);发现引用了不存在文件的路由;发现没有对应测试文件的源码;发现空文件或少于 5 行的 stub 文件;以及在 docs、designs、assets 中查找设计稿等引用。还会读取 tasks/prd-*.md,为已有 PRD 的功能组添加备注,避免重复。
使用方式:不存在 TODO.md 时执行初始创建(步骤 1–4);已存在时执行后续更新(步骤 0–4)。更新时先解析 Last updated 日期,运行 git log --since="<timestamp>" --oneline,将提交映射到未勾选项并标记 [x] 与提交哈希,且不移除任何未勾选项。随后扫描代码缺口、检查 PRD、按功能聚类、计算进度并写入或更新项目根目录的 TODO.md。进度以 40 字符进度条展示,并维护 Weekly Snapshot 表格(首次创建添加基线行,更新时日期不同才追加新行,Delta 为自上次以来完成数)。
规则与限制:保证幂等,重复运行结果一致;只增不减,更新时不删除未完成项;不实现代码;检查 PRD 并标注;每次运行更新时间戳;每项包含 file:line 便于追溯;每条未完成项须能作为独立的 /prd 输入。具体命令与文件格式以资料为准。