name: scope-lock
description: A1 计划范围锁定——引导用户填写项目概述 + 技术栈 + 需求索引，并按模块子目录生成 REQ 卡片骨架（CC 推断 req_id/title/goal/rules/constraints/acceptance；输入/输出 各含一句简述 + N 张示例字段表全部原样复制由人工编辑；依赖表/依赖接口模板写死 TBD(A3/A5 自动补) 由后续 skill 回填）。
user-invocable: false
allowed-tools: Read Edit Grep Skill AskUserQuestion Bash(mkdir *) Bash(cp *) Bash(sed *) Bash(bash *) Bash(cat *)
所有输出必须使用中文。
scope-lock
执行步骤
步骤 0：打印当前位置流程图
用 Bash 执行 cat 命令向用户展示当前位置流程图（stdout 即 ASCII 框图）：
cat "${CLAUDE_PLUGIN_ROOT}/skills/plan/scope-lock/banners/flow.txt"
A. 提示用户填写项目概述并等待
向用户输出：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[scope-lock] 请填写项目概述
📄 文件位置: ./CLAUDE.md
📌 编辑位置: § 🎯 项目概述
请将以下占位符替换为实际值：
- 项目名称
- 项目简述
- 目标用户
- 部署方式
改完后回来选择「继续」。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
用 AskUserQuestion 询问：
-
question:
项目概述填写完毕了吗？- 用户选择「继续」→ 用
Grep在CLAUDE.md搜索【人工填写：（限定 § 🎯 项目概述 节）。命中 → 打印残留行 + 路径，重新弹出同样的 AskUserQuestion；0 命中 → 勾选并进入步骤 B。 - 用户选择「有疑问想先沟通」→ 回答用户问题后，再次弹出同样的 QA。
- 用户选择「继续」→ 用
0 命中后，用 Edit 在 docs/08-模块任务管理.md 中勾选：
- [ ] 项目概述已填写（CLAUDE.md § 🎯 项目概述）
B. 默认技术栈（自动，无停顿）
docs/04-技术规范.md 已由 A0 project-init 用模板复制（默认技术栈，见 project-init/templates/docs-04-stack-template.md）。本步骤让用户检查 / 调整 § 零。
向用户输出：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[scope-lock] 技术栈已保存
📄 文件位置: ./docs/04-技术规范.md（由 A0 模板生成）
📌 编辑位置: § 零、技术栈总览
请检查技术栈表：
- 不需要的行直接删除（如纯后端项目删前端行）
- 需要替换的技术直接改
- 需要新增的条目直接加行
（默认栈开箱即用；如需改，直接编辑该文件即可，流程不会在此等待。）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
不再弹窗等待。 默认技术栈直接采用；若用户在本轮对话中已明确要求调整某项技术，就地用 Edit 改 docs/04 § 零，否则保持默认。随后用 Edit 在 docs/08-模块任务管理.md 中勾选，并直接进入步骤 C：
- [ ] 技术栈已确认（docs/04 § 零）
C. 提示用户填写需求清单并等待
docs/01-需求清单/index.md 已由 project-init 写入占位符模板，这里让用户补齐模块清单。
向用户输出：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[scope-lock] 请填写需求清单模块索引
📄 文件位置: ./docs/01-需求清单/index.md
📌 编辑位置: § 模块索引（表格）
请按业务列出所有模块：
- 每行一个模块（如 SYS 系统管理 / PUR 采购 / SAL 销售）
- 「核心功能点」只需关键词，CC 会拆分为 REQ 卡片
改完后回来选择「继续」。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
用 AskUserQuestion 询问：
-
question:
需求清单模块索引填写完毕了吗？- 用户选择「继续」→ 进入步骤 D。
- 用户选择「有疑问想先沟通」→ 回答用户问题后，再次弹出同样的 QA。
完成后，用 Edit 在 docs/08-模块任务管理.md 中勾选：
- [ ] 需求清单索引已填写（docs/01-需求清单/index.md）
D. 生成 REQ 卡片骨架并停下等人工审阅
- 用
Grep校验docs/01-需求清单/index.md无【人工填写：残留；有则回步骤 C。 - 用
Read读index.md解析模块索引。 - 单次 Bash 写入所有文件（替代 N×9 次 Edit）：
-
每模块推断：三元组
{module_code, module_name, module_brief}+ N 个 REQ 的六元组{req_id, title, goal, rules, constraints, acceptance}。req_id/title从核心功能点拆分；goal展开title；rules/constraints/acceptance起草业务语义。不推断输入 / 输出（模板原样保留示例）。 -
单次 Bash：调
${CLAUDE_SKILL_DIR}/scripts/render.sh落盘所有文件（脚本内部完成模板读取 + 占位符替换 + HTML 注释剥离）。下面是调用形态示例，<MOD>/<模块名>/<REQ-MOD-NNN>等尖括号位置 CC 按index.md实际值替换：R="${CLAUDE_SKILL_DIR}/scripts/render.sh" # 每个模块：mkdir + 1 个 render module + N 个 render req（每 REQ 一行） mkdir -p "docs/01-需求清单/<MOD>-<模块名>" bash "$R" module "docs/01-需求清单/<MOD>-<模块名>/_module.md" "<MOD>" "<模块名>" "<module_brief>" bash "$R" req "docs/01-需求清单/<MOD>-<模块名>/<REQ-MOD-NNN>.md" "<REQ-MOD-NNN>" "<title>" "<goal>" "<rules>" "<constraints>" "<acceptance>" -
兜底：值含字面
$xxx或}}的 REQ 单独走 cp + Edit。- 用
Edit在docs/08-模块任务管理.md勾选（A1 子项 + A1 顶层）：
- 用
- [ ] REQ 卡片骨架已生成（docs/01-需求清单/<module>/REQ-*.md，业务内容留待人工填写）-
- [ ] A1 范围锁定 — scope-lock- 打印停下横幅并停止：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[scope-lock] ✅ A1 范围锁定完成
产出：
✓ CLAUDE.md § 🎯 项目概述
✓ docs/04 § 零 技术栈
✓ docs/01-需求清单/index.md 模块索引
✓ docs/01-需求清单/<module>/_module.md 模块头
✓ docs/01-需求清单/<module>/REQ-*.md REQ 卡片骨架
⏸ 现在请你逐张打开 REQ 卡片：
- **必改**：输入 / 输出 两段
· `表1` / `表2` 是模板示例，按本 REQ 业务**改字段 / 增删行 / 增删整张表**
- **审阅**：目标 / 跨字段规则 / 边界 / 验收（已起草，对照业务校正）
- **保留**：`TBD` 不要改，由之后流程自动回填
审阅完成后，运行以下命令继续进入 A2：
/erp-workflow:plan-start
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
参考
-
CLAUDE.md§ 🎯 项目概述（写入目标） -
docs/04-技术规范.md（技术栈输出，供 skeleton-gen 读取使用） -
docs/01-需求清单/index.md（模块索引输入） -
docs/01-需求清单/<module>/_module.md（模块头输出） -
docs/01-需求清单/<module>/REQ-*.md（REQ 卡片骨架输出，A3 db-design-gen / A5 downstream-gen 会回填 TBD 字段） ${CLAUDE_SKILL_DIR}/templates/req-card-template.md${CLAUDE_SKILL_DIR}/templates/_module-template.md-
${CLAUDE_SKILL_DIR}/scripts/render.sh（步骤 D 渲染助手，dispatchmodule/req两种模式）