| name | requirement-debt-tracker |
| description | 跟踪 state.json pending_debts 的全生命周期——创建、超期提醒、清理、归档。 |
| allowed-tools | Read, Write, Edit, Glob, Bash |
Skill: requirement-debt-tracker
原文 §8.3 需求生命周期类。fast_track / NEEDS_REWORK / 临时绕过的债务,都由本 Skill 跟踪。
数据契约
state.json pending_debts 数组每条:
{
"id": "DEBT-001",
"desc": "补 C2.2.7 风险章节",
"source": "fast-track-20260528",
"due_at": "2026-06-04T00:00:00Z",
"status": "open|in_progress|resolved",
"owner": "koka",
"created_at": "..."
}
工作流
| 操作 | 触发 |
|---|
| create | 任一门禁 PASSED+fast_track / NEEDS_REWORK 时调度自动加 |
| list | /req-task:debt-list |
| resolve | 用户显式声明清掉某条 → 移到 state.json.resolved_debts |
| 超期检测 | CI 每天扫一遍,over due 的项让 lint 报红 |
输出格式(list 模式)
DEBT-001 open 补 C2.2.7 风险章节 due=2026-06-04 (剩 6d)
DEBT-002 in_progress 补 dead-letter 单测 due=2026-06-01 (剩 3d) ⚠️
DEBT-003 open 审计 SQL 注入修复证据 due=2026-05-30 (超期!) ❌
阻塞规则
- 存在 超期 open 债务 → 阻塞
/requirement:next
- 存在 fast_track 7 天未清 债务 → CI lint 强制 FAIL
反模式
- ❌ 偷偷把超期债务 due_at 改晚(必须用户显式 reschedule 并记录理由)
- ❌ 把 debt 标 resolved 但没有任何 commit / 文档证据