@gordon.gan/specflow 1.8.0-beta → 1.8.2-beta

package/prompts/approval/api-guidance.md

@@ -1,179 +0,0 @@
-# Approval · API / RPC / OpenAPI Guidance
-
-> Used by `/specflow:approval` before drafting **§4.5 接口设计** (after
-> `project-conventions-guidance.md` `topic=api`).
->
-> **目的**:产出**可生成**的接口契约(非 narrative stub),并避免 **Worker 面 HTTP** 与 **平台内部 RPC**
-> 混写导致某一侧被省略。
->
-> **优先级**:项目约定 + 现网 proto/OpenAPI **>** 本路由 **>** LLM。
-
----
-
-## 0. When to run
-
-| 条件 | 必须执行 |
-|------|----------|
-| 本迭代有 **新增** HTTP 路径或 gRPC | 全文 §1–§4 |
-| 本迭代 **修改/行为扩展** 对外或 Worker 契约 | §1 分层 + §2 锁名 + §3 变更 delta |
-| 仅 **不变·本迭代消费** 既有 RPC/HTTP | §1 分层 + §4 完整骨架(字段/示例/错误);禁止一句带过 |
-| 三仓/多仓合订 | §1 **每层每面一个 `In`**,禁止用「内部调用」合并条目 |
-
-Announce after Read:
-
-```text
-API guidance: layering=<n surfaces> | proto=<path|draft in §4.5> | worker_openapi=<path|must draft>
-```
-
----
-
-## 1. 接口分层 — 禁止混层 (fixes B2)
-
-一条业务链路上常有 **多个契约面**,每一面在 §4.5 清单中必须是 **独立 `In`**,各自完整展开:
-
-| 层 | 典型调用方 → 被调方 | 协议形态 | 清单命名示例 | 常见错误 |
-|----|---------------------|----------|--------------|----------|
-| L1 控制台/北向 | Web → Gateway | HTTP `/api/v1/...` | I1 调试启动 | 把字段只写在 design,§4.5 无表 |
-| L2 Worker 边车 HTTP | Worker → Gateway | HTTP `/internal/v1/...` + work 鉴权头 | I4 逐步上报 | **只写路径,无 OpenAPI schema** |
-| L3 平台编排 RPC | Gateway/调度 → 本服务 logic | gRPC + `google.api.http` | I4 对应 RPC(与 L2 同编号或 I4a/I4b 成对) | 写「暂定 RPC,HTTP 冻结」—— **禁止** |
-| L4 平台东向 RPC | 调度 → result/testcase/… | gRPC `client/<svc>/` | I6/I7 确保壳/写入逐步 | **用一句「内部调用 I7」代替 I4 的 RPC 详设** |
-
-### 1.1 硬规则
-
-1. **L2 与 L3 成对**:新增 Worker HTTP 路径时,**必须**同时写清:
-   - L2:HTTP method/path、必填头、request/response JSON 字段表、失败示例
-   - L3:冻结 RPC 全名、`message` 字段号、`option (google.api.http)`、Gateway 注册点
-2. **L4 不得 stub**:列入清单的东向 RPC(即使 proto 已存在)仍须 **§4.5.2 完整骨架**;
-   可标注「与现网 proto 一致」但**必须**贴字段表 + 成功/失败示例 + 错误表。
-3. **禁止**在 L2 小节写满 HTTP,再在 L4 用「经 client/result 调 I7」一行替代 I7 详设。
-4. **调用关系图**须显式画出 L2→L3→L4,例如:
-   `Worker --L2 HTTP--> Gateway --L3 RPC--> Scheduler --L4 RPC--> Result`
-
-### 1.2 三仓合订
-
-| 仓 | 负责的层 | §4.5 须写 |
-|----|----------|-----------|
-| talos | L3/L4 + Gateway 注册 | proto 草案 + 注册文件/函数 |
-| talos-worker | L2 | OpenAPI path + schema + 鉴权头示例 |
-| talos-web | L1 | HTTP 消费 + TS 类型(§4.6 交叉引用 `In`) |
-
-合订文档 **禁止**只写 talos 侧 L4 而 Worker OpenAPI 写「apply 时补」。
-
----
-
-## 2. RPC / 服务名冻结 (fixes A1)
-
-### 2.1 禁止用语 (硬)
-
-下列写法 **一律禁止**出现在 §4.5 / §2 决策 / §4.8:
-
-- `暂定` / `TBD` / `实现时命名` / `实现时与 OpenAPI 对齐`
-- `如 SubmitXxx` / `例如 scheduler.SubmitXxx`
-- `RPC 名以实现为准`
-
-未锁名 → 视为 **BLOCKED**,不得标 READY;须 `[待 refine 澄清: RPC 名]` 或写入锁定名。
-
-### 2.2 必须输出
-
-| 项 | 格式 |
-|----|------|
-| 服务 | `package` 名,如 `scheduler` |
-| RPC | **冻结**全名,如 `scheduler.SubmitStepResult`(无「如」) |
-| HTTP | method + 完整 path(可含 `{job_id}`) |
-| proto 文件 | 相对路径,如 `proto/scheduler/scheduler.proto` |
-
-决策表新增行时使用 **Proposed → Accepted** 仅当 RPC 名已在 §4.5 冻结。
-
----
-
-## 3. 可生成契约包 (fixes A2)
-
-对 **新增** 或 **修改 HTTP 绑定** 的 RPC,§4.5 **必须**含 **「Proto / OpenAPI 契约包」** 块(可用 `**Proto 草案**` 加粗标签,非标题):
-
-### 3.1 Proto 最小集
-
-```protobuf
-// 文件: proto/<svc>/<svc>.proto
-rpc SubmitStepResult(SubmitStepResultReq) returns (SubmitStepResultResp) {
-  option (google.api.http) = {
-    post: "/internal/v1/tasks/{job_id}/step-results"
-    body: "*"
-  };
-}
-message SubmitStepResultReq {
-  int32 schema_version = 1;
-  string request_id = 2;
-  // … 每个字段必须有号与类型
-}
-message SubmitStepResultResp {
-  int32 schema_version = 1;
-  string request_id = 2;
-  bool accepted = 3;
-  bool replayed = 4;
-}
-```
-
-要求:
-
-- 每个字段 **字段号 + 类型 + json_name**(若与 snake 不同)
-- `google.api.http` **完整** post/get/path/body
-- enum/status **闭合**,禁止「等」;与现网 ingest 白名单对齐(例:逐步 ingest 仅四终态)
-
-### 3.2 Gateway 注册 (硬)
-
-必须写明 **其一**:
-
-- 「与 `ReportProgress` / `SubmitResult` **同一**注册点:`<文件路径>` 函数 `<Name>`」
-- 或「ProtoSets 清单 `<path>` 新增 `<proto>` 条目」
-
-禁止只写「网关 ProtoSet 含新绑定」。
-
-### 3.3 Worker OpenAPI 交叉引用
-
-- 路径必须在 `talos-worker/contracts/v1/http.openapi.yaml`(或项目约定路径)**给出 schema 草案**
-- 必填头须与现网 progress/result **同构列出**:
-  `Idempotency-Key`, `Authorization-date`, `Authorization: TALOS-WORK-1:...`, `Content-Type`, `Accept`
-- HTTP 请求示例 **必须含上述头**,不得只有 JSON body
-
-### 3.4 错误映射
-
-| 条件 | gRPC `codes.*` | HTTP | 禁止 |
-|------|----------------|------|------|
-| 租约无效 | `FailedPrecondition` 或项目约定 **唯一**值 | **唯一** 403 或 409 | `403/409(与 progress 同类)` |
-
----
-
-## 4. §4.5 逐接口最低深度 (含不变)
-
-每个 `In` **必须**含 generate.md §4.5.2 全部加粗块;额外:
-
-| 变更类型 | 额外要求 |
-|----------|----------|
-| 新增 L2+L3 | §3 契约包 + Gateway 注册 + Worker OpenAPI 指针 |
-| 修改 | 字段号/changelog + 兼容缺省 |
-| 不变·本迭代消费 | 从现网 proto/OpenAPI **摘录**字段表+示例;标注源路径;仍须失败示例 |
-| 不变·协议不变 | 同上;禁止「详见 OpenAPI」无正文 |
-
----
-
-## 5. 自检 (生成后必过)
-
-- [ ] 清单中每个契约面有独立 `In`,无 L2/L4 混写 stub
-- [ ] 无「暂定/如/实现时」RPC 措辞
-- [ ] 新增 RPC 有 proto 字段号 + http option + 注册点
-- [ ] Worker HTTP 示例含完整 work 鉴权头
-- [ ] status/enum 闭合,与 ingest/现网校验一致
-- [ ] 错误表无「或」「同类映射」模糊语
-- [ ] L4 东向 RPC 非一句话 stub
-
----
-
-## 6. 与 database / frontend guidance 对称
-
-| 包 | 路由 | 章节 |
-|----|------|------|
-| database | `database-guidance.md` | §4.4 |
-| frontend | `frontend-guidance.md` | §4.6 |
-| **api** | **本文件** | **§4.5** |
-
-`project-conventions-guidance.md` `topic=api` 解决「项目禁令与风格」;本文件解决「可生成契约与分层」。

