diff --git a/README.md b/README.md index e897383..d880d64 100644 --- a/README.md +++ b/README.md @@ -133,7 +133,7 @@ erp-workflow-plugin/ | # | Skill | 作用 | 流程中谁调用 | |---|---|---|---| | A0 | `project-init` | • **依赖检查**：检测 git / mysql / node 是否在 PATH，缺失则按 OS 自动安装，装不上再停下提示用户
• 空目录初始化：用 Read/Write/Glob 工具拷模板创建 CLAUDE.md / docs/01/index.md / docs/08
• `git init` | `plan-start` | -| A1 | `scope-lock` | • 引导填项目概述 / 技术栈 / 需求索引
• 按 `docs/01-需求清单//{_module.md, REQ-*.md}` 子目录结构生成 REQ 卡片（CC 据 index.md 填 `{{req_id/title/goal/rules/constraints/acceptance}}` 6 个占位，模板其余内容含输入/输出示例字段表原样复制）
• **A1 终结校验**：REQ 6 个占位均填真实数据、无 `{{` 残留、`config-vars.yaml` **全部配置**（包名 / 端口 / 初始账号 + DB 凭据 / 密钥占位）已锁、各 stack 的 build/lint/unit/e2e 命令写入 docs/04 § 零；缺失则在此（Plan 期）用 `AskUserQuestion` 问清（敏感凭据由用户自填，不进会话）
• 据模板直接 `Write` 生成 `_module.md` / `REQ-*.md`
• 终结校验通过后**自动**调用 `Skill(skeleton-gen)` 进入 A2（不停下） | A0 | +| A1 | `scope-lock` | • 引导填项目概述 / 技术栈 / 需求索引
• 按 `docs/01-需求清单//{_module.md, .md}` 子目录结构生成 REQ 卡片（req_id = `<模块代码>-<子模块代码>-<功能名>`，如 `USR-USR-LOGIN`；CC 据 index.md 填 `{{req_id/title/goal/rules/constraints/acceptance}}` 6 个占位，模板其余内容含输入/输出示例字段表原样复制）
• **A1 终结校验**：REQ 6 个占位均填真实数据、无 `{{` 残留、`config-vars.yaml` **全部配置**（包名 / 端口 / 初始账号 + DB 凭据 / 密钥占位）已锁、各 stack 的 build/lint/unit/e2e 命令写入 docs/04 § 零；缺失则在此（Plan 期）用 `AskUserQuestion` 问清（敏感凭据由用户自填，不进会话）
• 据模板直接 `Write` 生成 `_module.md` / `.md`
• 终结校验通过后**自动**调用 `Skill(skeleton-gen)` 进入 A2（不停下） | A0 | | A2 | `skeleton-gen` | • 生成架构文档：docs/04 § 一+
• 生成跨平台工具脚本：`scripts/*.mjs`（**无 chmod**；凭据 / 配置统一在 A1 产出的 config-vars.yaml）
• 据 `gitignore-append-template` 用 Read/Write 并入项目 .gitignore | `plan-start` | | A3 | `db-design-gen` | • 套用固定 ERP 约定（列前缀 `i/s/t`、`iIncrement` 主键、`sBrandsId`/`sSubsidiaryId` 租户列）从 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） | A3 | @@ -154,10 +154,10 @@ erp-workflow-plugin/ | 所属 Skill | 模板文件 | 用途 | |---|---|---| | project-init | `CLAUDE-template.md` | 项目根的 CLAUDE.md（4 条通用准则 + ERP 专属约定） | -| project-init | `docs-01-index-template.md` | 需求清单索引骨架，等用户填模块表 | +| project-init | `docs-01-index-template.md` | 需求清单索引骨架，等用户填子模块索引表（五列，一行一个子模块） | | project-init | `docs-04-stack-template.md` | docs/04 § 零 默认技术栈总览（零槽位，拷即可） | | project-init | `docs-08-initial-template.md` | 工作流进度文件骨架（Plan A0~A5 checkbox） | -| scope-lock | `req-card-template.md` | 单张 REQ-XXX-NNN 卡片模板（`{{req_id/title/goal/rules/constraints/acceptance}}` 占位 + 输入/输出示例字段表；A1 原样复制，只填这 6 个占位） | +| scope-lock | `req-card-template.md` | 单张 REQ 卡片模板（文件名 == req_id `<模块代码>-<子模块代码>-<功能名>`；`{{req_id/title/goal/rules/constraints/acceptance}}` 占位 + 输入/输出示例字段表；A1 原样复制，只填这 6 个占位） | | scope-lock | `_module-template.md` | 模块子目录的 `_module.md` 模块头（模块代码-名 / 简述 / 依赖模块 TBD / 涉及表 TBD） | | scope-lock | `config-vars-template.yaml` | 仓库根 `config-vars.yaml` 骨架（跨栈中立）：项目**全部配置**——非敏感（包名/端口/前端包名/初始账号）+ 敏感凭据（database / admin_init.password / secrets）；A1 E.2 锁定，随项目提交 | | skeleton-gen | `docs-04-skeleton-template.md` | docs/04 § 一+ 编码规范大纲（HTML 注释引导 LLM） | diff --git a/skills/plan/db-design-gen/SKILL.md b/skills/plan/db-design-gen/SKILL.md index 78ca84e..1268d5f 100644 --- a/skills/plan/db-design-gen/SKILL.md +++ b/skills/plan/db-design-gen/SKILL.md @@ -19,7 +19,7 @@ allowed-tools: Read Write Edit Grep Glob - `docs/04-技术规范.md` - `docs/01-需求清单/index.md` 模块索引 -- `docs/01-需求清单/*/REQ-*.md` 所有 REQ 卡片 +- `docs/01-需求清单/*/*.md` 所有 REQ 卡片（跳过文件名为 `_module.md` 的模块头；卡片文件名 == req_id） ### B. 推导 schema @@ -44,7 +44,7 @@ allowed-tools: Read Write Edit Grep Glob ### D. 回填模块头 + REQ 卡片的 TBD 字段 -1. 列出 `docs/01-需求清单/*/_module.md`（模块头）和 `docs/01-需求清单/*/REQ-*.md`（REQ 卡片）。 +1. 列出 `docs/01-需求清单/*/*.md`：`_module.md`（模块头）和其余 .md（REQ 卡片，文件名 == req_id）。 2. 在这些文件中搜索 `TBD(A3 自动补)` 的并回填。 不动 `TBD(A5 自动补)` 3. 打印回填统计：`A3 回填 处模块"涉及表" + 处 REQ"依赖表"`。 @@ -69,4 +69,4 @@ allowed-tools: Read Write Edit Grep Glob - `${CLAUDE_SKILL_DIR}/templates/docs-03-table-template.md` - `docs/04-技术规范.md` § 一+（命名规范输入） - `docs/01-需求清单//_module.md`（模块头：回填 `涉及表`） -- `docs/01-需求清单//REQ-*.md`（REQ 输入 + 回填 `依赖表`） +- `docs/01-需求清单//.md`（REQ 输入 + 回填 `依赖表`） diff --git a/skills/plan/db-design-gen/templates/docs-03-header-template.md b/skills/plan/db-design-gen/templates/docs-03-header-template.md index 6ef65d9..c8ad6a1 100644 --- a/skills/plan/db-design-gen/templates/docs-03-header-template.md +++ b/skills/plan/db-design-gen/templates/docs-03-header-template.md @@ -2,7 +2,7 @@ - **Schema**: `{{schema_name}}` - **Migration 清单**: `sql/migrations/V*.sql`（由 Flyway 顺序 apply） -- **生成方式**: 由 A3 `db-design-gen` 基于 `docs/01-需求清单//REQ-*.md` REQ 卡片正向设计生成（schema SSoT）。 +- **生成方式**: 由 A3 `db-design-gen` 基于 `docs/01-需求清单//` 下各 REQ 卡片（文件名 == req_id）正向设计生成（schema SSoT）。 ## 项目标准列约定 diff --git a/skills/plan/downstream-gen/SKILL.md b/skills/plan/downstream-gen/SKILL.md index 1bd0e01..162e59b 100644 --- a/skills/plan/downstream-gen/SKILL.md +++ b/skills/plan/downstream-gen/SKILL.md @@ -32,7 +32,7 @@ allowed-tools: Read Write Edit Glob Grep AskUserQuestion ### B2. 回填模块头 + REQ 卡片的 TBD(A5) 字段 -1. 在`docs/01-需求清单/*/_module.md`（模块头）和 `docs/01-需求清单/*/REQ-*.md`（REQ 卡片）中搜索并回填 `TBD(A5 自动补)` +1. 在 `docs/01-需求清单/*/*.md`（模块头 `_module.md` + 全部 REQ 卡片，卡片文件名 == req_id）中搜索并回填 `TBD(A5 自动补)` 2. 打印回填统计：`A5 回填 处模块"依赖模块" + 处 REQ"依赖接口"`。 勾选：` - [ ] REQ 卡片依赖接口已回填` @@ -60,12 +60,12 @@ allowed-tools: Read Write Edit Glob Grep AskUserQuestion 1. **合并扫描三类问题**（最多 3 轮自主修复，docs/01 是 REQ SSoT 不动）——一次性扫一致性 + `TBD(A3/A5 自动补)` + 结构性残留： - **一致性**：docs/01 REQ 全部出现在 docs/05；`docs/02 § 二` `module_id` 集合 = `docs/08 § 二` `module_id` 集合。 - - **TBD 残留**：`TBD(A3 自动补)` → 查 docs/03 填依赖表；`TBD(A5 自动补)` → 查 docs/05 按 REQ-ID 填依赖接口。 - - **结构性**：docs/05 每个 `### REQ-` 端点段含非空 `- **请求**:` / `- **响应**:`（非 `TBD`/`—`/`【人工填写：…】`）；docs/01 全部 REQ-ID 都出现在 `docs/02 § 二` 顺序清单。 + - **TBD 残留**：`TBD(A3 自动补)` → 查 docs/03 填依赖表；`TBD(A5 自动补)` → 查 docs/05 按 req_id 填依赖接口。 + - **结构性**：docs/05 每个 `### ` 三级标题端点段（标题形如 `### <标题>`）含非空 `- **请求**:` / `- **响应**:`（非 `TBD`/`—`/`【人工填写：…】`）；docs/01 全部 req_id 都出现在 `docs/02 § 二` 顺序清单。 命中即按对应步骤规则就地补填（缺端点 → 按 B 推测；缺 module 行 → 按 D 渲染；缺 REQ 顺序行 → 按 A 子流程拓扑插入）。3 轮后仍残留 `【人工填写：】` 或结构缺口 → 打印清单 + 用 `AskUserQuestion` 弹「继续」/「有疑问想先沟通」二选一；每次弹问前重扫一次，避免脏读放行。 -2. **docs/05 + docs/02 人工评审闸**（未确认不得勾选 A5）：摘要展示 docs/05 全部端点（`METHOD PATH — REQ-ID`，标注「由 A5 自动推断」的项）+ docs/02 `req_order[]`（特别标 `note ≠ —` 的环依赖打破项）。`AskUserQuestion` 多问题表单同时问两项：「docs/05 端点/字段无误」+「docs/02 构建顺序可接受」，各二选一 `确认` / `需要修改`。任一需修改 → 收集修改点就地修订并重跑本闸，直到两项均 `确认`；否则禁止勾选 A5、禁止打印横幅。 +2. **docs/05 + docs/02 人工评审闸**（未确认不得勾选 A5）：摘要展示 docs/05 全部端点（`METHOD PATH — `，标注「由 A5 自动推断」的项）+ docs/02 `req_order[]`（特别标 `note ≠ —` 的环依赖打破项）。`AskUserQuestion` 多问题表单同时问两项：「docs/05 端点/字段无误」+「docs/02 构建顺序可接受」，各二选一 `确认` / `需要修改`。任一需修改 → 收集修改点就地修订并重跑本闸，直到两项均 `确认`；否则禁止勾选 A5、禁止打印横幅。 3. 勾选 A5 父项：`- [ ] A5 下游文档生成 — downstream-gen` diff --git a/skills/plan/plan-start/SKILL.md b/skills/plan/plan-start/SKILL.md index ecb717d..25e5000 100644 --- a/skills/plan/plan-start/SKILL.md +++ b/skills/plan/plan-start/SKILL.md @@ -46,7 +46,7 @@ A 阶段 checkbox 全部 `[x]` 后先跑下面 4 项前移闸门; 全过才放 1. **REQ 卡片真实数据**（来自 A1 scope-lock） - `Glob` 找出全部 REQ 卡片（如 `docs/01-需求清单/**/*.md`）。 - 对每张卡片 `Grep` 命中以下任一即缺口: `【人工填写` / `TBD` / `{{`（`{{` = 6 个标量占位未替换；`TBD` = A3/A5 应回填的依赖表/依赖接口仍未补——A1 时这些 `TBD(A3/A5 自动补)` 是合法保留，到本闸必须已解析，故此处比 scope-lock E.1 多查 `TBD`/`【人工填写`）。 - - 缺口表述示例：`REQ-USER-001 仍含 TBD / {{title}} 占位未替换`。 + - 缺口表述示例：`USR-USR-LOGIN 仍含 TBD / {{title}} 占位未替换`。 2. **全部配置全锁**（来自 A1 写入 `config-vars.yaml` 的非敏感配置 + 敏感凭据，单一文件） - `Read` `config-vars.yaml`（项目全部配置，含敏感凭据，随项目提交）：校验所有字段均无 `【人工填写`/`TBD`；除 `database.password` 可显式为空串外，其余字段不得为空——含非敏感项（`backend`/`frontend` 包名 / 端口、`admin_init.username`、`database.host/port/user/schema`）与敏感项（`admin_init.password`、`secrets.*`）。 @@ -95,7 +95,7 @@ A 阶段 checkbox 全部 `[x]` 后先跑下面 4 项前移闸门; 全过才放 <逐条列出每个缺口，格式：[闸门] 缺口描述 → 回填位置> 例： - [REQ 真实数据] REQ-USER-001 仍含 {{goal}} 占位未替换 → docs/01-需求清单/... + [REQ 真实数据] USR-USR-LOGIN 仍含 {{goal}} 占位未替换 → docs/01-需求清单/... [配置] database.password 仍是占位（如本地空密码请显式填 `''`）→ config-vars.yaml [docs/04 §零] node 栈缺 e2e 命令 → docs/04-技术规范.md §零 diff --git a/skills/plan/project-init/templates/CLAUDE-template.md b/skills/plan/project-init/templates/CLAUDE-template.md index c1ff32e..1b7eefb 100644 --- a/skills/plan/project-init/templates/CLAUDE-template.md +++ b/skills/plan/project-init/templates/CLAUDE-template.md @@ -20,7 +20,7 @@ 1. **严格遵循** `docs/04-技术规范.md`——命名 / 编码 / 统一响应 / 异常处理 / 数据访问 / 配置与安全 等项目专属技术规约全部在此 2. **严格遵循** `docs/04-技术规范.md § 1.2 分层结构 / § 2.1 目录约定`——文件放对位置 3. **每个后端接口** 必须先在 `docs/05-API接口契约.md` 定义，再编码实现 -4. **每个功能可追溯到 `REQ-XXX-NNN`**——commit tag + 代码注释（如 `// REQ-SYS-001: 用户登录`）+ plan/spec 文件名均用此 tag +4. **每个功能可追溯到 req_id `<模块代码>-<子模块代码>-<功能名>`**——commit tag + 代码注释（如 `// USR-USR-LOGIN: 用户登录`）+ plan/spec 文件名均用此 tag 5. **遇到跨模块改动**（动到非当前模块的代码）——允许改，但必须在《模块完成报告》记录原因 / 影响评估（留痕） ### 你禁止做的 🚫 @@ -56,7 +56,7 @@ ``` - `scope`: 模块名，如 `user` / `inventory` / `order` -- `subject`: 简短描述；业务类（feat / fix / test）必须带 `REQ-XXX-NNN` 后缀 +- `subject`: 简短描述；业务类（feat / fix / test）必须带 req_id（`<模块代码>-<子模块代码>-<功能名>`，如 `USR-USR-LOGIN`）后缀 `type` 含义： diff --git a/skills/plan/project-init/templates/docs-01-index-template.md b/skills/plan/project-init/templates/docs-01-index-template.md index 372d784..606d35b 100644 --- a/skills/plan/project-init/templates/docs-01-index-template.md +++ b/skills/plan/project-init/templates/docs-01-index-template.md @@ -1,10 +1,13 @@ # 需求清单 -> 本目录按模块组织所有功能需求。每个模块一个子目录，含 `_module.md`（模块头）和 `REQ-XXX-NNN.md`（每张 REQ 卡片一个文件）。下方核心功能点供 CC 拆分出 REQ 编号 + 标题 + 草拟规则；卡片内输入 / 输出的简述句和 N 张字段表由人工编辑。 +> 本目录按模块组织所有功能需求。每个模块一个子目录，含 `_module.md`（模块头）和 `.md`（每张 REQ 卡片一个文件；req_id = `<模块代码>-<子模块代码>-<功能名>` 恒 3 段，如 `USR-USR-LOGIN`——功能名由 CC 据核心功能点推断：英文大写短词、字符集 `[A-Z0-9_]`、多词用下划线如 `PWD_RESET`、同一 模块-子模块 内唯一）。下方核心功能点供 CC 拆分出 req_id + 标题 + 草拟规则；卡片内输入 / 输出的简述句和 N 张字段表由人工编辑。 ## 模块索引 -| 模块代码 | 模块名称 | 核心功能点（简要） | -|----------|----------|--------------------| -| 【人工填写：模块代码】 | 【人工填写：模块名称】 | 【人工填写：核心功能点】 | -| SYS | 系统管理 | 用户/角色/权限/部门/字典 等 | +> 一行一个子模块；同一模块有多个子模块时写多行（模块代码 / 模块名称 重复填写）。 + +| 模块代码 | 模块名称 | 子模块代码 | 子模块名称 | 核心功能点（简要） | +|----------|----------|------------|------------|--------------------| +| 【人工填写：模块代码】 | 【人工填写：模块名称】 | 【人工填写：子模块代码】 | 【人工填写：子模块名称】 | 【人工填写：核心功能点】 | +| USR | 用户管理 | USR | 用户账户 | 登录/注销/改密 等 | +| USR | 用户管理 | ROLE | 角色权限 | 角色 CRUD/权限分配 等 | 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 ae179b9..d057613 100644 --- a/skills/plan/project-init/templates/docs-08-initial-template.md +++ b/skills/plan/project-init/templates/docs-08-initial-template.md @@ -13,7 +13,7 @@ - [ ] 项目概述已填写（CLAUDE.md § 🎯 项目概述） - [ ] 技术栈已确认（docs/04 § 零） - [ ] 需求清单索引已填写（docs/01-需求清单/index.md） - - [ ] REQ 卡片骨架已生成（docs/01-需求清单//REQ-*.md，业务内容留待人工填写） + - [ ] REQ 卡片骨架已生成（docs/01-需求清单//.md，业务内容留待人工填写） - [ ] A2 骨架生成 — skeleton-gen - [ ] 架构文档已生成（docs/04 § 一+） diff --git a/skills/plan/scope-lock/SKILL.md b/skills/plan/scope-lock/SKILL.md index 04b56d5..60d1644 100644 --- a/skills/plan/scope-lock/SKILL.md +++ b/skills/plan/scope-lock/SKILL.md @@ -21,23 +21,23 @@ allowed-tools: Read Write Edit Grep Glob Skill AskUserQuestion Bash(mkdir *) - **A**：`CLAUDE.md` § 🎯 项目概述。占位符含项目名称 / 简述 / 目标用户 / 部署方式。 - **B**：`docs/04-技术规范.md` § 零。让用户检查 / 调整默认技术栈表（删不需要的行 / 改技术 / 加条目）。 -- **C**：`docs/01-需求清单/index.md`。让用户按业务列出所有模块（每行一个，如 SYS / PUR / SAL），「核心功能点」给关键词即可，CC 会拆 REQ 卡片。 +- **C**：`docs/01-需求清单/index.md`。让用户按业务列出所有子模块（一行一个子模块，五列：模块代码/模块名称/子模块代码/子模块名称/核心功能点；同一模块有多个子模块时写多行，如 USR-USR / USR-ROLE / PUR-ORD），「核心功能点」给关键词即可，CC 会拆 REQ 卡片。 ### D. 生成 REQ 卡片骨架并停下等人工审阅 -1. 读 `index.md` 解析模块索引；读两个模板 `${CLAUDE_SKILL_DIR}/templates/_module-template.md`、`${CLAUDE_SKILL_DIR}/templates/req-card-template.md` 作为卡片结构参照。 -2. **每模块/每 REQ 直接 `Write`**：对每个模块先 `mkdir -p "docs/01-需求清单/-<模块名>"`，再照模板结构 `Write`，`` / `<模块名>` / `` 按 `index.md` 实际值替换： - - **模块头** `_module.md`：据 `index.md` 填 `module_code` / `module_name` / `module_brief`；`依赖模块: TBD(A5 自动补)` / `涉及表: TBD(A3 自动补)` 两行原样保留。 - - **每个 REQ** `.md`：**照模板原样 `Write`**，只把 `{{req_id}}` / `{{title}}` / `{{goal}}` / `{{rules}}` / `{{constraints}}` / `{{acceptance}}` 这 6 个占位替换为据 `index.md` 推断的真实值；模板其余内容（`输入` / `输出` 示例字段表、`依赖表: TBD(A3 自动补)` / `依赖接口: TBD(A5 自动补)` 两行）**原样复制不动**；模板顶部 HTML 引导注释**不写进产物**。 +1. 读 `index.md` 解析模块索引（五列，一行一个子模块；按「模块代码」聚合——同一模块的多行共用一个模块子目录）；读两个模板 `${CLAUDE_SKILL_DIR}/templates/_module-template.md`、`${CLAUDE_SKILL_DIR}/templates/req-card-template.md` 作为卡片结构参照。 +2. **每模块/每 REQ 直接 `Write`**：对每个模块先 `mkdir -p "docs/01-需求清单/-<模块名>"`，再照模板结构 `Write`，`` / `<模块名>` / `` 按 `index.md` 实际值替换： + - **模块头** `_module.md`：据 `index.md` 填 `module_code` / `module_name` / `module_brief`（module_brief 汇总该模块全部子模块行的核心功能点）；`依赖模块: TBD(A5 自动补)` / `涉及表: TBD(A3 自动补)` 两行原样保留。 + - **每个 REQ** `.md`（req_id = `<模块代码>-<子模块代码>-<功能名>` 恒 3 段，如 `USR-USR-LOGIN`；功能名由 CC 据该行核心功能点推断：英文大写短词、字符集 `[A-Z0-9_]`、多词用下划线如 `PWD_RESET`、同一 模块-子模块 内唯一；文件名 == req_id）：**照模板原样 `Write`**，只把 `{{req_id}}` / `{{title}}` / `{{goal}}` / `{{rules}}` / `{{constraints}}` / `{{acceptance}}` 这 6 个占位替换为据 `index.md` 推断的真实值；模板其余内容（`输入` / `输出` 示例字段表、`依赖表: TBD(A3 自动补)` / `依赖接口: TBD(A5 自动补)` 两行）**原样复制不动**；模板顶部 HTML 引导注释**不写进产物**。 3. 用 `Edit` 在 `docs/08-模块任务管理.md` 勾选（A1 子项）： - - ` - [ ] REQ 卡片骨架已生成（docs/01-需求清单//REQ-*.md，业务内容留待人工填写）` + - ` - [ ] REQ 卡片骨架已生成（docs/01-需求清单//.md，业务内容留待人工填写）` 4. 打印「请人工填写 REQ 卡片」横幅并提示用户填完后回来继续： ``` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ [scope-lock] REQ 卡片骨架已生成 - - 产出: docs/01-需求清单//{_module.md, REQ-*.md} + - 产出: docs/01-需求清单//{_module.md, .md} - 6 个占位已填真实值；输入/输出字段表为模板示例内容(如需可自行调整)。 - 审阅后选「继续」进 A1 校验. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ @@ -54,7 +54,7 @@ allowed-tools: Read Write Edit Grep Glob Skill AskUserQuestion Bash(mkdir *) 卡片正文是模板原样复制，只有 6 个 `{{}}` 标量由 CC 填——本步只校验这 6 个占位填全填真。 -1. 用 `Glob` 列出所有 `docs/01-需求清单//REQ-*.md`。 +1. 用 `Glob` 列出 `docs/01-需求清单/*/*.md`，跳过文件名为 `_module.md` 的模块头——其余即 REQ 卡片（文件名 == req_id）。 2. 对每张卡片用 `Read` + `Grep` 校验： - **无 `{{` 残留**：不得残留任何 `{{` 占位（命中即说明 6 个标量未全部替换）。 - **6 个标量为真实值**：`req_id` / `title` / `goal` / `rules` / `constraints` / `acceptance` 均据 `index.md` 填为真实内容，非空、非回显占位名。 @@ -93,7 +93,7 @@ allowed-tools: Read Write Edit Grep Glob Skill AskUserQuestion Bash(mkdir *) ✓ docs/04 § 零 技术栈 + build/lint/unit/e2e 命令 ✓ docs/01-需求清单/index.md 模块索引 ✓ docs/01-需求清单//_module.md 模块头 - ✓ docs/01-需求清单//REQ-*.md 6 个占位已填真实值（字段表为模板示例） + ✓ docs/01-需求清单//.md 6 个占位已填真实值（字段表为模板示例） ✓ config-vars.yaml 配置已锁（非敏感已填；DB 凭据 / 密钥占位待人工填，plan-start 把关） 自动进入 A2：skeleton-gen @@ -108,7 +108,7 @@ allowed-tools: Read Write Edit Grep Glob Skill AskUserQuestion Bash(mkdir *) - `docs/04-技术规范.md` - `docs/01-需求清单/index.md` - `docs/01-需求清单//_module.md` -- `docs/01-需求清单//REQ-*.md` +- `docs/01-需求清单//.md` - `config-vars.yaml` - `${CLAUDE_SKILL_DIR}/templates/config-vars-template.yaml` - `${CLAUDE_SKILL_DIR}/templates/req-card-template.md` diff --git a/skills/plan/skeleton-gen/templates/docs-04-skeleton-template.md b/skills/plan/skeleton-gen/templates/docs-04-skeleton-template.md index cb55742..6b3805b 100644 --- a/skills/plan/skeleton-gen/templates/docs-04-skeleton-template.md +++ b/skills/plan/skeleton-gen/templates/docs-04-skeleton-template.md @@ -34,7 +34,7 @@ ## 三、共同约定 ### 3.1 Git 提交 -`(): REQ-XXX-NNN` +`(): `（req_id = `<模块代码>-<子模块代码>-<功能名>`，如 `USR-USR-LOGIN`） ### 3.2 分页查询 diff --git a/workflows/coding.mjs b/workflows/coding.mjs index 15e7cc8..a796589 100644 --- a/workflows/coding.mjs +++ b/workflows/coding.mjs @@ -235,7 +235,7 @@ function featureStageContract(phase) { `- **阶段 = ${fe ? '前端（frontend）' : '后端（backend）'}**。路径作用域：${fe ? '实现文件必须落在 `frontend/` 下；命中 `backend/` / `sql/` / `scripts/` 即越界，硬停。' : '产出范围限定 controller / service / repository / DTO / 校验 / SQL migration / REST 契约；**禁止**写 `frontend/` 路径下的实现（UI 推迟到前端阶段）。'}`, - `- id 形态：${fe ? '前端为 `FE-NN`（业务功能粒度，可关联多个 prototype 区域与多个 REQ）。' : '后端为 `REQ-XXX-NNN`。'}`, + `- id 形态：${fe ? '前端为 `FE-NN`（业务功能粒度，可关联多个 prototype 区域与多个 REQ）。' : '后端为 `<模块代码>-<子模块代码>-<功能名>`（3 段大写 req_id，如 `USR-USR-LOGIN`）。'}`, ].join('\n') } @@ -1319,7 +1319,7 @@ function classifyCrossModulePromptM(moduleId, files) { '- 落在共享根（如 `docs/`、`scripts/`、`sql/migrations/`、`README.md` 等）→ **不算**跨模块。', '', '## 输出（CROSS_CLASSIFY_SCHEMA）', - '- `{ "crossModule": [ { "file": "...", "targetModule": "module_x", "reason": "<本模块哪个 REQ-XXX-NNN 迫使改它，1 句>", "impact": "<目标模块哪些 API/行为/调用方/测试受影响，1-3 句>" }, ... ] }`', + '- `{ "crossModule": [ { "file": "...", "targetModule": "module_x", "reason": "<本模块哪个 REQ（req_id，如 USR-USR-LOGIN）迫使改它，1 句>", "impact": "<目标模块哪些 API/行为/调用方/测试受影响，1-3 句>" }, ... ] }`', '- 无跨模块改动：`{ "crossModule": [] }`', '- **不要留 `TBD(CC 补)`**：本步骤就是补齐的唯一时机；推不出原因 / 影响 → 整步失败（schema 失败即可，调用方会 halt）。', ].join('\n')