Skip to content

Commit 18199ea

Browse files
committed
refactor(planning-docs): 收敛模板头部重复元数据
1 parent 454449f commit 18199ea

12 files changed

Lines changed: 158 additions & 32 deletions

plugins/aisee-plugin/skills/aisee-architecture/assets/architecture-template-core.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,11 +19,8 @@ change_refs: []
1919

2020
**文档编号**:ARCH-{YYYY-MM-DD}-{slug}
2121
**版本**:v1.0
22-
**状态**:草稿
23-
**创建日期**:{date}
2422
**来源输入**:{SRS / UI 内容规格 / 设计规范 / 项目目录 / 用户输入}
2523
**技术域**:{app / web / mini-program / desktop / backend-service / cli-tool / job-async / integration / data / hybrid-software}
26-
**ID Scope**:{scope}
2724

2825
> 正式写法只使用文档内编号,例如 `ARCH-001``DEC-001``CONSTRAINT-001``RISK-001`。跨文档来源后续由 `change-context.md``source-map.md` 记录;无法确定最终编号时使用 `TYPE-NEW-001` 临时占位符,并标注 `[NUMBERING-FINALIZATION-REQUIRED]`
2926

plugins/aisee-plugin/skills/aisee-design-spec/assets/design-spec-template-light.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,22 @@
33
用于功能级、局部模块或只需要约束下游设计/实现的小范围设计规范。
44

55
```markdown
6+
---
7+
title: "Design Spec:{功能 / 模块名}"
8+
doc_type: "design-spec"
9+
status: "draft"
10+
date: "{date}"
11+
scope: "{project / module / feature}"
12+
owner: "{作者或团队}"
13+
source_refs:
14+
- "{SRS / UI Content / Architecture / Design Assets}"
15+
change_refs: []
16+
---
17+
618
# Design Spec:{功能 / 模块名}
719

820
**文档编号**:DS-{YYYY-MM-DD}-{slug}
921
**版本**:v1.0
10-
**状态**:草稿
11-
**创建日期**:{date}
1222
**来源输入**:{SRS / UI Content / Architecture / Design Assets / 用户输入}
1323
**设计策略**:adopt / extend / rewrite
1424

plugins/aisee-plugin/skills/aisee-design-spec/assets/design-spec-template-standard.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,6 @@ change_refs: []
1919

2020
**文档编号**:DS-{YYYY-MM-DD}-{slug}
2121
**版本**:v1.0
22-
**状态**:草稿
23-
**创建日期**:{date}
2422
**来源输入**:{SRS / UI Content / Architecture / Design Assets / 用户输入}
2523
**设计策略**:adopt / extend / rewrite
2624

plugins/aisee-plugin/skills/aisee-srs/assets/srs-template-epic-main.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,22 @@
33
仅在 Epic 模式下使用本模板。主文档不展开 Section 3 的 FR 详情,只作为全局概览和索引。
44

55
```markdown
6+
---
7+
title: "需求规格说明书:{系统/功能名称}"
8+
doc_type: "srs"
9+
status: "draft"
10+
date: "{date}"
11+
scope: "{scope}"
12+
owner: "{从 AGENTS.md 或项目上下文提取,或填\"待填写\"}"
13+
source_refs:
14+
- "{repo-relative source path or source ref}"
15+
change_refs: []
16+
---
17+
618
# 需求规格说明书(主文档)
719

820
**文档编号**:SRS-{YYYY-MM-DD}-{slug}-main
921
**版本**:v1.0
10-
**状态**:草稿
11-
**创建日期**:{date}
12-
**作者**:{从 AGENTS.md 或项目上下文提取,或填"待填写"}
13-
**ID Scope**:{scope}
1422

1523
> 正式写法只使用文档内编号,例如 `FR-001``RULE-001`。跨文档引用交给 `doc-ref#编号`;无法确定最终编号时使用 `TYPE-NEW-001` 临时占位符,并标注 `[NUMBERING-FINALIZATION-REQUIRED]`
1624

plugins/aisee-plugin/skills/aisee-srs/assets/srs-template-epic-module.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,23 @@
33
Epic 模式下,每份模块文档使用本模板。
44

55
```markdown
6+
---
7+
title: "需求规格说明书:{系统/功能名称} / {模块名称}"
8+
doc_type: "srs"
9+
status: "draft"
10+
date: "{date}"
11+
scope: "{scope}"
12+
owner: "{从 AGENTS.md 或项目上下文提取,或填\"待填写\"}"
13+
source_refs:
14+
- "{repo-relative source path or source ref}"
15+
change_refs: []
16+
---
17+
618
# {模块名称} — 需求详情文档
719

820
**所属主文档**[`./00-main.md`](./00-main.md)
921
**文档编号**:SRS-{YYYY-MM-DD}-{slug}-{module-slug}
1022
**版本**:v1.0
11-
**状态**:草稿
12-
**创建日期**:{date}
13-
**ID Scope**:{scope}
1423
**FR 范围**:{scope}:FR-{XXX} ~ {scope}:FR-{YYY}
1524

1625
---

plugins/aisee-plugin/skills/aisee-srs/assets/srs-template-standard.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,10 +19,6 @@ change_refs: []
1919

2020
**文档编号**:SRS-{YYYY-MM-DD}-{slug}
2121
**版本**:v1.0
22-
**状态**:草稿
23-
**创建日期**:{date}
24-
**作者**:{从 AGENTS.md 或项目上下文提取,或填"待填写"}
25-
**ID Scope**:{scope}
2622

2723
> 正式写法只使用文档内编号,例如 `FR-001``RULE-001`。跨文档引用交给 `doc-ref#编号`;无法确定最终编号时使用 `TYPE-NEW-001` 临时占位符,并标注 `[NUMBERING-FINALIZATION-REQUIRED]`
2824

