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 19
20 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 23 ↓ ⛔ docs/05 + docs/02 评审闸(必须确认)
24 24 ⛔ Plan 终结硬闸(全部前移闸门通过才放行)
25 25
... ... @@ -123,7 +123,7 @@ erp-workflow-plugin/
123 123 | A2 | `skeleton-gen` | • 生成架构文档:docs/04 § 一+<br>• 生成跨平台工具脚本:`scripts/*.mjs`(**无 chmod**;凭据 / 配置统一在 A1 产出的 config-vars.yaml)<br>• 据 `gitignore-append-template` 用 Read/Write 并入项目 .gitignore | `plan-start` |
124 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 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 128 ### Coding 阶段(1 个 Workflow,非 skill)
129 129  
... ... @@ -157,7 +157,6 @@ erp-workflow-plugin/
157 157 | downstream-gen | `docs-05-header-template.md` | docs/05 API 契约头部 |
158 158 | downstream-gen | `docs-05-endpoint-template.md` | docs/05 单接口小节 |
159 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 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 4 user-invocable: false
5 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 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 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 73  
80 74 ```
81 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 77 ⏭️ 下一步:运行 /erp-workflow:plan-start 进入终结闸
84 78 ```
85 79  
... ... @@ -90,4 +84,3 @@ allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion
90 84 - `${CLAUDE_SKILL_DIR}/templates/docs-05-endpoint-template.md`
91 85 - `prototype/**/*.html`(前端页面/布局/交互权威;C 段据此推导 FE 清单)
92 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 34 - [ ] A5 下游文档生成 — downstream-gen
35 35 - [ ] docs/02 开发计划已生成
36 36 - [ ] docs/05 API 契约已生成
37   - - [ ] docs/10 验收清单已生成
38 37 - [ ] 下方模块列表已填入
39 38 - [ ] REQ 卡片依赖接口已回填
40 39 - [ ] FE 清单已推导填入 docs/08 § 三
... ...