Commit 1a4f67ad50ac2babf7c85d61be7c7f11dbc5dddb
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).
Showing
4 changed files
with
5 additions
and
25 deletions
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