remove docs/06 + A6 frontend-scope-lock — prototype/ is the frontend SSoT

- delete frontend-scope-lock skill + docs/06 templates (static + module-pagelist) - A5 downstream-gen gains prototype/ gate + FE-list derivation -> docs/08 § 三 - plan-start: drop A6 dispatch row, gate 5->4 items; coding-start A0~A6 -> A0~A5 - Design Tokens single source = src/styles/tokens.css (code-reviewer, coding.mjs) - plugin.json skills 9->8; docs-09 tree drops 06-UI; docs-08 drops A6 section

remove docs/06 + A6 frontend-scope-lock — prototype/ is the frontend SSoT
- delete frontend-scope-lock skill + docs/06 templates (static + module-pagelist) - A5 downstream-gen gains prototype/ gate + FE-list derivation -> docs/08 § 三 - plan-start: drop A6 dispatch row, gate 5->4 items; coding-start A0~A6 -> A0~A5 - Design Tokens single source = src/styles/tokens.css (code-reviewer, coding.mjs) - plugin.json skills 9->8; docs-09 tree drops 06-UI; docs-08 drops A6 section
zichun
1 parent 2a3f8d09
Showing 13 changed files with 58 additions and 249 deletions
.claude-plugin/plugin.json
agents/code-reviewer.md
skills/coding/coding-start/SKILL.md
skills/plan/downstream-gen/SKILL.md
skills/plan/downstream-gen/templates/docs-06-module-pagelist-template.md
skills/plan/frontend-scope-lock/SKILL.md
skills/plan/frontend-scope-lock/templates/fe-scope-template.md
skills/plan/plan-start/SKILL.md
skills/plan/project-init/templates/docs-08-initial-template.md
skills/plan/skeleton-gen/SKILL.md
skills/plan/skeleton-gen/templates/docs-06-static-template.md
skills/plan/skeleton-gen/templates/docs-09-structure-template.md
workflows/coding.mjs
 {
   "name": "erp-workflow",
-  "description": "ERP 项目全流程框架：阶段 A 计划（plan-start 入口 + A0~A6 共 7 个 skill + B 阶段瘦入口 coding-start = 9 个 skill；plan-start 终结闸 5 项前移硬校验） + 阶段 B 编码（单个静默 Workflow 脚本 coding.mjs，子代理自动跑后端+前端功能循环、测试闸门、本地里程碑 tag）。",
+  "description": "ERP 项目全流程框架：阶段 A 计划（plan-start 入口 + A0~A5 共 6 个 skill + B 阶段瘦入口 coding-start = 8 个 skill；plan-start 终结闸 4 项前移硬校验） + 阶段 B 编码（单个静默 Workflow 脚本 coding.mjs，子代理自动跑后端+前端功能循环、测试闸门、本地里程碑 tag）。",
   "version": "0.2.0",
   "skills": [
     "./skills/plan/plan-start",
@@ -10,7 +10,6 @@
     "./skills/plan/db-design-gen",
     "./skills/plan/db-init",
     "./skills/plan/downstream-gen",
-    "./skills/plan/frontend-scope-lock",
     "./skills/coding/coding-start"
   ]
 }
@@ -33,8 +33,8 @@ For each dimension below, classify Critical / Important / Suggestion as above.
 - Not allowed: structural deviation (e.g., moving the primary action from top-right to bottom-center, dropping a filter region the prototype shows).
 ### 2. Design Tokens (objective → can request-changes)
-- All color values MUST use `var(--color-*)` per `docs/06 § 二`. Hard-coded hex / rgb → `request-changes` with file:line.
-- New tokens used in code without registration in `docs/06 § 二` and `tokens.css` → `request-changes`.
+- All color values MUST use `var(--color-*)` per `src/styles/tokens.css` (the single token source). Hard-coded hex / rgb → `request-changes` with file:line.
+- New tokens used in code without registration in `src/styles/tokens.css` → `request-changes`.
 ### 3. 无障碍 (Accessibility) — best-effort, flag-obvious-only
 - Form controls have `<label>` or `aria-label`.
@@ -43,7 +43,7 @@ For each dimension below, classify Critical / Important / Suggestion as above.
 - **Color contrast is subjective/best-effort:** flag only obvious, unambiguous failures, and only as a Suggestion. Accessibility findings here **never** become the sole basis for `request-changes` — a missing `<label>` on a control that the spec requires may be a must-fix, but contrast judgments are not.
 ### 4. 响应式 (Responsive) — best-effort, flag-obvious-only
-- At the minimum resolution declared in `docs/06 § 一通用交互规则`, no horizontal scrollbar.
+- At the prototype's intended viewport (per `prototype/`), no horizontal scrollbar.
 - Critical operations must not depend on hover-only interactions (must work on touch).
 - **This dimension is subjective/best-effort:** flag only obvious failures, and as a Suggestion. Responsive findings **never** become the sole basis for `request-changes`.
 ---
 name: coding-start
-description: B 阶段（Coding）瘦入口。校验 Plan 终结闸（docs/08 §一 A0~A6 全勾、已在本地默认分支、工作树干净）后，读取 docs/08 §二/§三 概述模块/前端进度，然后调用 workflows/coding.mjs Workflow 全自动、静默地跑完整个编码阶段（后端+前端功能循环、测试闸、里程碑 tag），跑完或 halt 时返回最终状态。本入口不写任何文件、不做编码决策。
+description: B 阶段（Coding）瘦入口。校验 Plan 终结闸（docs/08 §一 A0~A5 全勾、已在本地默认分支、工作树干净）后，读取 docs/08 §二/§三 概述模块/前端进度，然后调用 workflows/coding.mjs Workflow 全自动、静默地跑完整个编码阶段（后端+前端功能循环、测试闸、里程碑 tag），跑完或 halt 时返回最终状态。本入口不写任何文件、不做编码决策。
 user-invocable: true
 allowed-tools: Read Glob Workflow Bash(pwd) Bash(git rev-parse *) Bash(git status *) Bash(git branch *) Bash(git tag *)
 ---