package/prompts/approval/database-guidance.md

@@ -1,105 +0,0 @@
-# Approval · Database Guidance Router
-
-> **本地技能**: SpecFlow pack 在 `{ide}/specflow/guidance/database/`(见 `skills/guidance-packs.yaml`)。  
-> **项目约定**: 写 §4.4 **之前**还须执行 `prompts/approval/project-conventions-guidance.md`(`topic=database`)。  
-> **优先级**: 项目约定 + 现网 DDL **>** 本文件 SpecFlow guidance **>** LLM-fallback。  
-> **禁止**依赖远程 skill 仓库; **Not** an MCP tool; 禁止「invoke `/mysql` skill」。
-
----
-
-## 1. Detect project database stack
-
-Scan the **project under review** (change's repo root), not SpecFlow itself. Collect signals
-(non-recursive first; optional one-level into `docker-compose*.yml` / `migrations/`).
-
-| Signal | Suggested stack |
-|--------|-----------------|
-| `go.mod` / deps: `go-sql-driver/mysql`, `gorm.io` + mysql DSN, `ENGINE=InnoDB` in `*.sql` | `mysql` |
-| `package.json`: `mysql2`, `mysql`, `@prisma/client` + datasource mysql, drizzle mysql | `mysql` |
-| `pyproject` / requirements: `PyMySQL`, `mysqlclient`, `aiomysql` | `mysql` |
-| `go.mod`: `jackc/pgx`, `lib/pq`; `package.json`: `pg`, `postgres`; Prisma/drizzle postgres | `postgresql` |
-| `docker-compose`: image `postgres` / `mysql` / `mariadb` / `redis` / `elasticsearch` | matching image |
-| SQL files with `ENGINE=InnoDB` / `CHARSET=utf8mb4` | `mysql` |
-| SQL with `JSONB`, `SERIAL`, `gen_random_uuid()` | `postgresql` |
-| Oracle JDBC / `oracledb` / `go-ora` | `oracle` |
-| `ioredis` / `redis` client / `go-redis` | `redis` (cache/KV — usually **not** §4.4 relational DDL) |
-| `@elastic/elasticsearch` / OpenSearch client | `elasticsearch` (search — usually not relational DDL) |
-
-**Multi-hit**: pick primary OLTP store for §4.4 (prefer `mysql` / `postgresql` / `oracle` over
-`redis` / `elasticsearch`). Mention secondary stores in §4.7/架构 if relevant.
-
----
-
-## 2. Resolve guidance root (path priority)
-
-Before reading pack files, resolve `guidanceRoot` for stack `<stack>`:
-
-| Priority | Path | When |
-|----------|------|------|
-| 1 | `.cursor/specflow/guidance/database/<stack>/` | Cursor IDE assets present |
-| 1 | `.claude/specflow/guidance/database/<stack>/` | Claude IDE assets present |
-| 1 | `.agents/specflow/guidance/database/<stack>/` | Codex IDE assets present |
-| 2 | `skills/database/<stack>/` | SpecFlow package / self-repo fallback (relative to SpecFlow package root) |
-| 3 | *(missing)* | `LLM-fallback` |
-
-If multiple IDE roots exist, prefer the IDE the user is running in; otherwise the first existing path among cursor → claude → agents.
-
-**Announce** after detection + resolve:
-
-```text
-DB stack for approval: <mysql|postgresql|oracle|redis|elasticsearch|none>
-Guidance: <.cursor|claude|agents>/specflow/guidance/database/<stack>/SKILL.md
-         | skills/database/<stack>/SKILL.md | LLM-fallback
-```
-
----
-
-## 3. On hit — load **local** guidance (Read, do not invent, do not fetch)
-
-> 先完成 `project-conventions-guidance.md` 的 `topic=database` 解析并 Read 项目约定(若有)。  
-> 本表仅加载 **SpecFlow** guidance pack,用于补强 DDL 写法;不得覆盖项目禁令。
-
-Base = resolved `guidanceRoot` above. From that directory:
-
-| Stack | Must Read | Also Read when §4.4 needs it |
-|-------|-----------|------------------------------|
-| `mysql` | `SKILL.md` | `references/05-sql-ddl-types.md`, `references/06-index-optimization.md`; JSON → `references/04-functions-json.md` |
-| `postgresql` | `SKILL.md` | `references/06-index-types.md`; JSONB → `references/04-functions-jsonb.md` |
-| `oracle` | `SKILL.md` | `references/09-sql-syntax.md`, `references/10-features.md` |
-| `redis` | `SKILL.md` | Only if change is cache/key design — **not** a substitute for relational DDL |
-| `elasticsearch` | `SKILL.md` | Only if change is index/mapping — **not** a substitute for relational DDL |
-
-Point to files **from the router entry** (no reference→reference chains).
-
-Apply guidance to §4.4 output:
-
-1. Prefer engine/charset/collation idioms from the local skill (MySQL: InnoDB + utf8mb4…).
-2. Prefer type/index gotchas from the skill (e.g. DECIMAL for money, no FLOAT amounts).
-3. Keep SpecFlow hard rules (ER, full CREATE TABLE, 本迭代用法, G3/G4) — skill **supplements**, does not replace.
-
-Cite in §4.4 总则 the **actual** paths used:
-- `项目约定: <path…> | 未发现`
-- `DB 技能: .cursor/specflow/guidance/database/mysql` 或 `skills/database/mysql (package fallback)` 或 `LLM-fallback`
-
----
-
-## 4. On miss — LLM fallback
-
-If `DB stack = none`, or stack set but **no** guidance root resolves:
-
-1. **Do not** force-load mysql/postgresql skills.
-2. Generate §4.4 with SpecFlow rules only (`generate.md` §4.4 + Quality Gates G3/G4).
-3. If design/tasks claim a DB but signals are absent → `WARNING` in §8:
-   `design 声称落库但未检测到 DB 栈信号 — 已用 LLM 通用 DDL;建议 refine 标明引擎`.
-4. If stack detected but guidance files missing → `WARNING` in §8:
-   `dbStack=<stack> 但未找到 guidance/database — 已用 LLM-fallback;建议 specflow init --force-assets`.
-5. Pure CLI/config changes → keep `不涉及数据库变更(...)`.
-
----
-
-## 5. Why not remote skills / MCP / IDE skills?
-
-- **Remote**: approval must work offline; maintain pack in this repo + init sync.
-- **MCP tools**: markdown guidance, not APIs; routing chooses which local files to `Read`.
-- **IDE skills**: packs must **not** appear under `.cursor/skills` / `.claude/skills` / `.agents/skills`
-  (noise + false discoverability). They live only under `{ide}/specflow/guidance/`.

package/prompts/approval/frontend-guidance.md

@@ -1,249 +0,0 @@
-# Approval · Frontend Guidance Router
-
-> Used by `/specflow:approval` when the change touches **UI / 控制台 / 页面 / 组件**.  
-> **项目约定**: 写 **§4.6** 前必须执行 `project-conventions-guidance.md`(`topic=frontend`)，
-> **并**按本文件 §3 补扫 IDE skills / rules / 落地规约(组件、样式、表单、测试等)。  
-> **优先级**: 项目约定 + IDE skills/rules + 现网页面/组件/路由 **>** 本文件结构硬门槛 **>** LLM。  
-> **Not** an MCP tool; **禁止** `invoke /react` 之类 IDE skill 口号 —— 一律解析路径后 `Read`。  
-> 灵感对齐 vibe-coding Part3 Frontend（栈五元组 / 目录分层 / Visual Loop），**不**搬 MVP 访谈问卷。
-
----
-
-## 1. Detect `uiInScope`
-
-Scan proposal / design / tasks / specs (and Tech Stack Intake answers) for UI signals:
-
-| Signal (any) | Meaning |
-|--------------|---------|
-| 控制台 / 前端 / UI / 页面 / 路由 / 组件 / 表单 / 弹窗 | UI work in scope |
-| `*.tsx` / `*.vue` / `*.svelte` / `pages/` / `app/` router paths in tasks | UI work in scope |
-| §2.2 前端行非「不涉及」 | UI work in scope |
-| Explicit「不涉及前端」+ no UI paths | `uiInScope=false` |
-
-**Announce**:
-
-```text
-UI in scope for approval: yes | no
-FE stack: <detected or user-confirmed or unknown>
-Project conventions (frontend): <paths…> | none
-IDE FE skills/rules: <paths…> | none
-```
-
-If `uiInScope=no` → omit entire §4.6 from `approval.md`(write one line under detailed design
-optional checklist only if needed: `不涉及前端/UI 变更`). Do **not** invent pages.
-
----
-
-## 2. Detect frontend stack (signals)
-
-Project root / common app dirs (non-recursive first; optional `apps/*` / `web/` / `frontend/` one level):
-
-| Signal | Suggested FE |
-|--------|--------------|
-| `next` / `next.config.*` | Next.js |
-| `vite` + `react` | React + Vite |
-| `vue` / `nuxt` | Vue / Nuxt |
-| `svelte` / `@sveltejs/kit` | Svelte / SvelteKit |
-| `@angular/core` | Angular |
-| `react-native` / `expo` | React Native |
-| `tailwindcss` | Styling: Tailwind |
-| `zustand` / `@reduxjs/toolkit` / `pinia` / `jotai` | State hint |
-| `shadcn` / `@mui` / `antd` / `element-plus` | UI kit hint |
-
-Record a **五元组** for §2.2 / §4.6.1 (fill unknowns via Intake, never invent):
-
-1. **Framework** — e.g. React+TS / Next.js / Vue3  
-2. **Styling** — Tailwind / CSS Modules / 现网设计系统  
-3. **State** — Zustand / Redux / Pinia / 仅服务端状态 …  
-4. **UI kit** — shadcn / Ant Design / 公司组件库 / Custom  
-5. **FE testing** — Vitest+RTL / Playwright / Cypress / 项目现网命令  
-
-If `uiInScope=yes` and any of Framework / Styling / State is still unknown after artifacts +
-signals → **STOP** and ask (merge into Tech Stack Intake; do not invent):
-
-```text
-本变更含前端/UI，请补全前端技术选型（可写「沿用现网」）:
-1. Framework / 语言
-2. Styling / 设计系统
-3. 状态管理（client vs server state 偏好）
-4. UI 组件库（或公司内部库）
-5. 前端验证方式（单测 / 组件测 / E2E / browser 手测命令）
-6.（可选）若用 v0/Lovable 等 AI builder 起稿：导出与本地可构建计划
-```
-
----
-
-## 3. Load implementation conventions (项目约定 + IDE skills/rules + 落地文档)
-
-> **目的**:§4.6 不是只选栈,还要让 apply 阶段能按**本仓真实落地规约**写页面/组件。  
-> **硬规则**:`uiInScope=yes` 时,起草 §4.6 **之前**必须完成本节;禁止跳过 IDE skills/rules 扫描。  
-> **预算**:合计最多 **Read 5 个文件**(配置路径优先占满预算;细节 reference 仅入口点名后再读,禁止链式跳转)。
-
-### 3.1 加载顺序(固定)
-
-1. **`project-conventions-guidance.md` `topic=frontend`**  
-   - 先 `specflow/config.yaml` → `conventions.frontend`  
-   - 再仓根中立 docs(见该路由 §2.2)  
-2. **IDE skills / rules / 记忆文件**(本会话 `activeIde` 优先,再 cursor → claude → agents 回退)  
-3. **落地向 agent/工程文档**(若尚未纳入预算)  
-4. **现网锚点**(Pass 6:路由/布局/API client,**仅读 design/tasks 点名的文件**)
-
-**Priority**: ① 项目约定 + IDE skills/rules + 现网 UI **>** ② §4.6 骨架 **>** ③ LLM。
-
-### 3.2 必须覆盖的「开发落地」主题(按需匹配文件)
-
-扫描/选取文件时,优先覆盖下列维度(有则 Read,无则在 §4.6.1 写「未发现」——**禁止臆造**):
-
-| 落地维度 | 写入 §4.6 何处 | 典型关键词 / 文件名线索 |
-|----------|----------------|-------------------------|
-| 目录与命名(components/features/pages) | 4.6.1 / 4.6.3 | `structure`, `folder`, `naming`, `feature-based` |
-| 组件边界与复用(ui vs features) | 4.6.3 | `component`, `design.?system`, `shadcn`, `storybook` |
-| 路由 / 信息架构 | 4.6.2 | `router`, `routing`, `app.?router`, `pages` |
-| 状态与数据获取 | 4.6.4 | `state`, `zustand`, `redux`, `react.?query`, `swr`, `pinia` |
-| 表单与校验 | 4.6.3 / 4.6.4 | `form`, `zod`, `yup`, `validation`, `rhf` |
-| API client / 错误呈现(Toast/Alert) | 4.6.3 / 4.6.4 + 挂 §4.5 | `api.?client`, `fetch`, `axios`, `toast`, `error.?boundary` |
-| 样式 / Token / 主题 | 4.6.1 / 4.6.5 | `tailwind`, `css`, `theme`, `token`, `styled` |
-| 无障碍 / 响应式 | 4.6.5 | `a11y`, `accessibility`, `responsive`, `breakpoint` |
-| i18n | 4.6.1 备注 / 4.6.3 | `i18n`, `locale`, `intl` |
-| 测试与 Visual Loop 命令 | 4.6.5 + §6 | `vitest`, `playwright`, `cypress`, `rtl`, `testing`, `e2e` |
-| Lint / format 禁令 | §2.1 约束 + 4.6.1 | `eslint`, `prettier`, `stylelint`, `biome` |
-
-### 3.3 IDE 扫描清单(解析路径后 Read,禁止 invoke)
-
-对每个命中路径:**先看文件名/frontmatter `name`/`description`/首段标题**,与上表关键词匹配再纳入预算。
-
-**Cursor**
-
-| 类型 | 路径模式 |
-|------|----------|
-| Rules | `.cursor/rules/**/*.mdc`(及 `.md`) |
-| Skills | `.cursor/skills/**/SKILL.md` |
-| 其它 | `.cursor/rules` 下与 FE 相关的聚合 rule |
-
-**Claude**
-
-| 类型 | 路径模式 |
-|------|----------|
-| Skills | `.claude/skills/**/SKILL.md` |
-| Rules | `.claude/rules/**/*` |
-| 记忆 | `CLAUDE.md` / `.claude/CLAUDE.md`(只抽取 FE 相关章节,勿整文件灌入上下文) |
-
-**Codex**
-
-| 类型 | 路径模式 |
-|------|----------|
-| Skills | `.agents/skills/**/SKILL.md` |
-| 记忆 | `AGENTS.md`(只抽取 FE 相关段落) |
-
-**仓根 / 中立落地文档(补充候选,与 conventions 路由合并去重)**
-
-| 路径 |
-|------|
-| `docs/frontend/**/*.md`(优先 `conventions.md` / `patterns.md` / `testing.md`) |
-| `docs/engineering/frontend.md` |
-| `.specflow/conventions/frontend.md` |
-| `agent_docs/tech_stack.md` |
-| `agent_docs/code_patterns.md` |
-| `agent_docs/testing.md` |
-| `REVIEW-CHECKLIST.md`(仅 UI/前端相关条目) |
-
-**关键词**(文件名 + 标题 + skill description,大小写不敏感):
-
-```text
-frontend|front-end|ui|ux|react|vue|next|nuxt|svelte|angular|
-tailwind|component|design-system|design system|css|style|
-router|routing|form|zod|state|zustand|redux|pinia|query|
-playwright|vitest|cypress|testing-library|a11y|accessibility|
-i18n|控制台|前端|页面|组件|样式|表单|路由
-```
-
-### 3.4 选取与冲突
-
-1. `conventions.frontend` 配置路径 **最先占用预算**。  
-2. 其次 activeIde 命中的 skill/rule(每类优先 1–2 个最相关)。  
-3. 再补仓根 `agent_docs/*` / `docs/frontend/*`。  
-4. 同主题多文件内容冲突 → **以 config / 仓根中立 docs 为准**,IDE skill 仅作补充;在 §4.6.1 注明。  
-5. 发现硬禁令(例:「禁止新建全局 CSS」「必须用公司 Button」)→ 写入 §2.1 与 §4.6,违反则 chat/`§8` WARNING。
-
-### 3.5 写入总则
-
-Cite in §4.6.1:
-
-| 项 | 填法 |
-|----|------|
-| 项目约定 | config + 中立 docs 路径,`; ` 分隔 / **未发现** |
-| IDE skills/rules | 实际 Read 的 skill/rule 路径 / **未发现** |
-| FE 栈 | 五元组摘要 \| 用户确认 \| 沿用现网 |
-
-Announce 示例:
-
-```text
-Project conventions (frontend): docs/frontend/conventions.md
-IDE FE skills/rules: .cursor/rules/frontend.mdc; .cursor/skills/ui-patterns/SKILL.md
-Conflict policy: project > IDE conventions > SpecFlow §4.6 skeleton > LLM
-```
-
----
-
-## 4. §4.6 output contract (when `uiInScope=yes`)
-
-Follow `generate.md` §4.6 exactly. Outline hygiene:
-
-```text
-### 4.6 前端 / UI 设计
-├── #### 4.6.1 总则与本迭代结论
-├── #### 4.6.2 信息架构与路由
-├── #### 4.6.3 关键页面 / 组件详设
-│   └── ##### Page · <短名>   ← 每页仅此一级标题
-├── #### 4.6.4 状态与数据获取
-└── #### 4.6.5 视觉与验证回路
-```
-
-Labels such as「空态」「加载」「错误」「依赖接口」are `**bold**`, never extra headings.
-
-Apply loaded conventions into the body:
-
-- 目录/命名禁令 → 4.6.1「本迭代不涉及」与 4.6.3 组件边界  
-- 状态/表单/API client 模式 → 4.6.4(写「采用项目约定:<path>」)  
-- a11y/响应式/测试命令 → 4.6.5  
-- **禁止**把 skill 原文整段粘贴进 approval;用可读中文转述硬约束
-
-**Quality gates (UI path)**:
-
-| ID | Rule |
-|----|------|
-| **G5** | 必须有本迭代**页面/路由清单**(禁止只写「用 React」) |
-| **G6** | 每个关键 `Page · …` 至少覆盖 **空态 / 加载 / 错误** 之一,并标明依赖的 §4.5 `In` |
-
-**Visual Verification Loop** (write into §4.6.5 + feed §6 when useful):
-
-1. **Generate** — AI/人产出组件  
-2. **Render** — dev server 或 headless browser  
-3. **Inspect** — 截图 / 设计原则 / a11y 抽查  
-4. **Refine** — 修视觉与交互回归后再合入  
-
-Record exact `dev` / `test` / `browser` commands when known (from conventions / IDE skills / Intake).
-
-**Builder exit** (only if AI builder used): source ownership + local install/dev/test + secrets
-handling + exit plan — put under §4.6.1 备注 or §2.5 风险; do not pad marketing lists.
-
----
-
-## 5. Cross-links
-
-- Pages that call APIs **must** reference §4.5 interface numbers (`I1…`).  
-- User journeys in §1.3 / Happy Path §4.2 should name the same pages.  
-- §3 architecture may show「控制台 / Web」box; details live in §4.6, not duplicated as
-  code-dump trees in §2.1.
-
----
-
-## 6. On miss / fallback
-
-| Case | Action |
-|------|--------|
-| `uiInScope=no` | Omit §4.6 |
-| `uiInScope=yes`, no conventions / no IDE FE skills | Draft §4.6 with skeleton + Intake;`项目约定: 未发现`;`IDE skills/rules: 未发现`; chat 可 WARNING 建议补 `docs/frontend/conventions.md` 或 Cursor rule |
-| User refuses FE selection while UI required | `[待 refine 澄清: 前端技术选型]`; do not fabricate page trees |
-| Only API change, no UI | §4.5 only; §4.6 omitted |
-| IDE skill 与仓根约定冲突 | 仓根/config 优先;记 WARNING |