@xulthekl/team-flow 0.46.0 → 0.47.0

package/.claude/always/phase-guard.md

@@ -1,3 +1,3 @@
-# team-flow v0.46.0 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.47.0 | 阶段: {{state}} | 工作流: {{workflow}}
 当前阶段允许的操作由 workflow-start 路由规则定义。
 禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。

package/.claude-plugin/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "description": "Unified workflow plugin: team-flow + compound-engineering core subset + architecture-design + prototype + workflow-orchestrator + workflow-bootstrap + e2e + session-handoff + workflow-feedback + business-analysis. 26 skills + 16 agents, one install.",
+  "description": "Unified workflow plugin: team-flow + compound-engineering core subset + architecture-design + prototype + workflow-orchestrator + workflow-bootstrap + e2e + session-handoff + workflow-feedback + business-analysis. 26 skills + 17 agents, one install.",
   "owner": {
     "name": "LT",
     "url": "https://github.com/LT"
@@ -8,8 +8,8 @@
   "plugins": [
     {
       "name": "team-flow",
-      "description": "8-state spec workflow + compound global compounding + architecture-design (4A/DDD) + local HTML prototype + product-level orchestration + bootstrap + e2e + session handoff + workflow feedback + independent business analysis. 26 skills + 16 agents with embedded TDD, SDD, code review, debugging, delta spec sync, and design-system-driven prototyping.",
-      "version": "0.46.0",
+      "description": "8-state spec workflow + compound global compounding + architecture-design (4A/DDD) + local HTML prototype + product-level orchestration + bootstrap + e2e + session handoff + workflow feedback + independent business analysis. 26 skills + 17 agents with embedded TDD, SDD, code review, debugging, delta spec sync, and design-system-driven prototyping.",
+      "version": "0.47.0",
       "source": "./",
       "author": {
         "name": "LT",

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "team-flow",
-  "version": "0.46.0",
-  "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact). 26 skills + 16 agents, one install.",
+  "version": "0.47.0",
+  "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact). 26 skills + 17 agents, one install.",
   "source": "./",
   "author": {
     "name": "LT",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.46.0",
+  "version": "0.47.0",
   "description": "Spec-first workflow that bridges OpenSpec-style planning and Superpowers-style execution discipline.",
   "author": {
     "name": "MageByte",

package/.cursor-plugin/marketplace.json

@@ -5,13 +5,13 @@
   },
   "metadata": {
     "description": "Unified workflow plugin marketplace for Cursor (team-flow: team-flow + compound + architecture-design + prototype).",
-    "version": "0.46.0"
+    "version": "0.47.0"
   },
   "plugins": [
     {
       "name": "team-flow",
       "source": ".",
-      "description": "Unified workflow plugin: team-flow + compound-engineering core subset + architecture-design + prototype + business-analysis. 25 skills + 16 agents."
+      "description": "Unified workflow plugin: team-flow + compound-engineering core subset + architecture-design + prototype + business-analysis. 26 skills + 17 agents."
     }
   ]
 }

package/.cursor-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "team-flow",
   "displayName": "team-flow",
-  "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact). 26 skills + 16 agents, one install.",
-  "version": "0.46.0",
+  "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact). 26 skills + 17 agents, one install.",
+  "version": "0.47.0",
   "author": {
     "name": "LT",
     "url": "https://github.com/LT"

package/.github/plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Unified workflow plugins and skills for AI coding agents (team-flow: team-flow + compound + architecture-design + prototype).",
-    "version": "0.46.0"
+    "version": "0.47.0"
   },
   "plugins": [
     {
       "name": "team-flow",
       "description": "Unified workflow with planning artifacts, execution contracts, TDD, review gates, systematic debugging, delta spec sync, architecture-design, independent business analysis, and local HTML prototyping.",
-      "version": "0.46.0",
+      "version": "0.47.0",
       "source": ".",
       "author": {
         "name": "LT",

package/AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md · team-flow
 
-> team-flow 统一插件 = **team-flow**（spec 驱动开发）+ **compound-engineering 核心子集**（全局复利）+ **architecture-design**（4A+DDD 增量设计）+ **prototype**（本地 HTML 原型）+ **e2e**（AC 驱动 Playwright E2E）+ **workflow-orchestrator**（产品级编排）+ **workflow-bootstrap**（既有项目接入）。一次安装，七套能力协同（26 skills + 16 agents），支持 9 安装面（Claude Code, Cursor, OpenAI Codex CLI/App, GitHub Copilot CLI, Gemini CLI, OpenCode, WorkBuddy, Trae, ima-copilot）。
+> team-flow 统一插件 = **team-flow**（spec 驱动开发）+ **compound-engineering 核心子集**（全局复利）+ **architecture-design**（4A+DDD 增量设计）+ **prototype**（本地 HTML 原型）+ **e2e**（AC 驱动 Playwright E2E）+ **workflow-orchestrator**（产品级编排）+ **workflow-bootstrap**（既有项目接入）。一次安装，七套能力协同（26 skills + 17 agents），支持 9 安装面（Claude Code, Cursor, OpenAI Codex CLI/App, GitHub Copilot CLI, Gemini CLI, OpenCode, WorkBuddy, Trae, ima-copilot）。
 
 ## What This Is
 
@@ -12,7 +12,7 @@
 
 ### 身份与依赖关系
 
-- **team-flow**（本插件）：Claude Code / Cursor 等宿主的插件实体（`plugin.json` name = `team-flow`），包含 26 个 skills + 16 个 agents + hooks + templates
+- **team-flow**（本插件）：Claude Code / Cursor 等宿主的插件实体（`plugin.json` name = `team-flow`），包含 26 个 skills + 17 个 agents + hooks + templates
 - **@xulthekl/team-flow**（npm 底座包）：team-flow 的 CLI 工具层（`package.json` name = `@xulthekl/team-flow`，bin = `tf` / `team-flow`），提供状态机、校验、复利 CLI 等运行时能力
 - 关系：team-flow 插件 **包含** @xulthekl/team-flow npm 包作为底座（同一仓库、同一版本）。skills 中的 `tf ...` 调用的是已全局安装的 @xulthekl/team-flow CLI，版本由 session-start hook 自动同步
 - 历史身份（已废弃）：`spec-superflow`（npm 包名，0.11.0 后停止发布）/ `ssf`（CLI 前缀）/ `.spec-superflow.yaml`（状态文件）—— 详见设计增强方案 v0.9 §27
@@ -220,7 +220,7 @@ STRATEGY.md CONCEPTS.md 产品策略(BA) / 领域词汇
 
 > **规则**：新增 skill 时必须在此表登记所属层级。产品级新需求触发词归 workflow-orchestrator 独占。
 
-### Agents 索引（v0.7 新增，v0.30.0 增至 16 个）
+### Agents 索引（v0.7 新增，v0.47.0 增至 17 个）
 
 > **agent 文件设计规范见 CONTRIBUTING.md §6 + `templates/agent-template.md`**（v0.33.0）：frontmatter 必须合法 YAML（非法时 Claude Code 静默降级，skills: 预加载与 tools: 限制全部失效）；description 单句、禁 `<example>` 块；新增/修改 agent 必过 frontmatter-lint + 实证探针。
 
@@ -232,7 +232,8 @@ STRATEGY.md CONCEPTS.md 产品策略(BA) / 领域词汇
 | change-split-auditor | plan.md 拆分质量审计 | Read/Bash/Grep/Glob | orchestrator S4 脚手架前（必选门禁，PASS 方可继续） |
 | code-reviewer | spec 合规审查（批次完成/合并门禁） | Read/Bash/Grep/Glob | build-executor 批次完成、release-archivist 合并前 |
 | cross-change-consistency-checker | 跨 change 冲突检测 | Read/Bash/Grep/Glob | orchestrator S5 多 change 并行/closing 时 |
-| prd-completeness-reviewer | PRD 完整性评审（能否支撑 plan/spec，5 维度） | Read/Bash/Grep/Glob | orchestrator S2 / ce-brainstorm 冻结前门禁（v0.15.0） |
+| prd-completeness-reviewer | PRD 完整性评审（能否支撑 plan/spec，6 维度含 §8.4 契约级细节 D6） | Read/Bash/Grep/Glob | orchestrator S2 / ce-brainstorm 冻结前门禁（v0.15.0，v0.47.0 并入 D6） |
+| prd-writer | PRD 撰写 agent——契约级 §8.4 逐功能详述（ce-brainstorm Phase 3 委托；可写型，PRD 唯一所有者，先读模板检查清单） | Read/Bash/Grep/Glob/Write/Edit | ce-brainstorm Phase 3 委托（v0.47.0） |
 | prototype-builder | 原型绘制执行者（种子优先：template.html+layouts.md 组合；**v0.20.0 产物落盘硬闸门**：index.html 未落盘非空禁返 done + 大产出分片；**v0.21.0 决策点 SendMessage stop-and-resume**） | Read/Write/Edit/Bash/Grep/Glob | prototype skill 内部编排步骤③/⑤修正轮（v0.15.0，v0.18.0 种子优先） |
 | prototype-env-scout | 原型环境探查 + 2-3 差异化方向（direction-picker；**v0.20.0 简报完整性闸门**：简报未完整禁返 done） | Read/Bash/Grep/Glob | prototype skill 内部编排步骤①（v0.15.0，v0.18.0 direction-picker） |
 | prototype-reviewer | PRD 6 维度 + P0 grep + craft 4 席 rubric 评审 | Read/Bash/Grep/Glob | orchestrator S2 原型循环每轮产出后 |

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to `team-flow` will be documented in this file.
 
 The format loosely follows Keep a Changelog.
 
+## [0.47.0] - 2026-08-21
+
+### Added（PRD §8.4 契约级详述规范，v0.47.0）
+
+设计来源：`docs/architecture-api-db-design-enhancement-v0.20.md` §81（2026-08-21，来源 workflow-feedback 20260821-131256 P1 artifact-quality）
+
+- **重构 `templates/prd.md` §8.4 契约级检查清单**：UI 功能 11 维（页面布局/权限规则/区块说明/搜索模块/表格列定义/交互规则/弹层结构/动态字段/导入导出规则/状态操作差异/异常边界）+ 非 UI 功能 7 维（触发条件/输入输出/处理步骤/异常处理/权限角色/幂等并发/性能约束）双形态；NA 机制（不适用须标注 NA+理由，未标注且未覆盖=缺失）；模板为单一权威
+- **`prd-brainstorm-profile.md` 新增「功能细节（契约级）」核心维度**（替代按需扩展）：Standard/Deep 强制契约级澄清，产出 detail_ledger（`requirement/vN/detail-ledger.md`）
+- **新增 `prd-writer` agent**：ce-brainstorm Phase 3 委托撰写（写法 2 预加载 ce-brainstorm，Iron Law=先读模板 §8.4 检查清单，不提问、不虚构、missing_info 回传，PRD 唯一所有者）
+- **`prd-completeness-reviewer` 并入 D6 维度**（5 维→6 维）：§8.4 契约级细节——核心维度缺失/悬空功能=Critical，辅助维度缺失=Important；detail_ledger 交叉核对（澄清已确认但 PRD 缺失/标 NA=Critical）；`template_path` 入参（自定义模板支持）
+- **ce-brainstorm 流程更新**：Phase 1.3b 功能细节澄清 + Phase 3 委托 prd-writer + QA-4 派发归并（standalone→Phase 3.5 §3.5.5、orchestrated→orchestrator S2 step 3.5，QA-4 不重复派发）+ 完整性评审全路径门禁（有原型/非 UI/跳过原型三路径均强制派发）
+- **orchestrated 路径补齐**：s2-prd-prototype-loop.md step 3.5（冻结前完整性评审门禁，补此前纯后端/跳过原型路径静默漏评审缺口）
+- agent 计数 16→17 全平台同步（plugin.json / .claude-plugin / .cursor-plugin / package.json / AGENTS.md / README / usage-guide）
+- 710/710 测试通过
+
 ## [0.46.0] - 2026-08-19
 
 ### Added（PROJECT_INITIALIZE 场景 + project-initialize skill + ARCH 上移，v0.46.0）

package/GEMINI.md

@@ -8,7 +8,7 @@ The workflow is self-contained and does not require OpenSpec or Superpowers at r
 
 
 <!-- team-flow-phase-guard-start -->
-# team-flow v0.46.0 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.47.0 | 阶段: {{state}} | 工作流: {{workflow}}
 当前阶段允许的操作由 workflow-start 路由规则定义。
 禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。
 <!-- team-flow-phase-guard-end -->

package/INSTALL.md

@@ -7,7 +7,7 @@
 - [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec) — 规划引擎（Schema 验证、Delta Spec、工件解析）
 - [obra/superpowers](https://github.com/obra/superpowers) — 执行纪律（TDD 铁律、SDD、系统化调试、代码审查）
 
-当前发布版本：**v0.46.0**。
+当前发布版本：**v0.47.0**。
 
 ---
 

package/README.md

@@ -1,6 +1,6 @@
 # team-flow
 
-> 当前版本：`v0.46.0`
+> 当前版本：`v0.47.0`
 
 > 统一插件：**team-flow**（spec 驱动开发）+ **compound-engineering 核心子集**（全局复利）+ **architecture-design**（4A+DDD 增量设计）+ **prototype**（本地 HTML 原型）+ **e2e**（AC 驱动 E2E）+ **workflow-orchestrator**（产品级编排）+ **workflow-bootstrap**（既有项目接入）。一次安装，七套能力协同。
 
@@ -84,9 +84,9 @@ STRATEGY.md CONCEPTS.md 策略 / 领域词汇
 - **设计系统**（1）：design-system（独立创建/迭代项目级设计系统，用户主导交互，v0.19.0）
 - **业务分析**（1）：business-analysis（将任意输入整理为 requirement/vN/business-analysis.md，多轮单问澄清，独立外挂，v0.44.0）
 
-### 配套 agents（16 个，v0.30.0 增至 16）
+### 配套 agents（17 个，v0.47.0 增至 17）
 
-全部由编排层 dispatch（主代理只编排，need-explorer 为主进程交互式澄清）：architecture-design（架构设计门控）/ architecture-reviewer（架构自动审查）/ bug-investigator（bug 根因调查）/ change-split-auditor（拆分质量审计）/ code-reviewer（代码审查）/ cross-change-consistency-checker（跨 change 一致性）/ prd-completeness-reviewer（PRD 完整性评审）/ prototype-builder（原型绘制）/ prototype-env-scout（原型环境探查）/ prototype-reviewer（原型评审）/ need-explorer（需求探索）/ spec-writer（规格编写）/ contract-builder（执行契约构建）/ build-executor（TDD 构建执行）/ release-archivist（发布归档）/ business-analysis（独立业务分析）。
+全部由编排层 dispatch（主代理只编排，need-explorer 为主进程交互式澄清）：architecture-design（架构设计门控）/ architecture-reviewer（架构自动审查）/ bug-investigator（bug 根因调查）/ change-split-auditor（拆分质量审计）/ code-reviewer（代码审查）/ cross-change-consistency-checker（跨 change 一致性）/ prd-completeness-reviewer（PRD 完整性评审，含 §8.4 契约级细节 D6）/ prd-writer（PRD 契约级撰写）/ prototype-builder（原型绘制）/ prototype-env-scout（原型环境探查）/ prototype-reviewer（原型评审）/ need-explorer（需求探索）/ spec-writer（规格编写）/ contract-builder（执行契约构建）/ build-executor（TDD 构建执行）/ release-archivist（发布归档）/ business-analysis（独立业务分析）。
 
 ### 命名约定
 

package/agents/prd-completeness-reviewer.md

@@ -1,13 +1,13 @@
 ---
 name: prd-completeness-reviewer
-description: PRD 完整性自动评审。在 PRD 写入后、冻结前，独立检查"需求描述是否完整到能支撑后续 plan/spec 实施"（5 维度），输出分级完整性报告。直接写审查报告文件，返回摘要 + 文件路径。与 claim verifier 分工——claim verifier 管"说得对不对"（核查事实声明），本 agent 管"说得全不全、能否落地"。
+description: PRD 完整性自动评审。在 PRD 写入后、冻结前，独立检查"需求描述是否完整到能支撑后续 plan/spec 实施"（6 维度，含 §8.4 契约级细节 D6），输出分级完整性报告。直接写审查报告文件，返回摘要 + 文件路径。与 claim verifier 分工——claim verifier 管"说得对不对"（核查事实声明），本 agent 管"说得全不全、能否落地"。由编排层在 PRD 冻结前显式派发（workflow-orchestrator S2 / ce-brainstorm Phase 3.6 前）。
 
 model: inherit
 color: yellow
 tools: ["Read", "Bash", "Grep", "Glob", "Write"]
 ---
 
-You are an independent PRD Completeness Reviewer. You check whether a PRD is **complete enough to support downstream plan/spec/build work**. You produce a graded completeness report across 5 dimensions and write it to disk.
+You are an independent PRD Completeness Reviewer. You check whether a PRD is **complete enough to support downstream plan/spec/build work**. You produce a graded completeness report across 6 dimensions and write it to disk.
 
 ## The Iron Law
 
@@ -26,10 +26,12 @@ Do NOT duplicate claim verification. A statement can be factually correct yet st
 |-----------|-------------|
 | `prd_path` | PRD 文件路径（e.g., `requirement/v1/prd.md`） |
 | `concepts_path` | （可选）CONCEPTS.md 路径，用于术语一致性比对 |
+| `template_path` | PRD 模板路径（可选，默认 `templates/prd.md`；§8.4 检查清单单一权威，以解析后的模板为基准） |
+| `detail_ledger_path` | （可选）detail_ledger 路径（功能细节澄清产出；存在时用于 D6 交叉核对 NA 标注一致性） |
 
 If `prd_path` is missing or unreadable, report `FAIL` with reason `INPUT_ERROR`.
 
-## 5-Dimension Checklist
+## 6-Dimension Checklist
 
 | Dim | Name | Check Content | Severity |
 |-----|------|---------------|----------|
@@ -38,6 +40,7 @@ If `prd_path` is missing or unreadable, report `FAIL` with reason `INPUT_ERROR`.
 | D3 | 边界与非功能 | 空/错/异常状态、性能/兼容约束 | Important |
 | D4 | 术语一致性 | 与 CONCEPTS.md / §6 业务术语一致 | Minor |
 | D5 | 范围闭环 | in/out scope 明确，无悬空功能 | Important |
+| D6 | §8.4 契约级细节 | 逐功能模块按模板检查清单覆盖适用维度（UI 11 维/非 UI 7 维）；§7↔§8.4 交叉核对无悬空功能。**基准 = 模板 §8.4 检查清单（单一权威）** | Critical（核心维度缺失/悬空）/ Important（辅助维度缺失） |
 
 ## Review Process
 
@@ -71,6 +74,14 @@ If `prd_path` is missing or unreadable, report `FAIL` with reason `INPUT_ERROR`.
    - Any out-of-scope item that other requirements implicitly depend on?
    Missing scope declaration or dangling feature = Important.
 
+8. **D6 §8.4 契约级细节完整度**：Read the template §8.4 checklist FIRST — `template_path`（默认 `templates/prd.md`）is the single authority (UI 11 维 / 非 UI 7 维), never judge against your own expectations. Then for each function module in the PRD §8.4:
+   - 判定功能形态（UI/非 UI），按对应维度清单核对覆盖度；**未标注 NA 且未覆盖的适用维度 = 缺失**
+   - **核心维度缺失 = Critical**：功能概述缺失；UI 页面布局/表格列定义缺失；非 UI 输入输出/处理步骤/异常处理缺失
+   - **辅助维度缺失 = Important**：UI 权限规则/搜索模块/弹层结构/动态字段/导入导出/状态操作差异/异常边界；非 UI 触发条件/权限角色/幂等并发/性能约束
+   - **§7 系统功能清单 ↔ §8.4 详述块交叉核对**：§7 列出但 §8.4 无详述 = **悬空功能 = Critical**
+   - 维度不适用但已显式标注 `NA + 理由` 的模块 = 不视为缺失（但需抽查 NA 理由合理性）
+   - **detail_ledger 交叉核对（可选）**：若 `detail_ledger_path` 提供，对比澄清期确认的维度状态与 PRD §8.4 覆盖/NA 标注——澄清已确认内容但 PRD 缺失或标 NA = Critical；澄清标 NA 但 PRD 有详述 = 记录不阻断
+
 ### Phase 3: 汇总判定
 
 Aggregate findings → final verdict per the Judgment Criteria.
@@ -81,9 +92,9 @@ Aggregate findings → final verdict per the Judgment Criteria.
 |---------|-----------|--------|
 | **PASS** | Critical=0 且 Important=0 | 可进入冻结 / 下游 plan |
 | **PASS_WITH_WARNINGS** | Critical=0 且 Important>0 | 警告项交人工裁定，不阻断 |
-| **FAIL** | Critical>0 | 必须回 Phase 1.3 补充后重新评审 |
+| **FAIL** | Critical>0 | 必须回 Phase 1.3/Phase 3 补充后重新评审 |
 
-**FAIL 仅由 Critical 触发**（D1/D2 缺失）。Important（D3/D5）误报不触发 FAIL。Minor（D4）仅记录。
+**FAIL 仅由 Critical 触发**（D1/D2 缺失；D6 核心维度缺失、D6 悬空功能）。Important（D3/D5/D6 辅助维度）误报不触发 FAIL。Minor（D4/D6 可读性）仅记录。
 
 ## Output Format
 
@@ -122,6 +133,9 @@ Aggregate findings → final verdict per the Judgment Criteria.
 ### D5 范围闭环 — {PASS/WARN}
 [in/out scope 声明状态 + 悬空功能列表]
 
+### D6 §8.4 契约级细节 — {PASS/FAIL} ({m}/{n} modules contract-grade)
+[逐功能模块检查：功能形态 | 适用维度覆盖 | NA 标注 | 悬空功能 | 状态]
+
 ## Findings
 | # | Dim | Severity | PRD Source | Requirement | Description | Suggestion |
 |---|-----|----------|-----------|-------------|-------------|------------|
@@ -146,6 +160,8 @@ Aggregate findings → final verdict per the Judgment Criteria.
 - Distinguish "missing" from "present-but-unverifiable" (both Critical for D2, but different fixes)
 - Give a clear, unambiguous verdict
 - Treat vague AC ("表现良好"/"快速响应" without threshold) as a D2 Critical
+- Read the template §8.4 checklist BEFORE assessing D6 — the template is the single authority, not your expectations
+- Distinguish "维度不适用（已标注 NA）" from "维度缺失（未标注 NA 且未覆盖）" in D6
 
 **DON'T:**
 - Modify the PRD or any other artifact — only write the review report
@@ -154,3 +170,4 @@ Aggregate findings → final verdict per the Judgment Criteria.
 - Trigger FAIL on Important or Minor findings — FAIL is Critical-only
 - Mark stylistic/wording polish as findings — completeness, not prose quality
 - Omit the PRD source reference for any finding
+- Judge D6 against your own detail expectations — cite the template checklist dimension name for every D6 finding

package/agents/prd-writer.md

@@ -0,0 +1,68 @@
+---
+name: prd-writer
+description: PRD 撰写 agent——在 ce-brainstorm 主会话完成交互澄清（Phase 0-2.6 + 功能细节澄清）之后、QA-4 审查之前，按 PRD 模板 §8.4 契约级检查清单将已确认产出整理为契约级 PRD 草稿（requirement/vN/prd.md）。可写型，负责 PRD 文档。
+
+model: inherit
+color: green
+tools: ["Read", "Bash", "Grep", "Glob", "Write", "Edit"]
+skills:
+  - ce-brainstorm
+---
+
+You are an independent PRD Writer. You turn the confirmed brainstorm outputs (business-analysis.md, dialogue-log.md, detail_ledger, synthesis summary) into a contract-grade PRD document at `requirement/vN/prd.md`. You execute ONLY the PRD writing phase — interactive clarification (Phase 0-2.6) is ALREADY DONE by the main conversation.
+
+## Scope Boundary
+
+You write PRD documents only. You do NOT run interactive phases, do NOT ask the user questions, do NOT modify business-analysis.md / dialogue-log.md / detail_ledger. Any information gap is reported as `missing_info` in your output contract — never invented.
+
+## Artifact Ownership
+
+**You are the sole owner of `requirement/vN/prd.md`.** No other agent or the orchestration layer may directly edit it. Modification requests (review feedback) MUST be routed through you via `SendMessage` resume.
+
+**Your preloaded Skill (ce-brainstorm) contains the detailed methodology** — PRD template resolution, `references/brainstorm-sections.md` chapter mapping (incl. §8.4 功能模块提取规则), `references/prd-mapping.md` version format. Follow it for HOW. This prompt defines WHO you are and WHAT you must deliver.
+
+## Iron Law
+
+1. **先读模板 §8.4 检查清单再撰写**：定位 `template_path`（默认 `templates/prd.md`）§8.4（UI 11 维 / 非 UI 7 维），以解析后的模板为逐功能详述的强制基准，不在他处猜测规范。
+2. **逐功能模块契约级详述**：每个功能按「功能形态」（UI/非 UI）覆盖对应必含维度；维度不适用时标注 `NA + 一句理由`；**未标注 NA 且未覆盖 = PRD 不完整**。
+3. **无信息章节保留模板占位，不虚构**：data source 未覆盖的内容保留 `{占位}`，并列入 `missing_info`。
+4. **不写实现契约**：接口路径/表字段/类结构/算法实现属 change 级 spec/design，PRD 只写产品行为与规则。
+
+## Inputs
+
+| Parameter | Description |
+|-----------|-------------|
+| `prd_path` | 目标 PRD 路径（e.g., `requirement/v1/prd.md`） |
+| `template_path` | PRD 模板路径（默认 `templates/prd.md`） |
+| `business_analysis_path` | business-analysis.md 路径（§2/§3/§7/§8 数据源） |
+| `dialogue_log_path` | dialogue-log.md 路径（§1.2 修订记录引用） |
+| `detail_ledger_path` | detail_ledger 路径（功能细节澄清产出，§8.4 数据源） |
+| `synthesis_summary` | 综合确认产出（scope 判定与核心决策） |
+
+If `template_path` is missing or unreadable, report `FAIL` with reason `INPUT_ERROR`.
+
+## Structured Output Contract
+
+Return the following YAML to the orchestration layer:
+
+```yaml
+status: done | blocked              # done: PRD 草稿已写入并通过自检
+artifact_path: requirement/vN/prd.md
+missing_info: [...]                 # 保留占位的未澄清信息清单（供 QA-4 / D6 定位）
+summary: "..."                      # 2-3 sentence overview + 待主会话确认点
+```
+
+## Red Lines
+
+**DO:**
+- 先读模板 §8.4 检查清单，再逐功能模块按维度详述
+- 从 detail_ledger / business-analysis.md 提取已确认信息，保持信息完整（页面布局/搜索字段/表格列/交互规则/级联逻辑等关键细节不得丢失或过度概括）
+- 功能描述含糊到"一句话说不清"时，先拆分功能再详述
+- 结束回复用显式终止标记：`FINAL VERDICT: <DONE | BLOCKED | FAIL>`
+
+**DON'T:**
+- 不执行交互阶段，不向用户提问（澄清已由主会话完成）
+- 不虚构未确认信息——data source 缺失就保留占位 + 列入 missing_info
+- 不写接口/表/类/算法等实现契约（属 change 级 spec/design）
+- 不修改 business-analysis.md / dialogue-log.md / detail_ledger / ledger.md
+- 不删除模板占位——无信息章节保留 `{占位}`

package/docs/README_en.md

@@ -126,7 +126,7 @@ npm install -g team-flow
 
 ### Version
 
-- Current: `v0.46.0`
+- Current: `v0.47.0`
 - v0.9.1 highlights: DP-4 execution-mode recommendations, a portable runtime across 17 platforms, and a raw-package smoke with no plugin-root variable.
 - Self-contained — no OpenSpec or Superpowers runtime required
 - Upstream: [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec), [obra/superpowers](https://github.com/obra/superpowers)

package/docs/solutions/INDEX.md

@@ -2,6 +2,7 @@
 <!-- 每条一行，按 severity 降序，≤150 行硬上限 -->
 | date | phase | domain | type | severity | summary | file |
 |------|-------|--------|------|----------|---------|------|
+| 2026-08-21 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-08-21-no-summary.md |
 | 2026-08-19 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-08-19-no-summary.md |
 | 2026-08-18 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-08-18-no-summary.md |
 | 2026-08-17 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-08-17-no-summary.md |

package/docs/solutions/cross-phase/2026-08-21-no-summary.md

@@ -0,0 +1,17 @@
+---
+phase: cross-phase
+domain: general
+type: insight
+severity: medium
+date: 2026-08-21
+source: 
+---
+
+## 问题描述
+(no summary)
+
+## 根因/模式
+（待补充）
+
+## 预防措施/应用方式
+（待补充）

package/docs/usage-guide.md

@@ -1,6 +1,6 @@
 # team-flow 使用说明（研发团队版）
 
-> 版本锚点：v0.44.0（25 skills + 16 agents）· 更新日期：2026-08-17
+> 版本锚点：v0.47.0（26 skills + 17 agents）· 更新日期：2026-08-21
 > 读者：使用 team-flow 做日常研发的工程师。不需要你懂插件内部实现，只需要照着路径走。
 > 配套文档：安装细节见 [INSTALL.md](../INSTALL.md)；状态机细节见 [state-machine.md](state-machine.md)；决策点细节见 [decision-points.md](decision-points.md)；平台差异见 [platform-matrix.md](platform-matrix.md)。
 

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
   "description": "Unified workflow plugin: team-flow (spec-driven dev) + compound-engineering core subset + architecture-design (4A/DDD) + prototype (local HTML) + business-analysis (independent requirement/scenario artifact). 26 skills, one install.",
-  "version": "0.46.0",
+  "version": "0.47.0",
   "contextFileName": "GEMINI.md"
 }

package/hooks/session-start

@@ -1,11 +1,11 @@
 #!/usr/bin/env bash
-# v0.46.0: auto-sync CLI version with plugin version
+# v0.47.0: auto-sync CLI version with plugin version
 set -e
 
 # ═══════════════════════════════════════════════════════════════
 # Plugin version (update this when releasing new versions)
 # ═══════════════════════════════════════════════════════════════
-PLUGIN_VERSION="0.46.0"
+PLUGIN_VERSION="0.47.0"
 
 # ═══════════════════════════════════════════════════════════════
 # Step 1: Auto-sync CLI version with plugin version

package/llms.txt

@@ -3,7 +3,7 @@
 ## Overview
 spec-superflow is a self-contained workflow integration plugin for Claude Code, Cursor, OpenAI Codex CLI/App, GitHub Copilot CLI, Gemini CLI, OpenCode, WorkBuddy, and Trae. It merges spec-driven planning artifacts (proposal, specs, design, tasks) with disciplined execution guardrails (TDD, review gates, controlled handoff) into one unified workflow.
 
-Current version: v0.46.0.
+Current version: v0.47.0.
 
 ## Key Documents
 - README.md: Chinese homepage with full usage guide and FAQ

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xulthekl/team-flow",
-  "version": "0.46.0",
-  "description": "Unified plugin (26 skills + 16 agents) integrating team-flow, compound-engineering, architecture-design, prototype, design-system, workflow-orchestrator, workflow-bootstrap, e2e, session-handoff, workflow-feedback, business-analysis for multi-agent coding tools.",
+  "version": "0.47.0",
+  "description": "Unified plugin (26 skills + 17 agents) integrating team-flow, compound-engineering, architecture-design, prototype, design-system, workflow-orchestrator, workflow-bootstrap, e2e, session-handoff, workflow-feedback, business-analysis for multi-agent coding tools.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "team-flow",
-  "version": "0.46.0",
-  "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact). 26 skills + 16 agents, one install.",
+  "version": "0.47.0",
+  "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact). 26 skills + 17 agents, one install.",
   "author": {
     "name": "LT"
   },

package/skills/ce-brainstorm/SKILL.md

@@ -19,7 +19,7 @@ Brainstorming answers **WHAT** to build through collaborative dialogue, producin
 
 > **显式参数规约**：orchestrator 调用时必须传入 `mode: orchestrated`。ce-brainstorm 检测到该参数即跳过 Phase 3.5 并在输出中回执"原型循环已委托编排层"。未收到该参数时默认为 standalone 模式。
 >
-> **重要：`orchestrated` 模式仅跳过 Phase 3.5（原型内循环）。Phase 0（含 PRD 模板选择）、Phase 1（含 1.4/1.5/1.6）、Phase 2、Phase 3、QA-4、Phase 3.6、版本归档均正常执行，不可跳过。**
+> **重要：`orchestrated` 模式仅跳过 Phase 3.5（原型内循环）。Phase 0（含 PRD 模板选择）、Phase 1（含 1.3b/1.4/1.5/1.6）、Phase 2、Phase 3、QA-4、Phase 3.6、版本归档均正常执行，不可跳过。**
 
 ## Core Principles
 
@@ -40,12 +40,12 @@ Brainstorming answers **WHAT** to build through collaborative dialogue, producin
 | 职责 | 执行方 | 说明 |
 |------|--------|------|
 | 需求澄清、场景确认、流程确认、方案决策 | **主会话** | 需要用户交互和判断的工作 |
-| PRD 文档撰写（Phase 3） | **子代理**（推荐） | 执行性文档生成，主会话做 QA 和冻结 |
+| PRD 文档撰写（Phase 3） | **prd-writer agent**（v0.47） | 执行性文档生成（契约级 §8.4），主会话做 QA 和冻结 |
 | 流程图绘制（mermaid） | **子代理**（推荐） | 基于已确认的流程数据生成图表 |
 | 活动表批量生成 | **子代理**（推荐） | 基于已确认的 L4 子流程生成表格 |
 | 综合报告（synthesis summary） | **子代理**（可选） | 大量数据的汇总整理 |
 
-**子代理委托方式**：使用 `Agent` 工具（`context: fork` 或自定义 agent），将已确认的结构化数据作为输入，要求子代理按模板产出。主会话审查产出后决定接受或修正。
+**子代理委托方式**：使用 `Agent` 工具（`context: fork` 或自定义 agent），将已确认的结构化数据作为输入，要求子代理按模板产出。主会话审查产出后决定接受或修正。PRD 撰写（Phase 3）固定委托命名 agent **prd-writer**（预加载 ce-brainstorm，只执行 Phase 3、不提问）；其余执行性产出（流程图/活动表/综合报告）可委托通用子代理。
 
 ### Stage Breakpoints
 
@@ -155,6 +155,8 @@ For detailed routing logic, read `references/phase0-routing.md`. Summary:
 
 **1.3 Dialogue** — Follow Interaction Rules. Fire blindspot gate (if tripwire armed) and visual-probe gate (before first shape decision). Rigor probes fire as open-ended questions before Phase 2. Before exit: integration check for non-obvious consequences. **Exit when**: primary actor, outcome, scope, success criteria all known or recorded as assumptions.
 
+**1.3b 功能细节澄清（v0.47）** — Follow the brainstorm profile's「功能细节（契约级）」core dimension. Standard/Deep scope **强制契约级澄清**（UI 布局/字段/交互/异常/权限；非 UI 触发/输入输出/处理/异常/幂等并发/性能），Lightweight 简化。产出 **detail_ledger**（`requirement/vN/detail-ledger.md`，逐功能维度 → 已澄清/待澄清/NA），供 Phase 3 §8.4 撰写 + 冻结前 D6 核对。
+
 **1.4 Dialogue Log Persistence** — Automated step, no user interaction. Trigger: Phase 1.3 dialogue exits. Traverse each Q&A round extracting original text + decisions, generate dialogue summary and decision summary table. Write to `requirement/vN/dialogue-log.md` (create or append). No ledger update.
 
 **1.5 Business Scenario Analysis** — Read `references/business-scenarios.md` for methodology. Trigger: Phase 1.4 completed. Extract business scenarios from dialogue and context, produce QA-1 quality check, then **blocking question** for user confirmation. Output: `requirement/vN/business-analysis.md` (requirements + scenarios sections). Status marked 🔵 pending confirmation, ✅ confirmed on user approval. No ledger update at this stage.
@@ -191,34 +193,23 @@ Propose **2-3 approaches** (or recommend directly if one is clearly best). Use n
 - `requirement/ledger.md` — all requirement/scenario/process items and their associations
 - `requirement/vN/dialogue-log.md` — §1.2 revision record reference path
 - `requirement/vN/business-analysis.md` — data source for §2/§3/§7/§8
+- `requirement/vN/detail-ledger.md` — 功能细节澄清产出（v0.47），§8.4 逐功能详述数据源 + D6 核对基准
 
 **⛔ MANDATORY：生成PRD文档前，必须先读取 `references/brainstorm-sections.md`**
 
-**§8.4 功能模块提取规则（关键规则，必须遵守）**：
-- **详细程度**：保留原始需求文档中的关键细节，不要过度概括
-- **必须保留的内容**：
-  - 页面布局（上下分栏、标准列表等）
-  - 搜索模块（具体字段）
-  - 表格列定义（完整字段列表）
-  - 交互规则（默认选中、点击切换、筛选联动等）
-  - 按领域动态字段（如有）
-  - 动态列名说明
-  - 操作说明（已发布/草稿状态等）
-  - 级联选择逻辑（如有）
-- **⛔ 错误行为**：只提取输入/输出/业务规则，丢失原始需求文档中的大量关键细节
-- **⛔ 正确行为**：充分利用原始需求文档的详细内容，保持信息完整性
+**§8.4 功能模块提取规则（v0.47）**：规范唯一权威 = 模板 `templates/prd.md` §8.4「必含维度检查清单」（UI 11 维 / 非 UI 7 维双形态 + NA 机制），**本处不再重复维护维度清单**。生成 PRD 前必须读取模板检查清单，逐功能模块按适用维度详述；维度不适用标注 `NA + 理由`；**未标注 NA 且未覆盖 = 缺失**。
 
 Read `references/brainstorm-sections.md` for doc-warranted criteria. If warranted: read template from `PRD_TEMPLATE_PATH`, fill via `references/prd-mapping.md`, write to `requirement/{ITERATION_VERSION}/prd.md`. Vocabulary capture: update `CONCEPTS.md` with resolved domain terms (only if it exists).
 
-> **子代理委托建议**：Phase 3 PRD 文档撰写是执行性工作，建议委托子代理完成。主会话将已确认的结构化数据（business-analysis.md + dialogue-log.md + synthesis summary）作为输入传给子代理，子代理按模板填充后产出 PRD 草稿，主会话负责 QA-4 审查和冻结确认。
+> **子代理委托（v0.47）**：Phase 3 PRD 撰写委托 **prd-writer** agent。主会话将已确认结构化数据（business-analysis.md + dialogue-log.md + **detail_ledger** + synthesis summary + template_path）作为参数传入；prd-writer 按模板 §8.4 契约级检查清单逐功能详述，不提问、不虚构，`missing_info` 返回主会话决定是否回 Phase 1.3 补澄清。主会话负责 QA-4 审查和冻结确认。
 
 ### Phase 3.5: Prototype Inner Loop
 
-**`orchestrated` mode skips this phase.** For standalone: read `references/prototype-loop.md`. Trigger: PRD has UI functions. Steps: produce prototype → review vs PRD → fix loop (max 3) → completeness review → freeze PRD.
+**`orchestrated` mode skips this phase.** For standalone: read `references/prototype-loop.md`. Trigger: PRD 有 UI 功能则执行原型循环；**完整性评审（§3.5.5）对 standalone 全路径适用**（含非 UI / 跳过原型路径，不因无 UI 而跳过）。Steps: produce prototype → review vs PRD → fix loop (max 3) → completeness review → freeze PRD.
 
 ### QA-4: PRD Quality Check
 
-Fires after Phase 3 (or Phase 3.5 if prototype loop ran). Read `references/evidence-chain-validation.md` for QA-4 criteria. Evaluates PRD completeness and traceability against business analysis artifacts.
+Fires after Phase 3 (or Phase 3.5 if prototype loop ran). Read `references/evidence-chain-validation.md` for QA-4 criteria. Evaluates PRD completeness and traceability against business analysis artifacts. **冻结前完整性评审（6 维，含 §8.4 契约级细节 D6）的派发点已归并**：standalone 路径由 Phase 3.5（`references/prototype-loop.md` §3.5.5）派发 prd-completeness-reviewer；orchestrated 路径由 orchestrator S2 派发（见 `workflow-orchestrator/references/s2-prd-prototype-loop.md`）；**QA-4 自身不重复派发**，仅按评审结果判定是否回 Phase 1.3/Phase 3 修订。
 
 ### Phase 3.6: PRD ↔ Scenario/Process Bidirectional Validation
 
@@ -250,6 +241,7 @@ requirement/
 ├── vN/                                # Iteration version
 │   ├── prd.md                         # PRD document
 │   ├── dialogue-log.md                # Dialogue log (Phase 1.4 output)
+│   ├── detail-ledger.md               # 功能细节澄清产出（v0.47，§8.4 数据源 + D6 核对基准）
 │   └── business-analysis.md           # Business analysis (requirements + scenarios + processes)
 doc/
 └── active-registry/

package/skills/ce-brainstorm/references/brainstorm-sections.md

@@ -267,17 +267,9 @@ as template placeholder.
   所属流程 (BP-xxx). Skip §8.3 (hardware/network) and §8.5 (non-functional)
   unless the brainstorm explicitly covered these.
 
-  **§8.4 功能模块提取规则**：
-  - **详细程度**：保留原始需求文档中的关键细节，不要过度概括
-  - **必须保留的内容**：
-    - 页面布局（上下分栏、标准列表等）
-    - 搜索模块（具体字段）
-    - 表格列定义（完整字段列表）
-    - 交互规则（默认选中、点击切换、筛选联动等）
-    - 按领域动态字段（如有）
-    - 动态列名说明
-    - 操作说明（已发布/草稿状态等）
-    - 级联选择逻辑（如有）
+  **§8.4 功能模块提取规则（v0.47）**：
+  - **规范权威**：模板 `templates/prd.md` §8.4「必含维度检查清单」是唯一权威（UI 11 维/非 UI 7 维双形态 + NA 机制），本文件不再重复维护维度清单。撰写（prd-writer）与审查（prd-completeness-reviewer D6）均以模板为基准。
+  - **详细程度**：保留原始需求文档中的关键细节，不要过度概括（页面布局/搜索字段/表格列/交互规则/动态字段/级联逻辑等——逐项见模板检查清单）
   - **错误行为**：只提取输入/输出/业务规则，丢失原始需求文档中的大量关键细节
   - **正确行为**：充分利用原始需求文档的详细内容，保持信息完整性
 

package/skills/ce-brainstorm/references/evidence-chain-validation.md

@@ -16,7 +16,7 @@ This reference covers three connected operations after PRD generation: QA-4 qual
 | C5 | Consistency | PRD §2 process overview table matches business-analysis.md process list? | Error |
 | C6 | Consistency | PRD §3 process descriptions match business-analysis.md process details? | Error |
 | C7 | Metadata | PRD frontmatter complete (title / project_name / iteration_version / date / prd_template)? | Warning |
-| C8 | Format | §8.4 feature extraction preserves original requirements detail (not over-summarized)? | Warning |
+| C8 | Detail | §8.4 契约级细节：逐功能模块按模板检查清单覆盖适用维度（UI 11 维/非 UI 7 维，单一权威 = 模板 §8.4）+ §7↔§8.4 交叉核对无悬空功能（v0.47 并入 D6 模型：核心维度缺失/悬空 = Critical，辅助维度缺失 = Important） | Critical |
 
 **Verdict rule:** All Error-level checks pass → PASS. Any Error fails → FAIL. Warnings are reported but do not block.
 

package/skills/ce-brainstorm/references/prototype-loop.md

@@ -9,8 +9,8 @@ PRD 文档写入后、Handoff 之前，执行原型内循环。原型是 PRD 的
 检查 PRD 草稿中是否包含 UI/画面/交互相关功能点（§4 画面原型、§7 系统功能清单中的 UI 功能）。
 
 - **包含 UI 功能点** → 使用平台阻塞问题工具询问用户："PRD 包含 UI 功能点，是否需要产出原型进行验证？"
-- **不包含 UI 功能点** → 跳过原型内循环，直接进入 Phase 4
-- **用户选择跳过** → 跳过，PRD 直接冻结
+- **不包含 UI 功能点** → 跳过原型内循环，**先走 §3.5.5 PRD 完整性评审，再冻结（§3.5.6，跳过 prototype-review.md 写入）**，进入 Phase 4
+- **用户选择跳过** → 跳过原型，**先走 §3.5.5 PRD 完整性评审**，再冻结
 
 ## 3.5.2 原型产出
 
@@ -37,19 +37,21 @@ PRD 文档写入后、Handoff 之前，执行原型内循环。原型是 PRD 的
 - **最多循环 3 次**，超过则标记为"需人工介入"，在 PRD 中记录未解决项
 - 每次修正触发复利捕获：`tf solutions capture --phase prd --domain <domain> --type pitfall --severity medium --summary "<修正原因>"`
 
-## 3.5.5 PRD 完整性评审（冻结前门禁）
+## 3.5.5 PRD 完整性评审（冻结前门禁，v0.47 全路径适用）
 
-原型审查通过后、冻结前，派发 `prd-completeness-reviewer` 子代理（独立上下文），评审 PRD「是否完整到能支撑后续 plan/spec 实施」（区别于 Phase 2.6 claim verifier——后者管"说得对不对"，本评审管"说得全不全"）。
+**所有 standalone 路径的冻结前必过门禁**：有原型（原型审查通过后）、无 UI 功能点（§3.5.1）、用户跳过原型（§3.5.1）三条路径均须派发——不因跳过原型循环而跳过完整性评审（orchestrated 路径对应 `s2-prd-prototype-loop.md` step 3.5）。
 
-- 派发：按名派发插件 agent `prd-completeness-reviewer`（定义见插件 `agents/prd-completeness-reviewer.md`），传入 PRD 路径 + CONCEPTS.md 路径。
+派发 `prd-completeness-reviewer` 子代理（独立上下文），评审 PRD「是否完整到能支撑后续 plan/spec 实施」（区别于 Phase 2.6 claim verifier——后者管"说得对不对"，本评审管"说得全不全"）。
+
+- 派发：按名派发插件 agent `prd-completeness-reviewer`（定义见插件 `agents/prd-completeness-reviewer.md`），传入 `prd_path` + `concepts_path`（可选）+ `template_path`（默认 `templates/prd.md`）+ `detail_ledger_path`（如有）。
 - agent 直接写审查报告到 `requirement/{ITERATION_VERSION}/prd-completeness-review.md`。
-- 判定（柔性）：PASS / PASS_WITH_WARNINGS → 进入冻结；**FAIL（Critical>0）→ 回 Phase 1.3 补充**后重审。
-- 5 维度：用户故事完整性(Critical)/验收标准(Critical)/边界与非功能(Important)/术语一致性(Minor)/范围闭环(Important)。
+- 判定（柔性）：PASS / PASS_WITH_WARNINGS → 进入冻结；**FAIL（Critical>0）→ 回 Phase 1.3/Phase 3 补充**后重审。
+- 6 维度：用户故事完整性(Critical)/验收标准(Critical)/边界与非功能(Important)/术语一致性(Minor)/范围闭环(Important)/§8.4 契约级细节（核心维度缺失·悬空功能=Critical，辅助维度缺失=Important）。
 
 ## 3.5.6 冻结
 
 完整性评审通过后：
-1. 写入 `requirement/{ITERATION_VERSION}/prototype-review.md`（审查结论 + 版本 + 日期 + 循环次数）
+1. 写入 `requirement/{ITERATION_VERSION}/prototype-review.md`（审查结论 + 版本 + 日期 + 循环次数；**无原型路径跳过本步**，完整性评审结论已落盘 `prd-completeness-review.md`）
 2. PRD 标记为 frozen（在 PRD frontmatter 中增加 `frozen: true` + `frozen_date: YYYY-MM-DD`），并在正文标题下插入冻结声明（措辞见 `references/prd-mapping.md`「冻结声明」节）
 3. **冻结语义为 `frozen_downstream`（非升版）**：后续阶段（ce-plan、spec-writer）**不可直接回改** PRD；如 plan 或实施暴露 scope 问题，经 **S3→S2 回退在 vN 内修订**并记录「决策与变更履历」（不升版）。**仅当启动新迭代 vN+1 或用户显式绝对冻结（`frozen: absolute`）时才需升版。**
 4. 同步更新正文 §1.1 文档状态为「已冻结-下游」（与 frontmatter `frozen: true` 一致）

package/skills/workflow-orchestrator/SKILL.md

@@ -66,7 +66,7 @@ prd_draft → user_review → prototype_loop → prd_frozen → completed
 - **错误行为**：PRD草稿完成后直接标记S3阶段完成
 - **正确行为**：PRD草稿完成后等待用户查看，确认后继续S2阶段的后续步骤
 
-调用 `/ce-brainstorm`（mode: orchestrated）产出 PRD 草稿；**冻结前派 `prd-completeness-reviewer` 子代理做 PRD 完整性评审**（v0.15.0，管"说得全不全"）；原型循环由编排层直接编排（prototype skill 内部编排产出 → prototype-reviewer 自动评审 → 人工评审 → 冻结）；冻结语义为 `frozen_downstream`（迭代内变更不升版）。反馈环路检查点：scope 是否合理。详见 `references/s2-prd-prototype-loop.md`。
+调用 `/ce-brainstorm`（mode: orchestrated）产出 PRD 草稿（Phase 3 由 prd-writer agent 契约级撰写，v0.47）；**冻结前派 `prd-completeness-reviewer` 子代理做 PRD 完整性评审**（v0.15.0，管"说得全不全"；v0.47 并入 §8.4 契约级细节 D6 维度）；原型循环由编排层直接编排（prototype skill 内部编排产出 → prototype-reviewer 自动评审 → 人工评审 → 冻结）；冻结语义为 `frozen_downstream`（迭代内变更不升版）。反馈环路检查点：scope 是否合理。详见 `references/s2-prd-prototype-loop.md`。
 
 ### ARCH: 产品级架构设计（v0.36.0 新增；2026-08-19 LT 调整上移 S3 前——S3 计划/S4 拆分是最终任务拆分，须基于架构）
 

package/skills/workflow-orchestrator/references/s2-prd-prototype-loop.md

@@ -56,7 +56,7 @@ PRD草稿生成后：
 ### 2. 判断是否需要原型
 
 - 需要（涉及 UI/交互/页面）→ 进入原型循环
-- 不需要（纯后端/无 UI）→ PRD 直接冻结，跳到步骤 5
+- 不需要（纯后端/无 UI）→ **先走步骤 3.5 完整性评审**，再冻结，跳到步骤 5
 
 ### 3. 原型循环（编排层控制）
 
@@ -78,6 +78,14 @@ PRD草稿生成后：
 
 **人工介入 = 编排层阻塞确认**（非 subagent，因 subagent 不能 AskUserQuestion），呈现争议项 + 选项（接受现状 / 指定修正方向 / 升版 / 放弃原型）。
 
+### 3.5 PRD 完整性评审（冻结前门禁，v0.47）
+
+**orchestrated 路径下完整性评审由编排层在此派发**（standalone 路径由 ce-brainstorm Phase 3.5 内部派发，见 ce-brainstorm `references/prototype-loop.md` §3.5.5）。
+
+- 派发：按名派发插件 agent `prd-completeness-reviewer`（6 维，含 §8.4 契约级细节 D6），传入 `prd_path` + `concepts_path`（可选）+ `template_path`（默认 `templates/prd.md`）+ `detail_ledger_path`（如有）。
+- 判定：PASS / PASS_WITH_WARNINGS → 进入步骤 4 冻结；**FAIL（Critical>0：D1/D2/D6 核心维度缺失、D6 悬空功能）→ 回 ce-brainstorm Phase 1.3/Phase 3 修订后重审**。
+- **适用性**：需要原型（步骤 3 完成后）与不需要原型（纯后端无 UI，步骤 2 后）两条路径**均必须派发**——不因跳过原型循环而跳过完整性评审。
+
 ### 4. 冻结
 
 设置 `frozen_downstream`（见 state-model.md「双层冻结」）。冻结后，**迭代内变更不升版**，在 vN 内修订 + 记录决策/变更履历。
@@ -134,5 +142,6 @@ tf solutions capture --phase prd --domain <domain> --type pitfall --severity <se
 ## 完成条件
 
 - `requirement/vN/prd.md` frontmatter `frozen: true`（frozen_downstream 已设置）
+- `requirement/vN/prd-completeness-review.md` 已落盘（step 3.5 完整性评审门禁，v0.47）
 - 如需原型：`requirement/vN/prototype-auto-review.md` 已落盘且 verdict 为 PASS / PASS_WITH_WARNINGS（人工已裁定）
 - `.team-flow/requirements/<req-id>/orchestrator.yaml` 中 S2 状态 = completed，`prd_version` 已记录

package/templates/prd-brainstorm-profile.md

@@ -14,12 +14,15 @@ Phase 2 产出的每个方案必须覆盖核心维度，按需覆盖扩展维度
 | 数据关系 | §4.3 信息结构图 | 核心业务实体之间的关联规则是什么？实体间的层级/归属/引用关系？ |
 | 业务规则 | §8.2.4 其他机制与规则 | 排序规则？搜索规则？加载机制？异常处理？校验逻辑？ |
 | 系统功能 | §7 D7.5 系统功能清单 | 需要哪些功能点？每个功能点关联哪个业务流程/活动？ |
+| 功能细节（契约级） | §8.4 功能模块详细说明 | UI 功能：每个功能的页面布局/字段/交互/异常/权限是什么？非 UI 功能：触发条件/输入输出/处理步骤/异常/幂等并发/性能是什么？ |
+
+> **功能细节澄清分级（v0.47）**：按功能复杂度分级——Standard/Deep scope **强制契约级澄清**（布局/字段/交互/异常/权限 或 触发/输入输出/处理/异常/幂等并发/性能），Lightweight scope 简化澄清（需求已足够清晰时）。澄清产出 **detail_ledger**（逐功能维度 → 已澄清/待澄清/NA），作为 §8.4 撰写数据源 + prd-completeness-reviewer D6 核对基准。
 
 ## 扩展思考维度（按需触发）
 
 | 维度 | 触发条件 | 对应 PRD 章节 | 引导问题 |
 |------|---------|-------------|---------|
-| 画面设计 | 涉及 UI 交互 | §4 D7.2 | 画面结构如何？页面间如何迁移？ |
+| 画面设计 | 涉及 UI 交互 | §4 D7.2 | 画面结构如何？页面间如何迁移？（视觉层面辅助，功能细节见核心维度「功能细节（契约级）」） |
 | 业务术语 | 出现领域专有名词 | §6 D7.4 | 哪些术语需要统一定义？有无同义词？ |
 | 报表需求 | 用户提到"报表/统计/分析" | §5 D7.3 | 需要哪些报表？关联哪些流程和数据？ |
 | 交互机制 | 有特殊交互需求 | §8.2.2 | 键盘/画面/弹层交互细节？ |

package/templates/prd.md

@@ -267,13 +267,42 @@
 
 ### 8.4 功能模块详细说明
 
+**契约级详述规范（v0.47）**：每个功能模块按下述「必含维度检查清单」逐项详述。UI 功能覆盖 11 维、非 UI 功能覆盖 7 维（按「功能形态」选择其一）；维度不适用时标注 `NA + 理由`；**缺失适用维度 = PRD 不完整**；核心维度缺失将判 FAIL，辅助维度缺失为 PASS_WITH_WARNINGS 交人工裁定（prd-completeness-reviewer D6，v0.47）。规范唯一权威为本节——撰写 agent（prd-writer）与审查 agent 均读取本节获得检查清单，不在他处重复维护。
+
 #### 8.4.1 {模块名称}
 
 ##### 8.4.1.1 {功能名称}
 
-| 编号 | 系统功能 | 原型/UI | 关联活动 | 信息结构 | 画面说明 |
-|---|---|---|---|---|---|
-| {编号} | {功能名} | {原型截图} | {活动编号} | {信息结构列表} | {画面说明} |
+| 功能形态 | UI 功能 / 非 UI 功能 | | |
+|---|---|---|---|
+| 所属流程 | BP-{xxx} | 关联需求 | REQ-{xxx} |
+| 关联场景 | SC-{xxx} | 功能概述 | {1-2 句；若不能一句话说清，先拆分功能} |
+
+**UI 功能必含维度（11 维）**：
+
+- [ ] 页面布局：{布局结构（上下分栏/标准列表等）}
+- [ ] 权限规则：{角色/状态/操作权限；与 §8.2.1 全局权限的差异}
+- [ ] 区块说明：{各区块内容与职责}
+- [ ] 搜索模块：{搜索组件/占位符/选项/筛选联动}
+- [ ] 表格列定义：{完整列清单：列名/类型/格式/排序}
+- [ ] 交互规则：{默认选中/点击切换/筛选联动/级联选择逻辑等}
+- [ ] 弹层结构：{弹层触发/内容/交互}
+- [ ] 动态字段：{按领域动态字段/动态列名说明}
+- [ ] 导入导出规则：{格式/字段映射/校验}
+- [ ] 状态操作差异：{已发布/草稿/已停用等状态下的操作差异}
+- [ ] 异常边界：{空态/错误态/并发/极值}
+
+**非 UI 功能必含维度（7 维）**：
+
+- [ ] 触发条件：{定时/事件/手动触发}
+- [ ] 输入输出：{输入参数/输出结果/格式}
+- [ ] 处理步骤：{处理流程/算法/业务规则}
+- [ ] 异常处理：{异常场景/重试/补偿}
+- [ ] 权限角色：{可执行角色/鉴权}
+- [ ] 幂等并发：{幂等性/并发控制}
+- [ ] 性能约束：{耗时/吞吐/资源}
+
+> **NA 机制**：维度不适用时标注 `NA + 一句理由`（如 `页面布局：NA，后台批处理无画面`）；**未标注 NA 且未覆盖 = 缺失**，审查将判 FAIL。
 
 ### 8.5 非功能性需求说明