@@ -39,8 +39,8 @@ allowed-tools: Read Glob Workflow Bash(pwd) Bash(git rev-parse *) Bash(git statu
 `Read` `docs/08-模块任务管理.md`，逐项校验，任一不满足即**拦截、不启动 Workflow**：
-1. **docs/08 § 一 A0~A6 全部勾选**
-   - 读 § 一 进度表，确认 A0/A1/A2/A3/A4/A5/A6（含各自子项）均为 `[x]`。
+1. **docs/08 § 一 A0~A5 全部勾选**
+   - 读 § 一 进度表，确认 A0/A1/A2/A3/A4/A5（含各自子项）均为 `[x]`。
    - 任一未勾 → 缺口：`Plan 未完成（<未勾项>）→ 先运行 /erp-workflow:plan-start`。
 2. **当前在本地默认分支（main / master）**
@@ -59,7 +59,7 @@ allowed-tools: Read Glob Workflow Bash(pwd) Bash(git rev-parse *) Bash(git statu
  [coding-start] ⛔ 未满足进入 B 阶段的前置条件
    <逐条列出缺口，格式：[项] 缺口描述 → 回填/处理位置>
-   例：[Plan 进度] A6 前端 scope 未勾 → 先运行 /erp-workflow:plan-start
+   例：[Plan 进度] A5 下游文档生成 未勾 → 先运行 /erp-workflow:plan-start
  处理后重新运行 /erp-workflow:coding-start。
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -109,7 +109,7 @@ Workflow({
 ## 参考
-- `docs/08-模块任务管理.md § 一`（A0~A6 Plan 进度，步骤 2 读取）
+- `docs/08-模块任务管理.md § 一`（A0~A5 Plan 进度，步骤 2 读取）
 - `docs/08-模块任务管理.md § 二`（后端模块元数据 + 里程碑字段，步骤 3 读取）
 - `docs/08-模块任务管理.md § 三`（前端阶段整体里程碑，步骤 3 读取）
 - `workflows/coding.mjs`（B 阶段编排脚本，步骤 4 启动）
 ---
 name: downstream-gen
-description: A5 下游文档生成——基于 docs/01 和 docs/03 推导，一次性生成 docs/02 + docs/05 + docs/06 § 三 + docs/10，回填 REQ 卡片依赖接口，把模块清单追加到 docs/08 § 二。
+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 已并入此处）。
 user-invocable: false
 allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion
 ---
@@ -37,11 +37,17 @@ allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion
 勾选：`  - [ ] REQ 卡片依赖接口已回填`
-### C. docs/06 — 页面清单
+### C. FE 清单 — 推导前端功能写入 docs/08 § 三
-对每个有前端页面的模块：读取并填充 `${CLAUDE_SKILL_DIR}/templates/docs-06-module-pagelist-template.md`，追加到 `docs/06-UI交互规范.md` § 三。
+前端布局 / 页面 / 交互的权威是项目根 `prototype/`（完整前端 demo，含全部页面与布局）。本步**只**把「有哪些前端功能（FE-NN）」推导出来，供 Coding 阶段 `coding.mjs` 的 Router 聚合 `frontend-phase`——不另写 UI 规范文档。
-勾选：`  - [ ] docs/06 § 三 页面清单已填入`
+1. 用 `Glob` 检查 `prototype/**/*.html`：
+   - **0 个** → Plan 期可问：用 `AskUserQuestion` 告知「未在 prototype/ 找到 .html 原型，前端以 prototype/ 为权威」，给「我已补齐原型，请重新检查」/「本项目无前端」。选「无前端」→ docs/08 § 三「功能:」留空（Router 不产生 frontend-phase），跳过 2/3；选「已补齐」→ 重新 `Glob`。
+   - **≥1 个** → 继续。
+2. 综合 `prototype/*.html` + docs/01 REQ 卡片 + docs/05 端点，按业务功能粒度推导 FE 清单（一个 `FE-NN` 可关联多个 prototype 区域 / 多个 REQ）。
+3. 用 `Edit` 把 FE-NN 行写入 `docs/08-模块任务管理.md § 三` 的「功能:」项下，一行一个：`  - [ ] FE-NN <功能名>`（coding.mjs Router 据此聚合前端阶段）。
+
+勾选：`  - [ ] FE 清单已推导填入 docs/08 § 三`
 ### D. docs/08 — 追加模块清单
@@ -72,9 +78,9 @@ allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion
 4. 打印 A5 完成横幅并**停下**：
    ```
-   [downstream-gen] ✅ A5 下游文档生成完成（A0~A5）
-   产出：docs/02 / docs/05 / docs/06 § 三 / docs/08 § 二 / docs/10；docs/08 § 一 A0~A5 已全勾。
-   ⏭️ 下一步：运行 /erp-workflow:plan-start
+   [downstream-gen] ✅ A5 下游文档生成完成（Plan A0~A5 全部完成）
+   产出：docs/02 / docs/05 / docs/10 / docs/08 § 二 模块清单 / docs/08 § 三 FE 清单；docs/08 § 一 A0~A5 已全勾。
+   ⏭️ 下一步：运行 /erp-workflow:plan-start 进入终结闸
    ```
 ## 参考
@@ -82,6 +88,6 @@ allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion
 - `${CLAUDE_SKILL_DIR}/templates/docs-02-template.md`
 - `${CLAUDE_SKILL_DIR}/templates/docs-05-header-template.md`
 - `${CLAUDE_SKILL_DIR}/templates/docs-05-endpoint-template.md`
-- `${CLAUDE_SKILL_DIR}/templates/docs-06-module-pagelist-template.md`（追加到 docs/06 § 三）
+- `prototype/**/*.html`（前端页面/布局/交互权威；C 段据此推导 FE 清单）
 - `${CLAUDE_SKILL_DIR}/templates/docs-08-module-row-template.md`（模块 bullet 行模板）
 - `${CLAUDE_SKILL_DIR}/templates/docs-10-header-template.md`
-### {{module_id}} {{module_name}}
-
-{{#each pages}}
-- **{{page_name}}** (`{{route}}`)
-  - 类型: {{page_type}}  （列表页 / 表单页 / 详情页 / 树形管理页）
-  - 对应 REQ: {{req_ids}}
-  - 入口菜单: {{menu_path}}
-  - 主要交互: {{interactions}}
-{{/each}}
----
-name: frontend-scope-lock
-description: A6 前端范围锁定（Plan 期）——检查项目根 prototype/*.html，从 prototype + docs/01 REQ 卡片 + docs/05/06 提炼项目级 UI 约定、Design Tokens、组件库选型，逐项 AskUserQuestion 确认后写入 docs/06（UI 交互规范）+ docs/04（前端栈），并为每个 FE-NN 锁定设计决策表。把全部前端歧义前移到 Plan 期问清，使 Coding 阶段前端循环无需再弹窗。
-user-invocable: false
-allowed-tools: Read Write Edit Glob Grep Skill AskUserQuestion
----
-
-**所有输出必须使用中文。**
-
-# frontend-scope-lock
-
-## 执行步骤
-
-> **关于 AskUserQuestion**：下文只描述「问什么、给哪些选项、各选项导向什么后续」。`header` / 各选项的 `description` / `multiSelect` 等具体参数由你按工具 schema 自行填全合法值——不要把下文的选项文字当成完整调用照抄。
-
-### 步骤 1：检查 prototype（缺失则在此问）
-
-用 `Glob` 检查项目根 `prototype/**/*.html`：
-
-- **至少 1 个 `.html`** → 通过，记下文件清单，进入步骤 2。
-- **0 个** → 这是 Plan 期，**可以问**。用 `AskUserQuestion` 告知用户「未在 prototype/ 找到任何 .html 原型，前端范围锁定依赖原型作为页面骨架权威」，给「我已补齐原型，请重新检查」和「本项目无前端，跳过 A6」两个选项。
-  - 选「已补齐」→ 重新 `Glob`：命中则进入步骤 2，仍为 0 则重复本问。
-  - 选「无前端」→ 在 docs/08 § 一 同时勾父项 + 3 子项（否则下次 plan-start 会重派），父项行尾注「（无前端，A6 跳过）」，打印步骤 6 横幅（产出标注「跳过」）并**停止**，不写 docs/06 / docs/04。3 子项：
-    - `  - [x] docs/06 项目级 UI 约定 + Design Tokens + 组件库已锁定（无前端跳过）`
-    - `  - [x] docs/04 § 二 前端栈已锁定（引用 docs/06）（无前端跳过）`
-    - `  - [x] 各 FE-NN 设计决策表已生成（docs/06 § 三之后 / docs/08 § 三）（无前端跳过）`
-
-### 步骤 2：收集证据（只读，不问）
-
-为提炼项目级约定，`Read` 以下来源：
-
-- **prototype/**：所有 `*.html`，作为页面布局 / 组件 / 交互的**实测权威**（DOM 结构、表单展现、列表范式、状态色实例）。
-- **docs/01-需求清单/**：各 `_module.md` + `REQ-*.md`，提取 UI 描述、业务校验、acceptance 中与界面相关的部分。
-- **docs/05-API接口契约.md**：端点列表，确认前端要消费的接口集合（影响页面状态机 / 加载态）。
-- **docs/06-UI交互规范.md**：已有的通用交互规则（§ 一）、Design Tokens（§ 二）、页面清单（§ 三 由 A5 填）。布局以项目根 `prototype/` 为权威，docs/06 不设独立布局小节。本 skill 在此基础上**收敛 / 补全**，不推翻已确认内容。
-- **docs/04-技术规范.md § 零**：技术栈表里的前端行（如 `前端 UI 组件` = Ant Design），作为组件库选型默认值来源。
-
-把证据归纳为三组**草案**：(a) 项目级 UI 约定、(b) Design Tokens（全局调色板 + 组件级状态色）、(c) 组件库选型。草案优先复用 docs/06 / docs/04 既有值（已锁定的不重问），仅对 prototype 与现文档**不一致**或**缺失**的点进入步骤 3 确认。
-
-### 步骤 3：逐项 AskUserQuestion 确认
-
-**一次一问**，仅对真歧义点。每问给出「从证据提炼的默认值」让用户**确认 / 覆盖**，不造无意义确认题。建议覆盖（无歧义的项直接采用默认值，不弹问）：
-
-1. **UI 约定**：整体布局骨架、最小视口 / 响应式策略、列表页范式、表单展现阈值（Modal / Drawer / 独立页）、操作反馈范式、数据展示约定、前端权限控制方式。
-2. **Design Tokens**：全局调色板语义→变量→默认值；组件级状态色表（编辑 / 只读 / 悬浮 的 bg/fg）。prototype 中出现但未登记的色值 → 问是否新增 token。
-3. **组件库选型**：UI 组件库 + 版本（默认取 docs/04 § 零）、主题接入方式、图标库、表格 / 表单是否二次封装。
-
-每个确认结果即时记入对应草案。**绝不**留 `【人工填写：】` / `{{占位}}` / `TBD` 作为最终值。
-
-### 步骤 4：写入 docs/06 + docs/04
-
-用 `${CLAUDE_SKILL_DIR}/templates/fe-scope-template.md` 作为填充骨架，把步骤 3 确认后的真实值填入（剥掉模板内 HTML 注释），分别落盘：
-
-- **docs/06-UI交互规范.md**（用 `Edit` 合并，不另起文件；小节编号以 `skeleton-gen/templates/docs-06-static-template.md` 为权威：§ 一 通用交互规则 / § 二 Design Tokens / § 三 页面清单）：
-  - 模板 § 一 → 收敛 / 补全 docs/06 § 一（通用交互规则）的项目级约定。
-  - 模板 § 二 → 写入 / 校正 docs/06 § 二（Design Tokens 全局调色板 + 组件级状态色 + Token 默认值），与 `src/styles/tokens.css` 命名规范（docs/04 § 2.5）一致。
-  - 模板 § 五 → 追加到 docs/06 § 三（页面清单）之后，作为 **FE 级设计决策表**：FE 清单来自 docs/08 § 三（若 § 三 尚无 FE bullet，则在此按 prototype + docs/01 + docs/05 推导 FE 清单并**同时写入 docs/08 § 三**「功能:」项，行格式见 docs/08 模板）。一 FE 一行。
-- **docs/04-技术规范.md § 二（前端编码规范）**（用 `Edit`）：
-  - 把组件库选型 + 模板 § 四前端栈摘要写入 / 校正 § 2.3（组件 / 页面编写规范）与 § 2.5（样式与主题）的引用说明；色值约定指向 docs/06 § 二。
-  - 不重复抄 docs/06 全文，只写「前端组件库 = X、tokens 锁定于 docs/06 § 二」这类引用，保持 SSoT。
-
-写入时遵循模板的字面安全约定：值含 `$` / `{` / `}` 等字符**原样写入**，不做二次解释。
-
-### 步骤 5：自审（inline 修，不等用户）
-
-- 模板五节均已填充，**无** `{{...}}` / `【人工填写：】` / `TBD` 残留（`Grep` 校验 docs/06 + docs/04 本次写入区域）。
-- 组件库选型与 docs/04 § 零前端行一致；如确认值覆盖了 § 零默认值，回写 § 零保持一致。
-- docs/06 § 五 / docs/08 § 三 的 FE-NN 集合一致，每个 FE 行字段非空。
-- 命中残留 → 就地修正后重新校验；无法自决的歧义 → 回步骤 3 补问。
-
-### 步骤 6：勾选 docs/08 + 终止横幅
-
-1. 用 `Edit` 在 `docs/08-模块任务管理.md § 一` 勾选 A6 子项 + 父项：
-   - `  - [ ] docs/06 项目级 UI 约定 + Design Tokens + 组件库已锁定`
-   - `  - [ ] docs/04 § 二 前端栈已锁定（引用 docs/06）`
-   - `  - [ ] 各 FE-NN 设计决策表已生成（docs/06 § 三之后 / docs/08 § 三）`
-   - `- [ ] A6 前端范围锁定 — frontend-scope-lock`
-2. 向用户**直接输出**终止横幅并**停止**：
-
-```
-[frontend-scope-lock] ✅ A6 前端范围锁定完成
-产出：docs/06 § 一/二 + § 三之后各 FE-NN 决策表；docs/04 § 二 前端栈（引用 docs/06）。
-Plan 阶段（A0~A6）到此结束。请运行 /erp-workflow:plan-start 进入终结闸。
-```
-
-## 参考
-
-- `${CLAUDE_SKILL_DIR}/templates/fe-scope-template.md`（产出骨架）
-- `prototype/**/*.html`（页面骨架实测权威，步骤 1 前置门由本 skill 自承）
-- `docs/01-需求清单/**/*.md`（UI 描述 / 业务校验来源）
-- `docs/05-API接口契约.md`（前端消费端点）
-- `docs/06-UI交互规范.md`（写入目标：§ 一 通用交互约定、§ 二 Tokens、§ 三之后 FE 决策表）
-- `docs/04-技术规范.md § 二 / § 零`（前端栈 + 组件库选型写入目标）
-- `docs/08-模块任务管理.md § 一`（A6 进度勾选）/ `§ 三`（FE 清单）
-- 上游：`plan-start`（A5 完成后派发到此）
-- 下游：`plan-start` 终结闸（A6 完成后回交校验）；Coding 阶段 `workflows/coding.mjs` 前端循环消费本 skill 的产出
-## 一、项目级 UI 约定
-
-> 来源：prototype/*.html 实测 + docs/01 REQ 卡片 UI 描述 + docs/06 已有布局。经用户确认。
-
-| 约定项 | 锁定值 | 依据 |
-| --- | --- | --- |
-| 整体布局骨架 | {{LAYOUT_SKELETON}} | {{LAYOUT_SOURCE}} |
-| 最小支持视口 / 响应式策略 | {{VIEWPORT_POLICY}} | {{VIEWPORT_SOURCE}} |
-| 列表页交互范式 | {{LIST_PATTERN}} | {{LIST_SOURCE}} |
-| 表单展现规则（Modal / Drawer / 独立页阈值） | {{FORM_PATTERN}} | {{FORM_SOURCE}} |
-| 操作反馈范式（成功 / 失败 / 二次确认） | {{FEEDBACK_PATTERN}} | {{FEEDBACK_SOURCE}} |
-| 数据展示约定（状态 / 日期 / 金额 / 空值 / 操作列） | {{DISPLAY_PATTERN}} | {{DISPLAY_SOURCE}} |
-| 前端权限控制方式 | {{AUTH_PATTERN}} | {{AUTH_SOURCE}} |
-
-## 二、Design Tokens
-
-> 单元格写 token 名（`--color-xxx`），不写裸 hex；色值默认值落地于 `src/styles/tokens.css`。命名规范见 docs/04 § 2.5。
-
-### 2.1 全局调色板
-
-| 语义 | 变量名 | 默认值 | 用途 |
-| --- | --- | --- | --- |
-| {{TOKEN_SEMANTIC}} | {{TOKEN_VAR}} | {{TOKEN_VALUE}} | {{TOKEN_USAGE}} |
-
-### 2.2 组件级状态色
-
-| 序号 | 组件 | 编辑 bg | 只读 bg | 悬浮 bg | 编辑 fg | 只读 fg | 悬浮 fg | 备注 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| {{COMP_NO}} | {{COMP_NAME}} | {{COMP_BG_EDIT}} | {{COMP_BG_READONLY}} | {{COMP_BG_HOVER}} | {{COMP_FG_EDIT}} | {{COMP_FG_READONLY}} | {{COMP_FG_HOVER}} | {{COMP_NOTE}} |
-
-## 三、组件库选型
-
-| 项 | 锁定值 | 依据 / 备注 |
-| --- | --- | --- |
-| 前端 UI 组件库 | {{UI_LIB}} | {{UI_LIB_SOURCE}} |
-| 版本 | {{UI_LIB_VERSION}} | 与 docs/04 § 零 一致 |
-| 主题接入方式 | {{UI_LIB_THEME}} | 如 ConfigProvider.theme.token 引用 § 二全局调色板 |
-| 图标库 | {{ICON_LIB}} | {{ICON_LIB_SOURCE}} |
-| 表格 / 表单封装策略 | {{WRAP_STRATEGY}} | 是否二次封装、统一 props 约定 |
-
-## 四、前端栈摘要（同步 docs/04 § 二）
-
-| 分层 | 技术 | 版本 | 说明 |
-| --- | --- | --- | --- |
-| {{FE_LAYER}} | {{FE_TECH}} | {{FE_VERSION}} | {{FE_NOTE}} |
-
-## 五、各 FE 设计决策表
-
-> 一 FE 一行，FE 清单来自 docs/08 § 三。每行锁定该 FE 的页面骨架来源、页面类型、组件库选型与状态机要点，供 Coding 阶段前端循环直接消费（不再二次问人）。
-
-| FE-NN | 功能名 | 关联 REQ | 关联原型 | 页面类型 | 核心组件树要点 | 关键状态机（loading/empty/error/正常/提交中） | 引用 Design Tokens |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| {{FE_ID}} | {{FE_NAME}} | {{FE_REQS}} | {{FE_PROTOTYPES}} | {{FE_PAGE_TYPE}} | {{FE_COMPONENT_TREE}} | {{FE_STATE_MACHINE}} | {{FE_TOKENS}} |
@@ -17,9 +17,9 @@ allowed-tools: Skill Read Glob Grep
 2. **根据 § 一 找到当前进度**
-   **判定算法（务必按此执行，不要凭"表里含 Axx"判断；docs/08 § 一 模板始终列出 A0~A6 全部行，"含"恒为真）**：
+   **判定算法（务必按此执行，不要凭"表里含 Axx"判断；docs/08 § 一 模板始终列出 A0~A5 全部行，"含"恒为真）**：
    - 用 Read / Grep 把 `docs/08-模块任务管理.md § 一` 全文读出，按文件顺序自上而下扫描，找到**第一个 `- [ ]` 未勾子项**（仅扫 § 一）。
-   - 该子项归属的父项 `Axx`（A0~A6）即为当前阶段，按下表派发到对应 skill。
+   - 该子项归属的父项 `Axx`（A0~A5）即为当前阶段，按下表派发到对应 skill。
    - 若 § 一 所有 `[ ]` 都已变成 `[x]`（含父项与全部子项）→ 进入 §2.1 Plan 终结闸。
 | `第一个未勾子项归属` | `后续` | `阶段` |
@@ -31,14 +31,13 @@ allowed-tools: Skill Read Glob Grep
 | A3 父项或其任一子项 | `db-design-gen` | `A3` |
 | A4 父项或其任一子项 | `db-init` | `A4` |
 | A5 父项或其任一子项 | `downstream-gen` | `A5` |
-| A6 父项或其任一子项 | `frontend-scope-lock` | `A6` |
 | § 一 全部 `[x]` | **无分发** → §2.1 Plan 终结闸 | - |
 ## 第二步：分发通知 + 调用目标 skill
 ### 2.1 Plan 已完成 — 终结硬闸（HARD GATE）
-A 阶段 checkbox 全部 `[x]` 后先跑下面 5 项前移闸门; 全过才放行, 任一未过则拦截.
+A 阶段 checkbox 全部 `[x]` 后先跑下面 4 项前移闸门; 全过才放行, 任一未过则拦截.
 #### 第 1 步：逐项校验前移闸门（用 Read / Glob / Grep，禁止跳过任何一项）
@@ -46,12 +45,11 @@ A 阶段 checkbox 全部 `[x]` 后先跑下面 5 项前移闸门; 全过才放
 1. **REQ 卡片真实数据**（来自 A1 scope-lock）
    - `Glob` 找出全部 REQ 卡片（如 `docs/01-需求清单/**/*.md`）。
-   - 对每张卡片 `Grep` 命中以下任一即缺口: `【人工填写` / `TBD` / `待补` / `<示例` / `【示例行` (与 scope-lock E.1 同集合).
-   - 缺口表述示例：`REQ-USER-001 仍含 TBD / 示例值未替换为真实约束 / 示例行未删除`。
+   - 对每张卡片 `Grep` 命中以下任一即缺口: `【人工填写` / `TBD` / `待补` / `{{`（6 个标量占位未替换） (与 scope-lock E.1 同集合).
+   - 缺口表述示例：`REQ-USER-001 仍含 TBD / {{title}} 占位未替换`。
-2. **secrets / 项目配置全锁**（来自 A1 收集的 secret/account/package-name/namespace 清单）
-   - `Read` `.env.local`（真实 secret 值所在；gitignored，docs/07 只记规则不记值）：校验 `config-vars.yaml` 的 `secrets_ref` 列出的每个 secret 键（如 `DB_PASSWORD` / `JWT_SECRET`）均有真实值，无 `【人工填写`/`TBD`/空值。
-   - `Read` `config-vars.yaml`（非敏感项目级配置）：校验包名 / namespace / 端口 / 初始账号等字段均已填，无 `【人工填写`/`TBD`。
+2. **全部配置全锁**（来自 A1 写入 `config-vars.yaml` 的非敏感配置 + 敏感凭据，单一文件）
+   - `Read` `config-vars.yaml`（项目全部配置，含敏感凭据，随项目提交）：校验所有字段均有真实值，无 `【人工填写`/`TBD`/空值——含非敏感项（`backend`/`frontend` 包名 / 端口、`admin_init.username`、`database.host/port/user/schema`）与敏感项（`database.password`、`admin_init.password`、`secrets.*`）。
    - 任一未填即缺口。（docs/07-环境配置.md 仅承载规则/约定，不参与值校验。）
 3. **docs/04 §零 命令齐**（来自 A1 收集的每栈构建/lint/单测/e2e 命令）
@@ -62,13 +60,11 @@ A 阶段 checkbox 全部 `[x]` 后先跑下面 5 项前移闸门; 全过才放
    - `Read` `docs/05-API接口契约.md` 与 `docs/02-开发计划.md`。
    - 校验：(a) docs/05 每个端点都有请求/响应 schema、无 `【人工填写`/`TBD`；(b) docs/02 每个 REQ 都在构建顺序 DAG 中、cycle-breaking 顺序有 `note` 说明。缺任一即缺口。
-5. **A6 前端 scope 已锁**（来自 A6 frontend-scope-lock）
-   - 若 A6 父项行尾含「无前端, A6 跳过」标注 → 本项直接通过, 不再读 docs/06.
-   - 否则（有前端）：`Read` `docs/06-UI交互规范.md`，校验项目级 UI 约定 / Design Tokens / 组件库选型已确认；每个 FE-NN 的设计决策表非占位；prototype 闸门已过（docs/08 § 一 A6 勾选即代表此项已由 A6 skill 锁定，但仍核对 docs/06 无 `【人工填写`/`TBD` 残留）。缺任一即缺口。
+（前端无独立 Plan 文档闸：布局/交互以项目根 `prototype/` 为权威，FE 清单由 A5 写入 docs/08 § 三，Coding 阶段前端循环直接消费 prototype/ + tokens.css + docs/04。）
 #### 第 2 步（A）：全部通过 → 放行
-仅当第 1 步 **5 项全部 `通过`** 时，向用户输出完成横幅：
+仅当第 1 步 **4 项全部 `通过`** 时，向用户输出完成横幅：
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -76,10 +72,9 @@ A 阶段 checkbox 全部 `[x]` 后先跑下面 5 项前移闸门; 全过才放
  已校验通过：
    ✓ REQ 卡片均为真实数据（无占位/示例残留）
-   ✓ .env.local secrets + config-vars.yaml（account/package/namespace）全锁
+   ✓ config-vars.yaml 全部配置（含 DB 凭据 / 密钥 / 包名 / 端口 / 初始账号）全锁
    ✓ docs/04 §零 各栈 build/lint/unit/e2e 命令齐全
    ✓ docs/05 API 契约 + docs/02 构建顺序已评审
-   ✓ A6 前端 scope（UI 约定 / tokens / 组件库）已锁
  运行 /erp-workflow:coding-start 进入 B 阶段 (coding-start 会校验 git 状态).
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -100,8 +95,8 @@ A 阶段 checkbox 全部 `[x]` 后先跑下面 5 项前移闸门; 全过才放
    <逐条列出每个缺口，格式：[闸门] 缺口描述 → 回填位置>
    例：
-   [REQ 真实数据] REQ-USER-001 输入字段「示例值」列仍为模板占位 → docs/01-需求清单/...
-   [secrets] DB_PASSWORD 未填 → .env.local
+   [REQ 真实数据] REQ-USER-001 仍含 {{goal}} 占位未替换 → docs/01-需求清单/...
+   [配置] database.password 未填 → config-vars.yaml
    [docs/04 §零] node 栈缺 e2e 命令 → docs/04-技术规范.md §零
  补齐后再次运行 /erp-workflow:plan-start 重新校验。
 # 08-工作流进度
 > 全流程进度跟踪。CC 每完成一项产出就勾选一项。
-> - **§ 一 Plan（A0~A6）**：`plan-start` 找第一个未勾 A 子项分发到对应 skill
-> - **§ 二 Coding（模块）**：分发以 `docs/02-开发计划.md § 二 开发顺序清单` 为准；`coding.mjs` Router 按 docs/02 顺序扫描，对每个 REQ 所属模块查询本 § 二的 `里程碑:` 字段 + 本地 `git tag -l 'milestone/<id>'` 判定模块完成，并用 `git tag -l 'req-done/<REQ-or-FE>'` 判定功能级跳过。本 § 二 行序无语义，仅作模块元数据表
 ## 一、Plan 阶段（一次性）
@@ -18,8 +16,8 @@
   - [ ] REQ 卡片骨架已生成（docs/01-需求清单/<module>/REQ-*.md，业务内容留待人工填写）
 - [ ] A2 骨架生成 — skeleton-gen
-  - [ ] 架构文档已生成（docs/04 § 一+、docs/06、docs/07、docs/09）
-  - [ ] 工具脚本已生成（scripts/*.mjs、.env.local）
+  - [ ] 架构文档已生成（docs/04 § 一+、docs/07、docs/09）
+  - [ ] 工具脚本已生成（scripts/*.mjs）
   - [ ] 样式 token 骨架已生成（src/styles/tokens.css）
   - [ ] .gitignore 已配置
@@ -30,22 +28,17 @@
 - [ ] A4 DB 初始化 — db-init
   - [ ] sql/migrations/V1__initial_schema.sql 已生成
   - [ ] DDL 与 docs/03 全量一致
-  - [ ] .env.local 凭据已验证（mysql -e "SELECT 1" OK）
-  - [ ] setup-test-db.mjs 防护通过 + DROP+CREATE + apply V1 已执行
+  - [ ] config-vars.yaml DB 凭据已验证（mysql -e "SELECT 1" OK）
+  - [ ] setup-test-db.mjs DROP+CREATE + apply V1 已执行
   - [ ] DDL ↔ docs/03 apply 后 5 维一致（validate-ddl.mjs）
 - [ ] A5 下游文档生成 — downstream-gen
   - [ ] docs/02 开发计划已生成
   - [ ] docs/05 API 契约已生成
-  - [ ] docs/06 § 三 页面清单已填入
   - [ ] docs/10 验收清单已生成
   - [ ] 下方模块列表已填入
   - [ ] REQ 卡片依赖接口已回填
-
-- [ ] A6 前端范围锁定 — frontend-scope-lock
-  - [ ] docs/06 项目级 UI 约定 + Design Tokens + 组件库已锁定
-  - [ ] docs/04 § 二 前端栈已锁定（引用 docs/06）
-  - [ ] 各 FE-NN 设计决策表已生成（docs/06 § 三之后 / docs/08 § 三）
+  - [ ] FE 清单已推导填入 docs/08 § 三
 ## 二、Coding 阶段（后端模块循环）
@@ -53,7 +46,7 @@
 ## 三、Coding 阶段（前端整体）
-（FE 业务功能清单在 Plan 期 A6 `frontend-scope-lock` 由 prototype/ + docs/01 + docs/05 推导后写入下方"功能:"项；Coding 阶段 `coding.mjs` 的 Router 把缺少 `req-done/<FE-NN>` tag 的 FE 聚合为单一 `frontend-phase` 阶段，排在所有后端模块之后。整个前端阶段 1 个里程碑 tag，分支 `frontend-phase`。）
+（FE 业务功能清单在 Plan 期 A5 `downstream-gen` 由 prototype/ + docs/01 + docs/05 推导后写入下方"功能:"项；Coding 阶段 `coding.mjs` 的 Router 把缺少 `req-done/<FE-NN>` tag 的 FE 聚合为单一 `frontend-phase` 阶段，排在所有后端模块之后。整个前端阶段 1 个里程碑 tag，分支 `frontend-phase`。无前端则此处留空，Router 不产生前端阶段。）
 - 整体里程碑: —
 - 功能:
 ---
 name: skeleton-gen
-description: A2 骨架生成——基于 docs/04 § 零 技术栈 + docs/01-需求清单/index.md 模块索引，生成项目专属的架构文档（docs/04 § 一+、docs/06、docs/07、docs/09）和工具脚本（.mjs，跨平台）。固定工具文件用 Read/Write 落盘，架构文档由 LLM 按大纲生成。
+description: A2 骨架生成——基于 docs/04 § 零 技术栈 + docs/01-需求清单/index.md 模块索引，生成项目专属的架构文档（docs/04 § 一+、docs/07、docs/09）和工具脚本（.mjs，跨平台）。固定工具文件用 Read/Write 落盘，架构文档由 LLM 按大纲生成。
 user-invocable: false
 allowed-tools: Read Write Edit Skill Grep Glob AskUserQuestion Bash(node *)
 ---
@@ -18,7 +18,7 @@ allowed-tools: Read Write Edit Skill Grep Glob AskUserQuestion Bash(node *)
 后续所有内容都基于它们推导。
-### B.1 生成 3 个全新架构文档（docs/06 / 07 / 09）
+### B.1 生成 2 个全新架构文档（docs/07 / 09）
 对下表每个目标文件：
 1. 读取对应的大纲模板
@@ -28,10 +28,11 @@ allowed-tools: Read Write Edit Skill Grep Glob AskUserQuestion Bash(node *)
 | 目标文件 | 大纲模板 |
 |---|---|
-| `docs/06-UI交互规范.md`（§ 一 ~ 三；FE 决策表由 A6 frontend-scope-lock 追加到 § 三之后） | `${CLAUDE_SKILL_DIR}/templates/docs-06-static-template.md` |
 | `docs/07-环境配置.md` | `${CLAUDE_SKILL_DIR}/templates/docs-07-env-template.md` |
 | `docs/09-项目目录结构.md` | `${CLAUDE_SKILL_DIR}/templates/docs-09-structure-template.md` |
+> 前端 UI/交互/布局不再单独出文档：项目根 `prototype/` 是完整前端 demo（页面 + 布局 + 交互的权威）；Design Tokens 在 `src/styles/tokens.css`；前端编码规范在 docs/04 § 二。
+
 项目专属标识（根包名 / 命名空间）保留 `【人工填写：<说明>】` 占位，等人工在 docs/09 顶部补填一次后，其他文件复用。
 ### B.2 追加 docs/04 § 一+（保留 § 零 不覆盖）
@@ -44,7 +45,7 @@ docs/04 已由 scope-lock 写入 § 零。本步骤追加 § 一 ~ 三。
 4. 拼接原有内容和新生成内容，写回 `docs/04-技术规范.md`。
 完成后，用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选：
-- `  - [ ] 架构文档已生成（docs/04 § 一+、docs/06、docs/07、docs/09）`
+- `  - [ ] 架构文档已生成（docs/04 § 一+、docs/07、docs/09）`
 ### C. 生成工具脚本
@@ -54,12 +55,11 @@ docs/04 已由 scope-lock 写入 § 零。本步骤追加 § 一 ~ 三。
 | 模板 | 目标路径 |
 |---|---|
-| `${CLAUDE_SKILL_DIR}/templates/env-local-template` | `.env.local` |
 | `${CLAUDE_SKILL_DIR}/templates/scripts-setup-test-db-template.mjs` | `scripts/setup-test-db.mjs` |
 | `${CLAUDE_SKILL_DIR}/templates/styles-tokens-template.css` | `src/styles/tokens.css` |
 | （空文件） | `sql/migrations/.gitkeep` |
-> **`.env.local` 须与 `config-vars.yaml` 的 `secrets_ref` 对齐**：写完 `.env.local` 后用 `Read` 读仓库根 `config-vars.yaml` 的 `secrets_ref` 列表，逐个核对键名。env-local-template 已含 `DB_*` / `JWT_SECRET`；`secrets_ref` 里其余项目专属键（如 `REDIS_PASSWORD` / `ADMIN_INIT_PASSWORD` / 第三方凭证）用 `Edit` 追加到 `.env.local`，值统一为 `【人工填写：<说明>】`。
+> 凭据 / 配置不在此生成：项目**全部配置**（含 DB 凭据 / 密钥）已由 A1 `scope-lock` 写入仓库根 `config-vars.yaml`；`scripts/setup-test-db.mjs` 运行时按 2 层 map 直接读它。
 #### C.2 渲染 scripts/test.mjs
@@ -72,7 +72,7 @@ docs/04 已由 scope-lock 写入 § 零。本步骤追加 § 一 ~ 三。
 > 占位是普通 shell 命令字符串，模板在运行期用 `spawnSync(cmd, { shell:true })` 跨平台执行（Windows 走 cmd.exe，*nix 走 /bin/sh），缺席 stack 由模板内的 `existsSync('backend')` / `existsSync('frontend')` 守卫跳过。
 完成后，用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选：
-- `  - [ ] 工具脚本已生成（scripts/*.mjs、.env.local）`
+- `  - [ ] 工具脚本已生成（scripts/*.mjs）`
 - `  - [ ] 样式 token 骨架已生成（src/styles/tokens.css）`
 ### D. 追加 .gitignore 忽略项
@@ -93,14 +93,13 @@ node &quot;${CLAUDE_PLUGIN_ROOT}/lib/merge-gitignore.mjs&quot; .gitignore &quot;${CLAUDE_SKILL_
 #### E.1 扫描 + 分组
 用 `Grep` 在以下路径扫 `【人工填写：`，记录命中（文件 / 行号 / 说明）：
-- `docs/04-技术规范.md` / `docs/06-UI交互规范.md` / `docs/07-环境配置.md` / `docs/09-项目目录结构.md`
-- `config-vars.yaml`（A1 留下的未推断字段，如包名 / 端口）
+- `docs/04-技术规范.md` / `docs/07-环境配置.md` / `docs/09-项目目录结构.md`
+- `config-vars.yaml`（A1 留下的未填字段）
 - `scripts/*.mjs` / `.gitignore`
-- `.env.local`
 分两组：
-- **敏感组**：`.env.local` 路径命中（凭据 / 密钥）。**不弹 QA**（凭据不进会话），E.3 提示用户自填。
-- **非敏感组**：其余文件。按说明文字聚合为「根占位」（相同说明 = 同一值，多处共用）或「派生占位」（说明表达派生关系，如"后端 java 根包路径"派生自"根包名"）。
+- **敏感组**：`config-vars.yaml` 中敏感字段命中（`database.password` / `admin_init.password` / `secrets.*` 等凭据 / 密钥）。**不弹 QA**（凭据不进会话），E.3 提示用户自填。
+- **非敏感组**：其余命中（含 config-vars.yaml 的非敏感字段）。按说明文字聚合为「根占位」（相同说明 = 同一值，多处共用）或「派生占位」（说明表达派生关系，如"后端 java 根包路径"派生自"根包名"）。
 无命中 → 跳 E.4。
@@ -111,7 +110,7 @@ node &quot;${CLAUDE_PLUGIN_ROOT}/lib/merge-gitignore.mjs&quot; .gitignore &quot;${CLAUDE_SKILL_
 #### E.3 敏感占位提示（不弹 QA）
-若敏感组非空：打印提示横幅，列出 `.env.local` 待填字段名 + 告诉用户"直接编辑文件，凭据不进会话"。
+若敏感组非空：打印提示横幅，列出 `config-vars.yaml` 待填的敏感字段名 + 告诉用户"直接编辑 config-vars.yaml 填真实值，凭据不进会话"。
 #### E.4 验证 + QA 闸门
@@ -121,7 +120,7 @@ node &quot;${CLAUDE_PLUGIN_ROOT}/lib/merge-gitignore.mjs&quot; .gitignore &quot;${CLAUDE_SKILL_
 每次弹 QA 前重扫；有残留则打印残留位置清单（文件:行号 — 说明）+ 再弹 QA。
-QA 横幅涵盖：产出文件清单（docs/04 / 06 / 07 / 09 + config-vars.yaml + scripts/*.mjs + .env.local + .gitignore）、占位状态（N=0 或待填清单）、「继续」/「有疑问先沟通」两选项。
+QA 横幅涵盖：产出文件清单（docs/04 / 07 / 09 + scripts/*.mjs + .gitignore；config-vars.yaml 由 A1 产出，此处仅扫其待填项）、占位状态（N=0 或待填清单）、「继续」/「有疑问先沟通」两选项。
 通过后（N=0 且用户选「继续」），用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选：
 - `- [ ] A2 骨架生成 — skeleton-gen`
@@ -135,13 +134,11 @@ QA 横幅涵盖：产出文件清单（docs/04 / 06 / 07 / 09 + config-vars.yaml
 - `docs/04-技术规范.md` § 零
 - `docs/01-需求清单/index.md`
 - `${CLAUDE_SKILL_DIR}/templates/docs-04-skeleton-template.md`
-- `${CLAUDE_SKILL_DIR}/templates/docs-06-static-template.md`
 - `${CLAUDE_SKILL_DIR}/templates/docs-07-env-template.md`
 - `${CLAUDE_SKILL_DIR}/templates/docs-09-structure-template.md`
 - `${CLAUDE_SKILL_DIR}/templates/scripts-test-template.mjs`
 - `${CLAUDE_SKILL_DIR}/templates/scripts-setup-test-db-template.mjs`
-- `${CLAUDE_SKILL_DIR}/templates/env-local-template`
-- `config-vars.yaml`
+- `config-vars.yaml`（A1 产出，含 DB 凭据；setup-test-db.mjs 运行时读取）
 - `${CLAUDE_SKILL_DIR}/templates/gitignore-append-template`
 - `${CLAUDE_SKILL_DIR}/templates/styles-tokens-template.css`
 - `${CLAUDE_PLUGIN_ROOT}/lib/merge-gitignore.mjs`
-# 06-UI交互规范
-
-> 本项目所有页面布局以项目根 `prototype/` 目录下的静态 HTML mockup 为权威。前端阶段实现时直接以 prototype/ HTML 推导组件树与样式。本文件仅承载跨页面通用规则与 Design Tokens。
-
-## 一、通用交互规则
-
-### 1.1 操作反馈
-
-### 1.2 数据展示
-
-### 1.3 权限控制（前端）
-
-## 二、Design Tokens
-
-### 2.1 全局调色板
-
-### 2.2 组件级状态色
-
-### 2.3 引用约定
-
-## 三、页面清单
-（由 `downstream-gen` 按模块追加段落）
@@ -15,7 +15,6 @@ docs/
 ├── 03-数据库设计文档.md
 ├── 04-技术规范.md
 ├── 05-API接口契约.md
-├── 06-UI交互规范.md
 ├── 07-环境配置.md
 ├── 08-模块任务管理.md
 ├── 09-项目目录结构.md
@@ -133,7 +133,7 @@ function featureStageContract(phase) {
   return [
     '## 硬约束（非交互子代理）',
     '- 你是 Workflow 派生的**非交互子代理**，物理上无法弹出 AskUserQuestion / 等待人类输入。**绝不要尝试问人**。',
-    '- 缺值查找顺序：`.env.local` → `docs/07-环境配置.md` → `docs/04-技术规范.md` → `docs/05-API接口契约.md` → `docs/06-UI交互规范.md` → `CLAUDE.md` → 现有代码。',
+    '- 缺值查找顺序：`config-vars.yaml` → `docs/07-环境配置.md` → `docs/04-技术规范.md` → `docs/05-API接口契约.md` → `prototype/`（前端布局/交互权威）→ `src/styles/tokens.css`（前端色值）→ `CLAUDE.md` → 现有代码。',
     '- 仍查不到 → **不要编造、不要留 `【人工填写：】` / `TBD` / `TODO` 占位**；把具体阻塞点（缺哪个值、应在哪个 Plan 闸门锁定、为何无法继续）写进产物。',
     '- 然后让本步骤以非零结果 / 显式 throw 结束，由上层 Workflow 转为带诊断的 halt（fail-fast）。',
     '- 全部输出文档**使用中文**。',
@@ -198,7 +198,7 @@ function deriveSpecPrompt(id, phase) {
     featureStageContract(phase),
     '',
     '## 目标',
-    `静默派生 \`${id}\` 的实现规格（无 Q&A）。需求歧义本应在 Plan 期的结构化 per-REQ 表单 / 前端 scope-lock 锁定；这里**只消费已锁定的事实**，不再澄清。`,
+    `静默派生 \`${id}\` 的实现规格（无 Q&A）。需求歧义本应在 Plan 期的结构化 per-REQ 表单锁定，前端布局/交互以 \`${ROOT}/prototype/\` 为权威；这里**只消费已锁定的事实**，不再澄清。`,
     '',
     '## 收集上下文',
     fe
@@ -206,7 +206,7 @@ function deriveSpecPrompt(id, phase) {
           `- 关联 REQ 卡片：\`${ROOT}/docs/01-需求清单/<module>/<REQ>.md\`（提取业务校验规则、acceptance、UI 描述）。`,
           `- 关联 prototype：Read \`${ROOT}/prototype/**/*.html\`（含 anchor 时聚焦相应区域），作为页面布局权威。`,
           `- API 契约：\`${ROOT}/docs/05-API接口契约.md\`，按本 FE 关联的 REQ 过滤出消费的端点。`,
-          `- Design Tokens：\`${ROOT}/docs/06-UI交互规范.md § 二\`（色值 / 状态色引用源）。`,
+          `- Design Tokens：\`${ROOT}/src/styles/tokens.css\`（色值 / 状态色单一来源；只用 var(--color-*)，禁硬编码 hex）。`,
           `- 前端组件库：\`${ROOT}/docs/04-技术规范.md § 零\` 的 \`frontend.ui_lib\`，决定组件选型。`,
         ].join('\n')
       : [