Skip to content

Commit 81425e3

Browse files
committed
docs(standard): tech-debt.md 新增滚动归档章节
1 parent 655b209 commit 81425e3

1 file changed

Lines changed: 17 additions & 2 deletions

File tree

‎docs/standards/tech-debt.md‎

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,21 @@
7575
3. **重构偿还**:结合新功能开发一起重构
7676
4. **替换偿还**:用更好的方案替换旧实现
7777

78-
### 第五部分:预防措施
78+
### 第五部分:滚动归档(日收工)
79+
80+
**记录位置**:`docs/archive/<最新归档日>/tech-debt.md` —— 每日滚动的唯一权威清单,随文档归档建立。
81+
82+
**字段扩展**:在第二部分记录格式基础上增加两个字段——`来源归档`(债务首次登记的归档日期)、`状态`(open 今日新增 / carried 继承昨日未偿 / closed 今日已偿)。
83+
84+
**滚动规则**:
85+
- 归档日先读昨日清单:已偿(提交/代码验证)→ `closed` 并注偿还提交,后续归档不再出现;未偿 → `carried`,仅保留 ID + 一行摘要,全文以首次登记日归档为准
86+
- 当日新识别(TODO/FIXME/HACK、妥协方案)→ `open`
87+
- 归档日无新增债务也须继承昨日清单,保证"最新归档必有权威清单"
88+
- 旧归档中的债务条目仅历史追溯,不作为工作依据
89+
90+
**与偿还计划的衔接**:滚动清单是债务的唯一来源,偿还仍按第三部分影响面×成本排期、每迭代预留 20% 时间。
91+
92+
### 第六部分:预防措施
7993

8094
- 代码审查时关注"新增债务"
8195
- 临时方案必须写 TODO + 创建债务记录
@@ -99,7 +113,8 @@
99113

100114
| 输出物 | 格式 | 存放位置 |
101115
|--------|------|---------|
102-
| 技术债务清单 | Markdown/Issue | docs/tech-debt.md 或 GitHub Issues |
116+
| 技术债务清单(滚动权威) | Markdown | docs/archive/<最新归档日>/tech-debt.md |
117+
| 债务登记入口 | Markdown/Issue | docs/tech-debt.md 或 GitHub Issues |
103118
| 偿还计划 | 迭代 backlog | 项目管理工具 |
104119
| 债务盘点报告 | 文档 | docs/tech-debt/review-YYYY-MM.md |
105120

0 commit comments

Comments
 (0)