baton-debt(技术债扫描,只读)
标记格式(代码内写入时的强制格式)
BATON-DEBT: task=<id>; ceiling=<上限>; revisit_when=<可测触发器>; upgrade=<升级路径>
task:关联任务 ID(无则none)。ceiling:已知上限(如「目录 ≤ 500 文件」「单文件 ≤ 3MB」)。revisit_when:可测触发器(如「E2E 用例超过 60」「文件超过 3MB」);禁止「以后有空」「未来可能」。upgrade:升级路径(改什么、为什么现在不做)。
扫描与输出
- 搜索代码库全部
BATON-DEBT:标记。 - 每条提取 task/ceiling/revisit_when/upgrade/位置,输出:
文件:行号 | task | ceiling | revisit_when | upgrade | 状态(no-trigger=缺可测触发器)
- 无触发器的标记标
no-trigger并要求补正。 git blame只作线索,不自动认定责任人。
持久化(需要落库时)
- 进入 Baton 现有
tasks/task_todo.md(新增债务条目)或追加到knowledge/pit_experience.md并同步索引; - 自动维护
state/archive_index.json索引——不另建第二套项目真相。
边界
- 只读扫描;修改代码必须先过任务 Contract 与用户确认。
- 债务标记是显式声明,不是放纵理由:标记的 ceiling 到达 revisit_when 时按 upgrade 路径执行。