SKILL.md 10.9 KB

Edit Raw Blame History



name: erp-scope-lock
description: A1 计划范围锁定——引导用户填写项目概述 + 技术栈 + 需求索引，并自动扩展 REQ 卡片待人工评审。schema_refs 填 TBD(A4 自动补)（A4 回填依赖表），api_refs 填 TBD(A5 自动补)（A5 回填依赖接口）。
user-invocable: false


allowed-tools: Read Write Edit Grep Skill AskUserQuestion

所有输出必须使用中文。


erp-scope-lock


执行步骤


步骤 0：打印当前位置流程图

向用户展示当前在 A 阶段流程中的位置（A-only，▶ 标在 A1）：
┌──────────────────────────────────────────────────────┐
│ 📋 阶段 A：规划（一次性）                               │
│                                                       │
│   A0 初始化项目 → ▶ A1 锁范围（REQ 卡片）               │
│                          ↓                            │
│     ⏸ 等你审阅 REQ，重新运行 /erp-plan-start 继续      │
│                          ↓                            │
│   A2 生成骨架 → A3 初始化 DB → A4 生成 DB 设计 → A5 生成下游文档│
│                                  ↓                    │
│                    规划阶段到此结束                     │
└──────────────────────────────────────────────────────┘


A. 提示用户填写项目概述并等待

向用户输出：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 [erp-scope-lock] 请填写项目概述

 📄 文件位置: ./CLAUDE.md
 📌 编辑位置: § 🎯 项目概述

 请将以下占位符替换为实际值：
   - 项目名称
   - 项目简述
   - 目标用户
   - 部署方式
 改完后回来选择「继续」。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


用 AskUserQuestion 询问：


question: 项目概述填写完毕了吗？


options (每项为对象)：


{"label": "继续", "description": "已完成检查"}
{"label": "有疑问想先沟通", "description": "需要讨论或修改"}


用户选择「有疑问想先沟通」→ 回答用户问题后，再次弹出同样的 QA。
用户选择「继续」→ 进入步骤 B。


B. 保存默认技术栈到 docs/04

用 Write 将以下默认技术栈表写入 docs/04-技术规范.md：
# 04-技术规范

## 零、技术栈总览

| 分层模块 | 技术 | 版本要求 | 说明 |
|---|---|---|---|
| 前端基础框架 | React | 18.x | 构建前端应用 |
| 前端 UI 组件 | Ant Design | 5.x | 页面组件与交互控件 |
| 前端状态管理 | Redux Toolkit | 最新稳定版 | 管理全局状态 |
| 前端路由管理 | React Router | v6 | 页面路由与导航 |
| 前端工程化构建 | Vite | 最新稳定版 | 前端开发与打包构建 |
| 前端接口通信 | Axios | 最新稳定版 | 调用后端 API |
| 后端基础框架 | Spring Boot | 3.x | 构建后端服务 |
| 后端数据访问 | MyBatis-Plus | 最新稳定版 | 数据库访问与 ORM 增强 |
| 工作流引擎 | Activiti | 6.x | 审批流、流程流转 |
| 缓存服务 | Redis | 最新稳定版 | 缓存、会话、分布式能力 |
| 报表打印 | JXLS | 2.8.1 | 基于 Excel 模板生成报表 |
| Excel 导入导出 | EasyExcel | 4.0.3 | Excel 数据导入导出 |
| 关系型数据库 | MySQL | 8.x | 核心业务数据存储 |
| 数据库 schema 迁移 | Flyway (`flyway-core` + `flyway-mysql`) | 10.x / 最新稳定版 | `sql/migrations/V_n__*.sql` 顺序 apply；Spring Boot 启动时自动应用 |
| 接口风格 | RESTful API | 统一规范 | 前后端接口设计规范 |
| 权限认证 | Spring Security / JWT | 最新稳定版 | 登录认证、权限控制 |
| API 文档 | OpenAPI / Swagger | 最新稳定版 | 接口文档与调试 |
| 项目构建管理 | Maven | 3.9.x | Java 项目依赖与构建 |
| JDK 运行环境 | Java | 17 / 21 | Spring Boot 3 推荐版本 |
| 部署容器 | Docker | 最新稳定版 | 容器化部署 |
| Web 服务器 / 反向代理 | Nginx | 最新稳定版 | 前端托管、反向代理、负载分发 |
| 日志管理 | Logback | 默认集成 / 最新稳定版 | 应用日志输出 |
| 对象映射工具 | MapStruct | 最新稳定版 | DTO / VO / Entity 转换 |
| 工具类库 | Hutool / Apache Commons | 最新稳定版 | 常用工具方法支持 |

> 本表由 erp-scope-lock 锁定。后续所有规范基于此表推导。


C. 提示用户检查并等待

向用户输出：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 [erp-scope-lock] 技术栈已保存

 📄 文件位置: ./docs/04-技术规范.md
 📌 编辑位置: § 零、技术栈总览

 请检查技术栈表：
   - 不需要的行直接删除（如纯后端项目删前端行）
   - 需要替换的技术直接改
   - 需要新增的条目直接加行
 改完后回来选择「继续」。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


