From 1a4f67ad50ac2babf7c85d61be7c7f11dbc5dddb Mon Sep 17 00:00:00 2001 From: zichun Date: Fri, 29 May 2026 16:10:42 +0800 Subject: [PATCH] downstream-gen: remove docs/10 acceptance checklist (write-only, no consumer) --- README.md | 5 ++--- skills/plan/downstream-gen/SKILL.md | 13 +++---------- skills/plan/downstream-gen/templates/docs-10-header-template.md | 11 ----------- skills/plan/project-init/templates/docs-08-initial-template.md | 1 - 4 files changed, 5 insertions(+), 25 deletions(-) delete mode 100644 skills/plan/downstream-gen/templates/docs-10-header-template.md diff --git a/README.md b/README.md index 0eabebc..01f3754 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,7 @@ Claude Code 插件：ERP / 后端管理系统全流程开发框架。 ↓ A4 db-init（docs/03 → V1 migration → 自动 apply 到本地 MySQL） ↓ - A5 downstream-gen（docs/02 / docs/05 / docs/10 / docs/08 § 三 FE 清单；prototype/ 门禁） + A5 downstream-gen（docs/02 / docs/05 / docs/08 § 三 FE 清单；prototype/ 门禁） ↓ ⛔ docs/05 + docs/02 评审闸（必须确认） ⛔ Plan 终结硬闸（全部前移闸门通过才放行） ↓ @@ -123,7 +123,7 @@ erp-workflow-plugin/ | A2 | `skeleton-gen` | • 生成架构文档：docs/04 § 一+
• 生成跨平台工具脚本：`scripts/*.mjs`（**无 chmod**；凭据 / 配置统一在 A1 产出的 config-vars.yaml）
• 据 `gitignore-append-template` 用 Read/Write 并入项目 .gitignore | `plan-start` | | A3 | `db-design-gen` | • A3 起始用 `AskUserQuestion` 确认 ERP 约定（主键策略 / 租户列 / 列前缀规则，默认值可覆盖），结果写 docs/04 + CLAUDE.md
• 从 docs/01 REQ 卡片正向设计 `docs/03-数据库设计文档.md`（schema SSoT）
• 回填 REQ 卡片依赖表（`TBD(A3 自动补)` → 实际表名）
• **停下**等人工审阅 docs/03，审阅完毕用 `/plan-start` 续进 A4 | A2 | | A4 | `db-init` | • LLM 解析 docs/03 → `sql/migrations/V1__initial_schema.sql`（DDL only）
• `node ${CLAUDE_PLUGIN_ROOT}/lib/validate-ddl.mjs` 校验 DDL ↔ docs/03（5 维：表/列名/列类型/索引/FK），fail-closed
• `node ${CLAUDE_PLUGIN_ROOT}/lib/apply-ddl.mjs config-vars.yaml V1.sql`（解析 config-vars.yaml database: 段 + mysql2 apply，**无 shell-source**） | A3 | -| A5 | `downstream-gen` | • 一次性生成 docs/02 / docs/05 / docs/10
• 回填 REQ 卡片依赖接口（`TBD(A5 自动补)` → 实际 endpoint）
• 追加模块清单到 docs/08 § 二
• **docs/05 + docs/02 评审闸**：用 `AskUserQuestion` 让用户确认 API 端点/字段无误 + 构建顺序可接受，未确认不勾 A5
• **prototype/ 门禁 + 推导 FE 清单写 docs/08 § 三**（原 A6 已并入；无 prototype 则问「无前端」→ § 三 留空）
• 最终占位符 + 结构残留扫描 | A4 | +| A5 | `downstream-gen` | • 一次性生成 docs/02 / docs/05
• 回填 REQ 卡片依赖接口（`TBD(A5 自动补)` → 实际 endpoint）
• 追加模块清单到 docs/08 § 二
• **docs/05 + docs/02 评审闸**：用 `AskUserQuestion` 让用户确认 API 端点/字段无误 + 构建顺序可接受，未确认不勾 A5
• **prototype/ 门禁 + 推导 FE 清单写 docs/08 § 三**（原 A6 已并入；无 prototype 则问「无前端」→ § 三 留空）
• 最终占位符 + 结构残留扫描 | A4 | ### Coding 阶段（1 个 Workflow，非 skill） @@ -157,7 +157,6 @@ erp-workflow-plugin/ | downstream-gen | `docs-05-header-template.md` | docs/05 API 契约头部 | | downstream-gen | `docs-05-endpoint-template.md` | docs/05 单接口小节 | | downstream-gen | `docs-08-module-row-template.md` | docs/08 § 二 单模块 bullet 行 | -| downstream-gen | `docs-10-header-template.md` | docs/10 验收清单（项目级 SOP，零槽位 + 引用指针） | ## 前置依赖 diff --git a/skills/plan/downstream-gen/SKILL.md b/skills/plan/downstream-gen/SKILL.md index ac2e6b8..5694de2 100644 --- a/skills/plan/downstream-gen/SKILL.md +++ b/skills/plan/downstream-gen/SKILL.md @@ -1,6 +1,6 @@ --- name: downstream-gen -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 已并入此处）。 +description: A5 下游文档生成——基于 docs/01 和 docs/03 推导，一次性生成 docs/02 + docs/05，回填 REQ 卡片依赖接口，把模块清单追加到 docs/08 § 二，并由 prototype/ + docs/01 + docs/05 推导 FE 清单写入 docs/08 § 三。这是 Plan 阶段最后一个 A 步骤（A6 已并入此处）。 user-invocable: false allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion --- @@ -55,13 +55,7 @@ allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion 勾选：` - [ ] 下方模块列表已填入` -### E. docs/10 — 验收清单（项目级 SOP） - -用 `Read` 读取 `${CLAUDE_SKILL_DIR}/templates/docs-10-header-template.md`，用 `Write` 原样写到 `docs/10-验收检查清单.md`（跨平台，不用 `cp`）。 - -勾选：` - [ ] docs/10 验收清单已生成` - -### F. 验证 + 勾选 docs/08 进度 + 结束 Plan +### E. 验证 + 勾选 docs/08 进度 + 结束 Plan 1. **合并扫描三类问题**（最多 3 轮自主修复，docs/01 是 REQ SSoT 不动）——一次性扫一致性 + `TBD(A3/A5 自动补)` + 结构性残留： @@ -79,7 +73,7 @@ allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion ``` [downstream-gen] ✅ A5 下游文档生成完成（Plan A0~A5 全部完成） - 产出：docs/02 / docs/05 / docs/10 / docs/08 § 二 模块清单 / docs/08 § 三 FE 清单；docs/08 § 一 A0~A5 已全勾。 + 产出：docs/02 / docs/05 / docs/08 § 二 模块清单 / docs/08 § 三 FE 清单；docs/08 § 一 A0~A5 已全勾。 ⏭️ 下一步：运行 /erp-workflow:plan-start 进入终结闸 ``` @@ -90,4 +84,3 @@ allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion - `${CLAUDE_SKILL_DIR}/templates/docs-05-endpoint-template.md` - `prototype/**/*.html`（前端页面/布局/交互权威；C 段据此推导 FE 清单） - `${CLAUDE_SKILL_DIR}/templates/docs-08-module-row-template.md`（模块 bullet 行模板） -- `${CLAUDE_SKILL_DIR}/templates/docs-10-header-template.md` diff --git a/skills/plan/downstream-gen/templates/docs-10-header-template.md b/skills/plan/downstream-gen/templates/docs-10-header-template.md deleted file mode 100644 index 3fec40f..0000000 --- a/skills/plan/downstream-gen/templates/docs-10-header-template.md +++ /dev/null @@ -1,11 +0,0 @@ -# 10-验收检查清单 - -通用验收项（全项目适用）： - -- [ ] `node scripts/test.mjs` 本地全绿 -- [ ] 所有 schema 改动都有对应 `sql/migrations/V_n__.sql` -- [ ] 所有新接口在 `docs/05` 中有契约定义 -- [ ] 所有新功能代码注释含 REQ-XXX-NNN -- [ ] 统一响应格式 `{code, message, data, timestamp}` -- [ ] 异常走全局处理器，不暴露堆栈到前端 -- [ ] 前端不存敏感信息到 localStorage diff --git a/skills/plan/project-init/templates/docs-08-initial-template.md b/skills/plan/project-init/templates/docs-08-initial-template.md index c97a4d4..b90948b 100644 --- a/skills/plan/project-init/templates/docs-08-initial-template.md +++ b/skills/plan/project-init/templates/docs-08-initial-template.md @@ -34,7 +34,6 @@ - [ ] A5 下游文档生成 — downstream-gen - [ ] docs/02 开发计划已生成 - [ ] docs/05 API 契约已生成 - - [ ] docs/10 验收清单已生成 - [ ] 下方模块列表已填入 - [ ] REQ 卡片依赖接口已回填 - [ ] FE 清单已推导填入 docs/08 § 三 -- libgit2 0.22.2