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

package/prompts/approval/segmented-generation.md

@@ -1,157 +0,0 @@
-# Approval · Segmented Generation (Map → CLI Reduce)
-
-> Used by `/specflow:approval` **Stage 12** when `mode=segmented` (default for non-trivial §4).
-> **Reduce 禁止 LLM**：拼接必须 `specflow approval finalize <change>`（或 debug：`check` / `assemble`）。
-
----
-
-## 0. When to segment
-
-| Condition | Mode |
-|-----------|------|
-| `tables > 2` OR `interfaces > 3` OR `pages > 2` OR `optional.s5=true` | **segmented** (mandatory) |
-| Else | ask user: segmented (recommended) or monolithic |
-| User chose monolithic | write `approval.md` directly OR parts + single assemble |
-
-Copy template: `templates/approval-index.yaml` → `approval/index.yaml`.
-
----
-
-## 1. Pipeline (hard order)
-
-```text
-12a Index + Skeleton  →  index.yaml + analysis.json + parts 01–03 + 04-detail-core + stubs
-Gate                  →  user confirms index + optional chapters + mode
-12b Map Append        →  parts 04.4* / 04.5* / 04.6* / 04.7–04.9 (batched)
-12c Optional          →  parts 05* / 07 / 08 (only if optional.s5/s7/s8)
-12e AI Review         →  fix parts; review-result.json + part_hashes
-12f Finalize          →  specflow approval finalize <change>
-```
-
-**Never** skip 12d. **Never** paste assembled markdown from memory instead of running CLI.
-
----
-
-## 2. Anti-lazy rules (Map — LLM MUST NOT)
-
-| # | Forbidden | Required instead |
-|---|-----------|------------------|
-| L1 | One-shot full `approval.md` when `mode=segmented` | Write parts; assemble via CLI |
-| L2 | Empty part, `< 20` chars, or only HTML comments | Full section content per generate.md |
-| L3 | `TODO` / `待补充` / `此处省略` / bare `TBD` | Concrete text or `[待 refine 澄清: <元素>]` with reason |
-| L4 | `详见 design/tasks` without §/In/Page id | Cross-ref `§4.5 I2` / `Page·列表` / `P1` |
-| L5 | Invent new table/interface/page ids not in index | Update index.yaml first, then write part |
-| L6 | Skip §4.4 DDL/字段表/失败示例 because "same as design" | Minimum per G2–G6; **不变**仍须完整 §4.5 |
-| L6b | L2 HTTP only +「内部 I7」stub; or L4 one-liner | **分层** L2/L3/L4 各 `In`; `api-guidance.md` §1 |
-| L6c | RPC「暂定/如/实现时」 | **冻结**名 + proto 字段号; `api-guidance.md` §2–§3 |
-| L7 | Skip IDE skills/rules scan for §4.6 | frontend-guidance.md §3 before Map |
-| L8 | Paste skill/rule bodies verbatim | Readable Chinese + path in §4.6.1 table |
-| L9 | Write `## 4.` or foreign `## N.` in parts | Parts use `###`/`####`/`#####` only; CLI injects `## 4` |
-| L10 | Mark part `ok` without `specflow approval check` passing | Run check; fix errors; then assemble |
-
----
-
-## 3. Stage 12a — Index + Skeleton
-
-**Write first:**
-
-1. `approval/index.yaml` — full `parts_order`, all `tables[]`/`interfaces[]`/`pages[]` with `part` paths  
-2. `approval/analysis.json` — Pass 1–7 + quality + implementability (chat-only fields ok)  
-3. Parts (minimum):
-   - `01-intro.md` … `03-architecture.md`
-   - `04-detail-core.md` (§4.1–4.3 only)
-   - `06-test.md`, `09-implementability.md`, `10-signoff.md` (may be stub-length only for structure in 12a, fill before assemble)
-
-**Chat gate:** show table/interface/page list from index; ask user to confirm before 12b.
-
----
-
-## 4. Stage 12b — Map Append
-
-For each batch, **Read only**:
-
-- `approval/index.yaml`
-- `approval/analysis.json` (verdicts, not full Pass essays)
-- design/tasks/specs **snippets** for this batch's ids
-- lazy-loaded conventions (per topic caps)
-- anchor files for this batch (Pass 6 depth: file only)
-
-**Batching:** use `index.batching.*_per_call`. One part file per batch unit OR per index `part` field.
-
-**After each part write:** update `approval/manifest.json` part entry (`status: draft|ok`).
-
-### §4.4 part minimum (per table batch)
-
-- 4.4.1 row in batch leader file if first batch
-- ER if new entities
-- per-table: CREATE TABLE + 字段说明 + 本迭代用法
-- G3/G4 when applicable
-
-### §4.5 part minimum (per interface)
-
-- Run **`api-guidance.md`** before batch
-- **One `In` per contract surface** (L2 Worker HTTP / L3 RPC+http / L4 client RPC) — no B2-style collapse
-- meta + fields + success req/resp + **failure example (G2)** + error table (**含不变**)
-- **新增/改 HTTP binding**: `**Proto 草案**` block — frozen RPC name, field numbers, `google.api.http`, Gateway registration, Worker OpenAPI path
-- HTTP examples for L2: **all** required work auth headers (not body-only)
-- **Forbidden**: 暂定 / 如 XxxRpc / 实现时命名 / 内部经 I7 一行代替 L4 详设
-
-### §4.6 part minimum (per page)
-
-- route + components + states + ≥1 of 空/加载/错态 (G6) + §4.5 `In` refs
-
----
-
-## 5. Stage 12c — Optional chapters
-
-Only if user opted in AND `optional.s5/s7/s8: true` in index:
-
-- Insert `05-*` / `07-deploy` / `08-closed-loop` into `parts_order` at correct positions
-- §8: **one table only** (from analysis.json)
-
----
-
-## 6. Stage 12e–12f — AI Review + Finalize
-
-**12e (in-session)**: Read `prompts/approval/ai-review.md`; fix parts; write `approval/review-result.json`.
-
-**12f (one CLI)**:
-
-```bash
-specflow approval finalize <change> [--bundle] [--workspace-root <root>]
-```
-
-- First run without `review-result.json`: pauses, writes `review-packet.json`, agent completes 12e, re-run finalize
-- Chains lint → review-check → check → assemble → bundle (when enabled)
-- Subcommands (`lint`, `assemble`, …) are for CI/debug only
-
-See **`prompts/approval/acp-pipeline.md`**.
-
----
-
-## 7. manifest.json (agent-maintained)
-
-```json
-{
-  "schema": "specflow.approval.manifest/v1",
-  "change": "<name>",
-  "parts": [
-    { "id": "01-intro", "path": "approval/parts/01-intro.md", "status": "ok" }
-  ]
-}
-```
-
-CLI overwrites manifest on successful assemble with sha256 sums.
-
----
-
-## 8. Retry
-
-| Failure | Action |
-|---------|--------|
-| `lazy_part_content` on one part | Rewrite that part only; re-check |
-| `missing_part` | Write missing part or fix index |
-| `id_part_mismatch` | Align index `part` field with filename |
-| index wrong | Edit index.yaml; delete wrong parts; rerun affected Map batches |
-
-Do **not** rerun Pass 1–7 unless analysis is stale.