Commit 1a4f67ad50ac2babf7c85d61be7c7f11dbc5dddb

Authored by zichun
1 parent 22f99af0

downstream-gen: remove docs/10 acceptance checklist (write-only, no consumer)

- docs/10 was generated once at A5 and never read back by any skill,
  workflow, or gate (the `acceptance` hits elsewhere are the per-REQ card
  field, unrelated). Removing it costs the pipeline nothing.
- delete docs-10-header-template.md; drop step E + its checkbox, banner
  entry, description mention, and reference-list entry from the skill;
  renumber old step F → E.
- drop the docs/10 checkbox from docs-08-initial-template.md.
- update README (A5 flow line, A5 table row, template-table row).
README.md
@@ -19,7 +19,7 @@ Claude Code 插件:ERP / 后端管理系统全流程开发框架。 @@ -19,7 +19,7 @@ Claude Code 插件:ERP / 后端管理系统全流程开发框架。
19 19
20 A4 db-init(docs/03 → V1 migration → 自动 apply 到本地 MySQL) 20 A4 db-init(docs/03 → V1 migration → 自动 apply 到本地 MySQL)
21 21
22 - A5 downstream-gen(docs/02 / docs/05 / docs/10 / docs/08 § 三 FE 清单;prototype/ 门禁) 22 + A5 downstream-gen(docs/02 / docs/05 / docs/08 § 三 FE 清单;prototype/ 门禁)
23 ↓ ⛔ docs/05 + docs/02 评审闸(必须确认) 23 ↓ ⛔ docs/05 + docs/02 评审闸(必须确认)
24 ⛔ Plan 终结硬闸(全部前移闸门通过才放行) 24 ⛔ Plan 终结硬闸(全部前移闸门通过才放行)
25 25
@@ -123,7 +123,7 @@ erp-workflow-plugin/ @@ -123,7 +123,7 @@ erp-workflow-plugin/
123 | A2 | `skeleton-gen` | • 生成架构文档:docs/04 § 一+<br>• 生成跨平台工具脚本:`scripts/*.mjs`(**无 chmod**;凭据 / 配置统一在 A1 产出的 config-vars.yaml)<br>• 据 `gitignore-append-template` 用 Read/Write 并入项目 .gitignore | `plan-start` | 123 | A2 | `skeleton-gen` | • 生成架构文档:docs/04 § 一+<br>• 生成跨平台工具脚本:`scripts/*.mjs`(**无 chmod**;凭据 / 配置统一在 A1 产出的 config-vars.yaml)<br>• 据 `gitignore-append-template` 用 Read/Write 并入项目 .gitignore | `plan-start` |
124 | A3 | `db-design-gen` | • A3 起始用 `AskUserQuestion` 确认 ERP 约定(主键策略 / 租户列 / 列前缀规则,默认值可覆盖),结果写 docs/04 + CLAUDE.md<br>• 从 docs/01 REQ 卡片正向设计 `docs/03-数据库设计文档.md`(schema SSoT)<br>• 回填 REQ 卡片依赖表(`TBD(A3 自动补)` → 实际表名)<br>• **停下**等人工审阅 docs/03,审阅完毕用 `/plan-start` 续进 A4 | A2 | 124 | A3 | `db-design-gen` | • A3 起始用 `AskUserQuestion` 确认 ERP 约定(主键策略 / 租户列 / 列前缀规则,默认值可覆盖),结果写 docs/04 + CLAUDE.md<br>• 从 docs/01 REQ 卡片正向设计 `docs/03-数据库设计文档.md`(schema SSoT)<br>• 回填 REQ 卡片依赖表(`TBD(A3 自动补)` → 实际表名)<br>• **停下**等人工审阅 docs/03,审阅完毕用 `/plan-start` 续进 A4 | A2 |
125 | A4 | `db-init` | • LLM 解析 docs/03 → `sql/migrations/V1__initial_schema.sql`(DDL only)<br>• `node ${CLAUDE_PLUGIN_ROOT}/lib/validate-ddl.mjs` 校验 DDL ↔ docs/03(5 维:表/列名/列类型/索引/FK),fail-closed<br>• `node ${CLAUDE_PLUGIN_ROOT}/lib/apply-ddl.mjs config-vars.yaml V1.sql`(解析 config-vars.yaml database: 段 + mysql2 apply,**无 shell-source**) | A3 | 125 | A4 | `db-init` | • LLM 解析 docs/03 → `sql/migrations/V1__initial_schema.sql`(DDL only)<br>• `node ${CLAUDE_PLUGIN_ROOT}/lib/validate-ddl.mjs` 校验 DDL ↔ docs/03(5 维:表/列名/列类型/索引/FK),fail-closed<br>• `node ${CLAUDE_PLUGIN_ROOT}/lib/apply-ddl.mjs config-vars.yaml V1.sql`(解析 config-vars.yaml database: 段 + mysql2 apply,**无 shell-source**) | A3 |
126 -| A5 | `downstream-gen` | • 一次性生成 docs/02 / docs/05 / docs/10<br>• 回填 REQ 卡片依赖接口(`TBD(A5 自动补)` → 实际 endpoint)<br>• 追加模块清单到 docs/08 § 二<br>• **docs/05 + docs/02 评审闸**:用 `AskUserQuestion` 让用户确认 API 端点/字段无误 + 构建顺序可接受,未确认不勾 A5<br>• **prototype/ 门禁 + 推导 FE 清单写 docs/08 § 三**(原 A6 已并入;无 prototype 则问「无前端」→ § 三 留空)<br>• 最终占位符 + 结构残留扫描 | A4 | 126 +| A5 | `downstream-gen` | • 一次性生成 docs/02 / docs/05<br>• 回填 REQ 卡片依赖接口(`TBD(A5 自动补)` → 实际 endpoint)<br>• 追加模块清单到 docs/08 § 二<br>• **docs/05 + docs/02 评审闸**:用 `AskUserQuestion` 让用户确认 API 端点/字段无误 + 构建顺序可接受,未确认不勾 A5<br>• **prototype/ 门禁 + 推导 FE 清单写 docs/08 § 三**(原 A6 已并入;无 prototype 则问「无前端」→ § 三 留空)<br>• 最终占位符 + 结构残留扫描 | A4 |
127 127
128 ### Coding 阶段(1 个 Workflow,非 skill) 128 ### Coding 阶段(1 个 Workflow,非 skill)
129 129
@@ -157,7 +157,6 @@ erp-workflow-plugin/ @@ -157,7 +157,6 @@ erp-workflow-plugin/
157 | downstream-gen | `docs-05-header-template.md` | docs/05 API 契约头部 | 157 | downstream-gen | `docs-05-header-template.md` | docs/05 API 契约头部 |
158 | downstream-gen | `docs-05-endpoint-template.md` | docs/05 单接口小节 | 158 | downstream-gen | `docs-05-endpoint-template.md` | docs/05 单接口小节 |
159 | downstream-gen | `docs-08-module-row-template.md` | docs/08 § 二 单模块 bullet 行 | 159 | downstream-gen | `docs-08-module-row-template.md` | docs/08 § 二 单模块 bullet 行 |
160 -| downstream-gen | `docs-10-header-template.md` | docs/10 验收清单(项目级 SOP,零槽位 + 引用指针) |  
161 160
162 ## 前置依赖 161 ## 前置依赖
163 162
skills/plan/downstream-gen/SKILL.md
1 --- 1 ---
2 name: downstream-gen 2 name: downstream-gen
3 -description: A5 下游文档生成——基于 docs/01 和 docs/03 推导,一次性生成 docs/02 + docs/05 + docs/10,回填 REQ 卡片依赖接口,把模块清单追加到 docs/08 § 二,并由 prototype/ + docs/01 + docs/05 推导 FE 清单写入 docs/08 § 三。这是 Plan 阶段最后一个 A 步骤(A6 已并入此处)。 3 +description: A5 下游文档生成——基于 docs/01 和 docs/03 推导,一次性生成 docs/02 + docs/05,回填 REQ 卡片依赖接口,把模块清单追加到 docs/08 § 二,并由 prototype/ + docs/01 + docs/05 推导 FE 清单写入 docs/08 § 三。这是 Plan 阶段最后一个 A 步骤(A6 已并入此处)。
4 user-invocable: false 4 user-invocable: false
5 allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion 5 allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion
6 --- 6 ---
@@ -55,13 +55,7 @@ allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion @@ -55,13 +55,7 @@ allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion
55 55
56 勾选:` - [ ] 下方模块列表已填入` 56 勾选:` - [ ] 下方模块列表已填入`
57 57
58 -### E. docs/10 — 验收清单(项目级 SOP)  
59 -  
60 -用 `Read` 读取 `${CLAUDE_SKILL_DIR}/templates/docs-10-header-template.md`,用 `Write` 原样写到 `docs/10-验收检查清单.md`(跨平台,不用 `cp`)。  
61 -  
62 -勾选:` - [ ] docs/10 验收清单已生成`  
63 -  
64 -### F. 验证 + 勾选 docs/08 进度 + 结束 Plan 58 +### E. 验证 + 勾选 docs/08 进度 + 结束 Plan
65 59
66 1. **合并扫描三类问题**(最多 3 轮自主修复,docs/01 是 REQ SSoT 不动)——一次性扫一致性 + `TBD(A3/A5 自动补)` + 结构性残留: 60 1. **合并扫描三类问题**(最多 3 轮自主修复,docs/01 是 REQ SSoT 不动)——一次性扫一致性 + `TBD(A3/A5 自动补)` + 结构性残留:
67 61
@@ -79,7 +73,7 @@ allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion @@ -79,7 +73,7 @@ allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion
79 73
80 ``` 74 ```
81 [downstream-gen] ✅ A5 下游文档生成完成(Plan A0~A5 全部完成) 75 [downstream-gen] ✅ A5 下游文档生成完成(Plan A0~A5 全部完成)
82 - 产出:docs/02 / docs/05 / docs/10 / docs/08 § 二 模块清单 / docs/08 § 三 FE 清单;docs/08 § 一 A0~A5 已全勾。 76 + 产出:docs/02 / docs/05 / docs/08 § 二 模块清单 / docs/08 § 三 FE 清单;docs/08 § 一 A0~A5 已全勾。
83 ⏭️ 下一步:运行 /erp-workflow:plan-start 进入终结闸 77 ⏭️ 下一步:运行 /erp-workflow:plan-start 进入终结闸
84 ``` 78 ```
85 79
@@ -90,4 +84,3 @@ allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion @@ -90,4 +84,3 @@ allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion
90 - `${CLAUDE_SKILL_DIR}/templates/docs-05-endpoint-template.md` 84 - `${CLAUDE_SKILL_DIR}/templates/docs-05-endpoint-template.md`
91 - `prototype/**/*.html`(前端页面/布局/交互权威;C 段据此推导 FE 清单) 85 - `prototype/**/*.html`(前端页面/布局/交互权威;C 段据此推导 FE 清单)
92 - `${CLAUDE_SKILL_DIR}/templates/docs-08-module-row-template.md`(模块 bullet 行模板) 86 - `${CLAUDE_SKILL_DIR}/templates/docs-08-module-row-template.md`(模块 bullet 行模板)
93 -- `${CLAUDE_SKILL_DIR}/templates/docs-10-header-template.md`  
skills/plan/downstream-gen/templates/docs-10-header-template.md deleted
1 -# 10-验收检查清单  
2 -  
3 -通用验收项(全项目适用):  
4 -  
5 -- [ ] `node scripts/test.mjs` 本地全绿  
6 -- [ ] 所有 schema 改动都有对应 `sql/migrations/V_n__<desc>.sql`  
7 -- [ ] 所有新接口在 `docs/05` 中有契约定义  
8 -- [ ] 所有新功能代码注释含 REQ-XXX-NNN  
9 -- [ ] 统一响应格式 `{code, message, data, timestamp}`  
10 -- [ ] 异常走全局处理器,不暴露堆栈到前端  
11 -- [ ] 前端不存敏感信息到 localStorage  
skills/plan/project-init/templates/docs-08-initial-template.md
@@ -34,7 +34,6 @@ @@ -34,7 +34,6 @@
34 - [ ] A5 下游文档生成 — downstream-gen 34 - [ ] A5 下游文档生成 — downstream-gen
35 - [ ] docs/02 开发计划已生成 35 - [ ] docs/02 开发计划已生成
36 - [ ] docs/05 API 契约已生成 36 - [ ] docs/05 API 契约已生成
37 - - [ ] docs/10 验收清单已生成  
38 - [ ] 下方模块列表已填入 37 - [ ] 下方模块列表已填入
39 - [ ] REQ 卡片依赖接口已回填 38 - [ ] REQ 卡片依赖接口已回填
40 - [ ] FE 清单已推导填入 docs/08 § 三 39 - [ ] FE 清单已推导填入 docs/08 § 三