Skip to content

Commit f2f3b75

Browse files
committed
docs(template): 归档模板(当日索引 + 技术债滚动清单)
1 parent a825c65 commit f2f3b75

1 file changed

Lines changed: 49 additions & 0 deletions

File tree

‎docs/templates/archive-template.md‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# 归档模板
2+
3+
> 每日归档时按此模板创建 `<归档日>/README.md` 与 `<归档日>/tech-debt.md`。机制详见 [归档机制说明](../archive/README.md)。
4+
5+
## 当日索引 README.md
6+
7+
```markdown
8+
# YYYY-MM-DD 归档索引
9+
10+
> 归档说明(基线归档 = 机制启动日跳过昨日债务整理;常规归档 = 按 SOP 6 步执行)
11+
12+
## 归档内容
13+
- 实施文档:[文件名](功能一句话)
14+
- 已实施计划:[文件名]
15+
- 机制文档:[spec/plan 文件名]
16+
17+
## 技术债摘要
18+
- 未偿 N 笔(TD-XXX 摘要);详见本目录 tech-debt.md
19+
20+
## 备注
21+
- 本日归档完成后即最新归档,下个归档日需先整理本日清单
22+
```
23+
24+
## 技术债清单 tech-debt.md
25+
26+
```markdown
27+
# 技术债清单(权威:YYYY-MM-DD)
28+
29+
> 本清单为当前唯一权威债务清单,归档日滚动更新;旧归档清单仅历史追溯。
30+
31+
## 未偿债务
32+
33+
| ID | 摘要 | 类型 | 优先级 | 来源归档 | 状态 |
34+
|----|------|------|--------|----------|------|
35+
| TD-XXX | 一行摘要 | 有意/无意/环境变化/腐化 | P0/P1/P2/P3 | YYYY-MM-DD | open / carried |
36+
37+
## 今日已偿
38+
39+
| ID | 摘要 | 偿还提交 |
40+
|----|------|----------|
41+
| TD-XXX | 一行摘要 | <提交哈希> |
42+
```
43+
44+
## 字段说明
45+
46+
- `来源归档`:债务首次登记的归档日期;carried 条目保留原值
47+
- `状态`:open(今日新增)/ carried(继承昨日未偿,仅保留 ID+摘要行)/ closed(今日已偿,后续归档不再出现)
48+
- `carried 行`:仅保留 ID + 一行摘要,类型/优先级/来源归档照抄首次登记值
49+
- 无新增债务的归档日仍须继承昨日清单(最新归档必有权威清单)

0 commit comments

Comments
 (0)