用 AskUserQuestion 询问：


question: 技术栈检查完毕了吗？


options (每项为对象)：


{"label": "继续", "description": "已完成检查"}
{"label": "有疑问想先沟通", "description": "需要讨论或修改"}


用户选择「有疑问想先沟通」→ 回答用户问题后，再次弹出同样的 QA。
用户选择「继续」→ 进入步骤 D。


D. 提示用户填写需求清单并等待

docs/01-需求清单/README.md 已由 erp-project-init 写入占位符模板，这里让用户补齐模块清单。

向用户输出：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 [erp-scope-lock] 请填写需求清单模块索引

 📄 文件位置: ./docs/01-需求清单/README.md
 📌 编辑位置: § 模块索引（表格）

 请按业务列出所有模块：
   - 每行一个模块（如 SYS 系统管理 / PUR 采购 / SAL 销售）
   - 「核心功能点」只需关键词，CC 会扩展为完整 REQ 卡片
 改完后回来选择「继续」。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


用 AskUserQuestion 询问：


question: 需求清单模块索引填写完毕了吗？


options (每项为对象)：


{"label": "继续", "description": "已完成检查"}
{"label": "有疑问想先沟通", "description": "需要讨论或修改"}


用户选择「有疑问想先沟通」→ 回答用户问题后，再次弹出同样的 QA。
用户选择「继续」→ 进入步骤 E。


E. 生成 REQ 卡片并等用户审阅

先用 Grep 在 docs/01-需求清单/README.md 搜索 【人工填写：，命中 → 提示残留行，回到步骤 D。通过后：


用 Read 读取 docs/01-需求清单/README.md，解析模块索引表（每行：模块代码 / 模块名 / 核心功能点）。
用 Read 读取两份模板：


${CLAUDE_SKILL_DIR}/templates/req-card-template.md
${CLAUDE_SKILL_DIR}/templates/docs-01-module-template.md


对每个模块：


基于「核心功能点」关键词，LLM 扩展为若干 REQ-XXX-NNN 卡片（编号按模块递增）
每张卡片填充字段：


goal / input / output / rules / constraints / acceptance —— LLM 基于功能点推断

schema_refs —— 填 TBD(A4 自动补)（A4 erp-db-design-gen 回填依赖表）

api_refs —— 填 TBD(A5 自动补)（A5 erp-downstream-gen 回填依赖接口）


用 module 模板包装卡片列表
用 Write 写入 docs/01-需求清单/<module_code>-<module_name>.md


向用户输出（只打印，不弹出 QA，不等待）：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 [erp-scope-lock] REQ 卡片已生成

 📄 文件位置: ./docs/01-需求清单/<module>-*.md
 ⚠️ 依赖表 = TBD(A4 自动补)（A4 阶段回填） / 依赖接口 = TBD(A5 自动补)（A5 阶段回填）

 请人工审阅每张 REQ 卡片的功能字段：
   - 目标 / 输入 / 输出
   - 业务规则 / 边界
   - 验收标准

 审阅是 Plan 阶段的关键人工关口，请认真逐张过一遍。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


立即进入步骤 F（不等待用户任何输入）。


F. 勾选 docs/08 进度 + 停下等人工审阅


用 Edit 在 docs/08-模块任务管理.md 勾选 5 个 checkbox（A1 的 4 个子项 + A1 父项）：


- [ ] 项目概述已填写（CLAUDE.md § 🎯 项目概述） → [x]


- [ ] 技术栈已确认（docs/04 § 零） → [x]


- [ ] 需求清单索引已填写（docs/01-需求清单/README.md） → [x]


- [ ] REQ 卡片已生成（docs/01-需求清单/*.md，schema/api 字段标记为 TBD） → [x]


- [ ] A1 范围锁定 — erp-scope-lock → [x]


输出 scope-lock: 完成（4 项产出已勾选）。
打印停下横幅并停下（不调 Skill(erp-skeleton-gen)，A2 由用户手动恢复）：

   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    [erp-scope-lock] ✅ A1 范围锁定完成

    产出：
      ✓ CLAUDE.md § 🎯 项目概述
      ✓ docs/04 § 零 技术栈
      ✓ docs/01-需求清单/README.md 模块索引
      ✓ docs/01-需求清单/<module>-*.md REQ 卡片

    ⏸ 现在请你审阅 REQ 卡片（路径：`docs/01-需求清单/<module_code>-<module_name>.md`）。

    审阅完成后，运行以下命令继续进入 A2：
      /erp-workflow:erp-plan-start

    （入口会读取 docs/08 进度，自动派发到 A2 erp-skeleton-gen）
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


停止，不调用任何下游 skill。


参考


CLAUDE.md § 🎯 项目概述（写入目标）

docs/04-技术规范.md（技术栈输出，供 erp-skeleton-gen 读取使用）

docs/01-需求清单/README.md（模块索引输入）

docs/01-需求清单/<module>-*.md（REQ 卡片输出，A4 erp-db-design-gen 会回填 TBD 字段）
${CLAUDE_SKILL_DIR}/templates/req-card-template.md
${CLAUDE_SKILL_DIR}/templates/docs-01-module-template.md