plugins/aisee-plugin/skills/aisee-ui-content/assets/ui-content-template-enhancement.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,24 @@
33
用于 `enhancement + standard` 场景:基于现有系统二次开发,只描述新增、变更、下线和未知部分。
44

55
```markdown
6+
---
7+
title: "UI 内容规格:{功能名}"
8+
doc_type: "ui-content"
9+
status: "draft"
10+
date: "{date}"
11+
scope: "{scope}"
12+
owner: "{作者或团队}"
13+
source_refs:
14+
- "{SRS path or source ref}"
15+
change_refs: []
16+
---
17+
618
# UI 内容增量规格:{功能名}
719

820
**文档编号**:UIC-{YYYY-MM-DD}-{slug}
921
**版本**:v1.0
10-
**状态**:草稿
11-
**创建日期**:{date}
1222
**来源 SRS / 需求**:{path or description}
1323
**场景模式**:enhancement
14-
**ID Scope**:{scope}
1524

1625
> 正式写法只使用文档内编号,例如 `PAGE-001``FLOW-001``STATE-001`。跨文档来源后续由 `source-map.md` 记录;无法确定最终编号时使用 `TYPE-NEW-001` 临时占位符,并标注 `[NUMBERING-FINALIZATION-REQUIRED]`
1726

plugins/aisee-plugin/skills/aisee-ui-content/assets/ui-content-template-epic-index.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,24 @@
33
用于 Epic 模式的 `00-index.md`。索引只写总览、文档导航、页面总览、流程总览和追踪总表,不展开完整页面详情。
44

55
```markdown
6+
---
7+
title: "UI 内容规格:{功能名}"
8+
doc_type: "ui-content"
9+
status: "draft"
10+
date: "{date}"
11+
scope: "{scope}"
12+
owner: "{作者或团队}"
13+
source_refs:
14+
- "{SRS path or source ref}"
15+
change_refs: []
16+
---
17+
618
# UI 内容规格索引:{功能名}
719

820
**文档编号**:UIC-{YYYY-MM-DD}-{slug}-index
921
**版本**:v1.0
10-
**状态**:草稿
11-
**创建日期**:{date}
1222
**来源 SRS / 需求**:{path or description}
1323
**场景模式**:{new-build / enhancement / inventory}
14-
**ID Scope**:{scope}
1524

1625
> 正式写法只使用文档内编号,例如 `PAGE-001``FLOW-001``STATE-001`。跨文档来源后续由 `source-map.md` 记录;无法确定最终编号时使用 `TYPE-NEW-001` 临时占位符,并标注 `[NUMBERING-FINALIZATION-REQUIRED]`
1726

plugins/aisee-plugin/skills/aisee-ui-content/assets/ui-content-template-epic-module.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,26 @@
33
用于 Epic 模式的模块文档,例如 `01-<module>.md`。模块文档必须可独立阅读,并保留页面详情中的局部流程语境。
44

55
```markdown
6+
---
7+
title: "UI 内容规格:{功能名} / {模块名称}"
8+
doc_type: "ui-content"
9+
status: "draft"
10+
date: "{date}"
11+
scope: "{scope}"
12+
owner: "{作者或团队}"
13+
source_refs:
14+
- "{SRS path or source ref}"
15+
change_refs: []
16+
---
17+
618
# {模块名称} — UI 内容规格
719

820
**所属索引**[`./00-index.md`](./00-index.md)
921
**文档编号**:UIC-{YYYY-MM-DD}-{slug}-{module-slug}
1022
**版本**:v1.0
11-
**状态**:草稿
12-
**创建日期**:{date}
1323
**覆盖 FR**:{FR-xxx ~ FR-yyy}
1424
**页面范围**:{PAGE-xxx ~ PAGE-yyy}
1525
**场景模式**:{new-build / enhancement / inventory}
16-
**ID Scope**:{scope}
1726

1827
---
1928

plugins/aisee-plugin/skills/aisee-ui-content/assets/ui-content-template-inventory.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,22 @@
33
用于 `inventory + standard` 场景:老项目迁移或现有系统盘点,只整理已确认 UI 事实,不设计新需求。
44

55
```markdown
6+
---
7+
title: "UI 内容规格:{系统 / 模块名}"
8+
doc_type: "ui-content"
9+
status: "draft"
10+
date: "{date}"
11+
scope: "{scope}"
12+
owner: "{作者或团队}"
13+
source_refs:
14+
- "{path or description}"
15+
change_refs: []
16+
---
17+
618
# 现有 UI 盘点:{系统 / 模块名}
719

820
**文档编号**:UIC-{YYYY-MM-DD}-{slug}
921
**版本**:v1.0
10-
**状态**:草稿
11-
**创建日期**:{date}
1222
**来源材料**:{path or description}
1323
**场景模式**:inventory
1424

0 commit comments

Comments
 (0)