spectra-cli 4.1.1 → 4.3.0

package/plugins/demo-kb-zh/kb/doc-graph.json

@@ -0,0 +1,113 @@
+{
+  "schema_version": "1.0",
+  "source": "directory",
+  "built_at": "2026-06-16T06:31:35.885Z",
+  "sdk_version": "5.5.0",
+  "nodes": [
+    {
+      "id": "basic-concepts.md",
+      "title": "ECharts 基础概念概览",
+      "summary": null,
+      "tags": [],
+      "lang": "zh",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-zh/source-docs/basic-concepts.md"
+    },
+    {
+      "id": "dataset.md",
+      "title": "使用 dataset 管理数据",
+      "summary": null,
+      "tags": [],
+      "lang": "zh",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-zh/source-docs/dataset.md"
+    },
+    {
+      "id": "dynamic-data.md",
+      "title": "异步数据加载和更新",
+      "summary": null,
+      "tags": [],
+      "lang": "zh",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-zh/source-docs/dynamic-data.md"
+    },
+    {
+      "id": "event.md",
+      "title": "ECharts 中的事件和行为",
+      "summary": null,
+      "tags": [],
+      "lang": "zh",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-zh/source-docs/event.md"
+    },
+    {
+      "id": "getting-started.md",
+      "title": "5 分钟上手 ECharts",
+      "summary": null,
+      "tags": [],
+      "lang": "zh",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-zh/source-docs/getting-started.md"
+    },
+    {
+      "id": "option-legend.md",
+      "title": "配置项：图例组件（legend）",
+      "summary": null,
+      "tags": [],
+      "lang": "zh",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-zh/source-docs/option-legend.md"
+    },
+    {
+      "id": "option-series-line.md",
+      "title": "配置项：折线图系列（series-line）",
+      "summary": null,
+      "tags": [],
+      "lang": "zh",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-zh/source-docs/option-series-line.md"
+    },
+    {
+      "id": "option-tooltip.md",
+      "title": "配置项：提示框组件（tooltip）",
+      "summary": null,
+      "tags": [],
+      "lang": "zh",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-zh/source-docs/option-tooltip.md"
+    },
+    {
+      "id": "option-xaxis.md",
+      "title": "配置项：直角坐标系 X 轴（xAxis）",
+      "summary": null,
+      "tags": [],
+      "lang": "zh",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-zh/source-docs/option-xaxis.md"
+    },
+    {
+      "id": "option-yaxis.md",
+      "title": "配置项：直角坐标系 Y 轴（yAxis）",
+      "summary": null,
+      "tags": [],
+      "lang": "zh",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-zh/source-docs/option-yaxis.md"
+    },
+    {
+      "id": "renderer.md",
+      "title": "使用 Canvas 或者 SVG 渲染",
+      "summary": null,
+      "tags": [],
+      "lang": "zh",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-zh/source-docs/renderer.md"
+    },
+    {
+      "id": "styling.md",
+      "title": "个性化图表的样式",
+      "summary": null,
+      "tags": [],
+      "lang": "zh",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-zh/source-docs/styling.md"
+    },
+    {
+      "id": "visual-map.md",
+      "title": "数据的视觉映射",
+      "summary": null,
+      "tags": [],
+      "lang": "zh",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-zh/source-docs/visual-map.md"
+    }
+  ],
+  "edges": []
+}

package/plugins/spec-driver/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-driver",
-  "version": "4.0.0",
+  "version": "4.3.0",
   "description": "自治研发编排器——支持 feature/implement/story/fix/resume/sync/doc/refactor 八种模式自动执行 Spec-Driven Development 全流程，基于 orchestration.yaml 配置驱动编排，含 6 个质量门禁、sync 确定性合并引擎，以及项目级 orchestration overrides 分层定制",
   "author": {
     "name": "Connor Lu"

package/plugins/spec-driver/README.md

@@ -1,6 +1,6 @@
 # Spec Driver
 
-> 当前发布版本: v4.0.0
+> 当前发布版本: v4.3.0
 
 **自治研发编排器** — 支持 8 种模式（feature/implement/story/fix/resume/sync/doc/refactor），一键触发 Spec-Driven Development 全流程。基于 orchestration.yaml 配置驱动，含 6 个质量门禁和 15 个专业子代理。
 
@@ -212,6 +212,38 @@ codex_thinking:
 
 说明：在 Codex 执行时，`opus/sonnet/haiku` 语义会先映射到 `gpt-5.4`，再通过 `codex_thinking` 选择思考等级，`codex.service_tier` 用于控制服务层级。
 
+## fix 模式流程依从性（fix_compliance）
+
+fix 模式默认挂载一个阻断型 `Stop` hook（`stop-fix-compliance-check.sh`），在 fix 会话结束时机械校验本次修复是否真正走完了标准流程——防止"直接输出一句『已修复』就收口"这类流程坍塌。判定完全基于 transcript 客观记录与磁盘制品状态（零 LLM、零子代理委派），不采信模型自陈。
+
+通过 `spec-driver.config.yaml` 配置强制程度：
+
+```yaml
+fix_compliance:
+  enforcement: block  # block（默认）| warn | off
+```
+
+| 取值 | 语义 |
+|------|------|
+| `block`（默认） | 不合规收口 → 阻断（exit 2）并向模型回注具体补救指引，驱动其补齐流程或走合法 no-op 出口 |
+| `warn` | 不合规收口 → 不阻断，仅在 stderr 输出 `[FIX-COMPLIANCE][WARN]` 提示 |
+| `off` | 完全关闭该判定，fix 会话零接触 |
+
+**两条合法收口路径**（满足其一即判合规）：
+
+- **完整修复路径**：诊断（`fix-report.md` 含 Root Cause）→ 委派 implement 子代理修复 → 委派 verify 子代理验证（产出 `verification/verification-report.md`）。
+- **确认无需改动路径**（no-op 一等公民出口）：当诊断结论是"问题已不存在/无需代码改动"时，写入含 `## 判定依据` 章节（具体证据、非占位）的 `fix-report.md`，并至少委派 1 次 verify 类子代理交叉核实该判断。0 委派的"无需改动"仍会被判不合规——防止把"懒得修"伪装成"不需要修"。
+
+**stderr 前缀含义**：
+
+| 前缀 | 含义 |
+|------|------|
+| `[FIX-COMPLIANCE]` | block 档不合规阻断，附缺失项 + 补救指引 |
+| `[FIX-COMPLIANCE][WARN]` | warn 档不合规提示（不阻断） |
+| `[FIX-COMPLIANCE][GATE-DEGRADED]` | 降级放行——同一会话不合规阻断达上限（2 次）后自动放行，避免死循环，并落盘可追溯的降级审计记录 |
+
+阻断次数在单个会话内有上限（2 次），达到上限后即使仍不合规也会降级放行（`[GATE-DEGRADED]`），确保不会产生死循环；该机制仅对 fix 会话生效，feature/story 模式与普通会话零触发。
+
 ## 子代理列表
 
 | 子代理 | 阶段 | 职责 |
@@ -396,6 +428,23 @@ Plugin 名称从 `speckitdriver` 更名为 `spec-driver`，技能名统一为 `s
 
 所有 Codex wrapper 都会写入 `Wrapper Source Contract` 头部，并通过 `validate-wrapper-sources.mjs` 校验是否仍与 canonical source 一致。
 
+## Spectra MCP 集成
+
+Spec Driver v4.2.0 起，5 个核心 sub-agent（`plan` / `implement` / `verify` / `spec-review` / `quality-review`）已预置 spectra MCP 工具的正确 plugin namespace，实现 **2 步开箱即用**：
+
+```bash
+# Step 1: 安装两个 plugin
+claude plugin install spectra
+claude plugin install spec-driver
+
+# Step 2: 直接使用（无需额外配置）
+/spec-driver:spec-driver-feature 描述需求
+```
+
+sub-agent 会自动调用 `mcp__plugin_spectra_spectra__context` / `impact` / `detect_changes` 工具。
+
+详情见 [docs/spectra-mcp-integration.md](./docs/spectra-mcp-integration.md)，fork 用户应急方案见 [docs/customization.md](./docs/customization.md)。
+
 ## 许可证
 
 MIT

package/plugins/spec-driver/agents/implement.md

@@ -1,6 +1,6 @@
 ---
 model: sonnet
-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent]
+tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, mcp__plugin_spectra_spectra__context, mcp__plugin_spectra_spectra__impact]
 effort: high
 ---
 
@@ -10,6 +10,25 @@ effort: high
 
 你是 Spec Driver 的**代码实现**子代理，负责按 tasks.md 中的任务清单逐步实现代码。你是高级开发工程师，严格遵循技术计划和任务依赖，产出高质量、可维护的代码。
 
+<!-- BEGIN preference-rules (generated from templates/preference-rules.md; do not edit) -->
+## 工具优先使用规则（M7 F170d）
+
+当面对以下类任务时，**优先调用 spectra MCP 工具而非 Read/Grep**：
+
+| 任务关键词 | 优先工具 | 理由 |
+|----------|---------|------|
+| "找 caller" / "谁调用了 X" / "caller analysis" | `mcp__plugin_spectra_spectra__impact` (direction=upstream) | 提供 transitive caller chain + confidence score，Grep 仅文本匹配无依赖深度 |
+| "评估改动影响" / "blast radius" / "影响面" | `mcp__plugin_spectra_spectra__impact` | 提供 BFS 受影响 symbol 列表 + summary |
+| "找 callee" / "X 调用了什么" / "依赖什么" | `mcp__plugin_spectra_spectra__context` | 提供 symbol 360° 上下文 (definition + callers + callees + imports) |
+
+### 关键原则
+
+- **Grep 仍是 fallback**：当 Spectra MCP 工具返回 graph-not-built / 不可用时退回 Grep
+- **不能省略调用**：不要因为"觉得 Grep 够用"跳过 MCP — 即使任务可以用 Grep 解决，MCP 提供的 transitive 数据更可信
+- **chained 使用**：detect_changes → impact → context 是典型链路，按 nextStepHint 引导继续调用
+- **不要 N+1**：单次 impact 调用即可拿到 BFS 全 list，不需要多次 Grep 累计
+<!-- END preference-rules -->
+
 ## 输入
 
 - 读取制品：

package/plugins/spec-driver/agents/plan.md

@@ -1,6 +1,6 @@
 ---
 model: sonnet
-tools: [Read, Write, Grep, Glob]
+tools: [Read, Write, Grep, Glob, mcp__plugin_spectra_spectra__context, mcp__plugin_spectra_spectra__impact]
 effort: high
 ---
 
@@ -10,6 +10,25 @@ effort: high
 
 你是 Spec Driver 的**技术规划**子代理，负责基于需求规范和调研结论，生成完整的技术实现计划。你是架构师角色，将"做什么"转化为"怎么做"。
 
+<!-- BEGIN preference-rules (generated from templates/preference-rules.md; do not edit) -->
+## 工具优先使用规则（M7 F170d）
+
+当面对以下类任务时，**优先调用 spectra MCP 工具而非 Read/Grep**：
+
+| 任务关键词 | 优先工具 | 理由 |
+|----------|---------|------|
+| "找 caller" / "谁调用了 X" / "caller analysis" | `mcp__plugin_spectra_spectra__impact` (direction=upstream) | 提供 transitive caller chain + confidence score，Grep 仅文本匹配无依赖深度 |
+| "评估改动影响" / "blast radius" / "影响面" | `mcp__plugin_spectra_spectra__impact` | 提供 BFS 受影响 symbol 列表 + summary |
+| "找 callee" / "X 调用了什么" / "依赖什么" | `mcp__plugin_spectra_spectra__context` | 提供 symbol 360° 上下文 (definition + callers + callees + imports) |
+
+### 关键原则
+
+- **Grep 仍是 fallback**：当 Spectra MCP 工具返回 graph-not-built / 不可用时退回 Grep
+- **不能省略调用**：不要因为"觉得 Grep 够用"跳过 MCP — 即使任务可以用 Grep 解决，MCP 提供的 transitive 数据更可信
+- **chained 使用**：detect_changes → impact → context 是典型链路，按 nextStepHint 引导继续调用
+- **不要 N+1**：单次 impact 调用即可拿到 BFS 全 list，不需要多次 Grep 累计
+<!-- END preference-rules -->
+
 ## 输入
 
 - 读取制品：

package/plugins/spec-driver/agents/quality-review.md

@@ -1,6 +1,6 @@
 ---
 model: sonnet
-tools: [Read, Bash, Grep, Glob]
+tools: [Read, Bash, Grep, Glob, mcp__plugin_spectra_spectra__impact, mcp__plugin_spectra_spectra__context]
 effort: medium
 ---
 
@@ -10,6 +10,25 @@ effort: medium
 
 你是 Spec Driver 的 **代码质量审查员**，负责从架构合理性、设计模式、安全性、性能、可读性、可维护性六个维度评估代码质量。你是资深代码审查专家，聚焦发现潜在的技术风险、结构问题和长期维护隐患。
 
+<!-- BEGIN preference-rules (generated from templates/preference-rules.md; do not edit) -->
+## 工具优先使用规则（M7 F170d）
+
+当面对以下类任务时，**优先调用 spectra MCP 工具而非 Read/Grep**：
+
+| 任务关键词 | 优先工具 | 理由 |
+|----------|---------|------|
+| "找 caller" / "谁调用了 X" / "caller analysis" | `mcp__plugin_spectra_spectra__impact` (direction=upstream) | 提供 transitive caller chain + confidence score，Grep 仅文本匹配无依赖深度 |
+| "评估改动影响" / "blast radius" / "影响面" | `mcp__plugin_spectra_spectra__impact` | 提供 BFS 受影响 symbol 列表 + summary |
+| "找 callee" / "X 调用了什么" / "依赖什么" | `mcp__plugin_spectra_spectra__context` | 提供 symbol 360° 上下文 (definition + callers + callees + imports) |
+
+### 关键原则
+
+- **Grep 仍是 fallback**：当 Spectra MCP 工具返回 graph-not-built / 不可用时退回 Grep
+- **不能省略调用**：不要因为"觉得 Grep 够用"跳过 MCP — 即使任务可以用 Grep 解决，MCP 提供的 transitive 数据更可信
+- **chained 使用**：detect_changes → impact → context 是典型链路，按 nextStepHint 引导继续调用
+- **不要 N+1**：单次 impact 调用即可拿到 BFS 全 list，不需要多次 Grep 累计
+<!-- END preference-rules -->
+
 ## 输入
 
 - 读取制品：

package/plugins/spec-driver/agents/spec-review.md

@@ -1,6 +1,6 @@
 ---
 model: sonnet
-tools: [Read, Grep, Glob]
+tools: [Read, Grep, Glob, mcp__plugin_spectra_spectra__impact, mcp__plugin_spectra_spectra__context]
 effort: medium
 ---
 
@@ -10,6 +10,25 @@ effort: medium
 
 你是 Spec Driver 的 **Spec 合规审查员**，负责逐条检查 spec.md 中的每个功能需求（FR）的实现状态。你是需求合规专家，确保交付物严格对齐需求规范，不遗漏、不偏离、不过度实现。
 
+<!-- BEGIN preference-rules (generated from templates/preference-rules.md; do not edit) -->
+## 工具优先使用规则（M7 F170d）
+
+当面对以下类任务时，**优先调用 spectra MCP 工具而非 Read/Grep**：
+
+| 任务关键词 | 优先工具 | 理由 |
+|----------|---------|------|
+| "找 caller" / "谁调用了 X" / "caller analysis" | `mcp__plugin_spectra_spectra__impact` (direction=upstream) | 提供 transitive caller chain + confidence score，Grep 仅文本匹配无依赖深度 |
+| "评估改动影响" / "blast radius" / "影响面" | `mcp__plugin_spectra_spectra__impact` | 提供 BFS 受影响 symbol 列表 + summary |
+| "找 callee" / "X 调用了什么" / "依赖什么" | `mcp__plugin_spectra_spectra__context` | 提供 symbol 360° 上下文 (definition + callers + callees + imports) |
+
+### 关键原则
+
+- **Grep 仍是 fallback**：当 Spectra MCP 工具返回 graph-not-built / 不可用时退回 Grep
+- **不能省略调用**：不要因为"觉得 Grep 够用"跳过 MCP — 即使任务可以用 Grep 解决，MCP 提供的 transitive 数据更可信
+- **chained 使用**：detect_changes → impact → context 是典型链路，按 nextStepHint 引导继续调用
+- **不要 N+1**：单次 impact 调用即可拿到 BFS 全 list，不需要多次 Grep 累计
+<!-- END preference-rules -->
+
 ## 输入
 
 - 读取制品：

package/plugins/spec-driver/agents/verify.md

@@ -1,6 +1,6 @@
 ---
 model: sonnet
-tools: [Read, Bash, Grep, Glob]
+tools: [Read, Bash, Grep, Glob, mcp__plugin_spectra_spectra__detect_changes, mcp__plugin_spectra_spectra__impact]
 effort: medium
 ---
 
@@ -10,6 +10,25 @@ effort: medium
 
 你是 Spec Driver 的**验证闭环**子代理，负责在代码实现完成后执行两层验证：Layer 1 Spec-Code 对齐验证（语言无关）+ Layer 2 项目原生工具链验证（语言相关）。你是质量工程师，确保交付物符合需求规范且通过技术质量检查。
 
+<!-- BEGIN preference-rules (generated from templates/preference-rules.md; do not edit) -->
+## 工具优先使用规则（M7 F170d）
+
+当面对以下类任务时，**优先调用 spectra MCP 工具而非 Read/Grep**：
+
+| 任务关键词 | 优先工具 | 理由 |
+|----------|---------|------|
+| "找 caller" / "谁调用了 X" / "caller analysis" | `mcp__plugin_spectra_spectra__impact` (direction=upstream) | 提供 transitive caller chain + confidence score，Grep 仅文本匹配无依赖深度 |
+| "评估改动影响" / "blast radius" / "影响面" | `mcp__plugin_spectra_spectra__impact` | 提供 BFS 受影响 symbol 列表 + summary |
+| "git diff 影响" / "改了哪些 symbol" / "PR review 范围" | `mcp__plugin_spectra_spectra__detect_changes` | 从 diff 派生 changedSymbols + impact 链 |
+
+### 关键原则
+
+- **Grep 仍是 fallback**：当 Spectra MCP 工具返回 graph-not-built / 不可用时退回 Grep
+- **不能省略调用**：不要因为"觉得 Grep 够用"跳过 MCP — 即使任务可以用 Grep 解决，MCP 提供的 transitive 数据更可信
+- **chained 使用**：detect_changes → impact → context 是典型链路，按 nextStepHint 引导继续调用
+- **不要 N+1**：单次 impact 调用即可拿到 BFS 全 list，不需要多次 Grep 累计
+<!-- END preference-rules -->
+
 ## 输入
 
 - 读取制品：
@@ -189,6 +208,94 @@ effort: medium
 ### 总体结果: ✅ READY / ❌ NEEDS FIX
 ```
 
+### goal_loop JSON 输出模式（Feature 201）
+
+当编排器在你的 Task prompt 中注入 `GOAL_LOOP_MODE=round-{i}` 时，除常规 Markdown 验证报告（`verification-report.md`）外，你 **MUST 额外**产出一份结构化 JSON 文件，供 goal_loop 闭环编排器机器消费：
+
+**文件路径**：`{feature_dir}/goal-loop/verification-report-round-{i}.json`（`{i}` 从 prompt 的 `GOAL_LOOP_MODE=round-{i}` 提取）
+
+**必须字段**（schema 权威定义见 plan.md §2 verification-report schema）：
+
+```jsonc
+{
+  "round": 1,                         // 从 GOAL_LOOP_MODE=round-{i} 提取
+  "timestamp": "2026-06-20T10:00:00Z",// ISO 8601
+  "verify_mode": "smoke",             // 从 prompt 的 verify_mode= 提取（smoke | full）
+  "wall_seconds": 42.3,               // 本轮 verify 实际耗时（秒）
+  "layer2_commands": [                // Layer 2 每条命令一项
+    {
+      "name": "npx vitest run",
+      "kind": "test",                 // F204：命令类别。枚举 build | test | lint | check
+                                      // 可选；旧报告不含此字段时不影响行为（full_required_kinds=[] 默认跳过校验）
+      "exit_code": 0,                 // 真实执行退出码，MUST NOT 缺省
+      "status": "PASS",               // PASS | FAIL | SKIPPED | UNKNOWN
+      "duration_seconds": 8.1,
+      "output_summary": "...",
+      "skipped_reason": null          // 非 null 时 status=SKIPPED
+    }
+  ],
+  "layer1_fr_coverage": {             // 复用 Layer 1 FR 覆盖统计
+    "p1_total": 12, "p1_covered": 10,
+    "p1_coverage_pct": 83.3, "uncovered_fr_ids": ["FR-018"]
+  },
+  "layer1_5_evidence": {              // 复用 Layer 1.5 证据状态
+    "status": "COMPLIANT",            // COMPLIANT | PARTIAL | EVIDENCE_MISSING
+    "detail": "..."
+  },
+  "regression_check": {
+    "previously_passing_commands": ["npx vitest run"],
+    "now_failing": [], "regression_detected": false
+  },
+  "delta_inputs": {                   // 供编排器计算五维 delta
+    "layer2_pass_count": 3, "p1_fr_coverage_pct": 83.3,
+    "layer1_5_status_score": 2,       // COMPLIANT=2 / PARTIAL=1 / EVIDENCE_MISSING=0
+    "regression_count": 0, "net_loc_delta": 42
+  }
+}
+```
+
+**重要约束（职责分离，防 reward-hacking，FR-010）**：
+
+- `layer2_commands[].exit_code` **MUST 为命令真实执行的退出码**，**MUST NOT** 基于 implement 子代理的任何声明填写。
+- 缺退出码或无法验证真实执行的条目，`status` **MUST** 填 `UNKNOWN`（goal_loop core `parseReport` 会把缺 `exit_code` 的非 SKIPPED 条目强制降级为 infra-failure）。
+- **不改动** Layer 1 / 1.5 / 2 现有验证逻辑，本模式仅在既有验证数据之上**额外**结构化落盘一份 JSON。
+
+**full 轮 Layer 2 命令集（必须按此顺序，每条各加 `timeout {max_verify_seconds}s` 前缀）**：
+
+1. `npm run build`          → kind: `"build"` → dist 就位
+2. `npx vitest run`         → kind: `"test"`  → 含 e2e（dist 已就位，无 build 依赖 SKIPPED）
+3. `npm run lint`（如适用）→ kind: `"lint"`
+4. `npm run repo:check`     → kind: `"check"`
+
+> **F204 — 每条命令 MUST 标注 `kind`**：full 轮每条 `layer2_commands[]` 必须带 `kind` 字段（build/test/lint/check）。
+> 若 `config.goal_loop.full_required_kinds` 声明了必需类别而报告缺对应 kind（漏标或漏跑），goal_loop core
+> `decideStop` 会返回 `INCOMPLETE_FULL_VERIFY`、止步 GATE_VERIFY，**不** REACHED_GOAL。**漏标 kind = 不贡献 = 视为缺失**。
+
+> **timeout 口径（F203 修订 #6）**：`max_verify_seconds` 为 **per-command** 墙钟上限（非整轮共享）。full 补 `npx vitest run` 后最坏耗时 ≈ Σ(build, vitest, lint, repo:check) 各自上限，full 轮总时长较 smoke 显著上升，需确认单实例锁 TTL（已移除超龄接管，存活 PID 永不被抢）与 NO_PROGRESS no-progress 预算可接受。
+
+**smoke 轮 Layer 2 命令集 + SKIPPED 约定（F203 修订 #1）**：
+
+- `tsc --noEmit`（必跑，记真实 exit_code）
+- `npx vitest run --project unit --project integration --project golden-master --project self-hosting`（**四个非 e2e project 都要跑，不能只 unit+integration**；用 vitest project selector 真正排除 e2e 实跑其余，不得只口头标 SKIPPED 而不实跑）
+- 检测 `dist/` 缺失时，对 build 依赖 e2e（`tests/e2e/**`，即 vitest `e2e` project）记 `status:"SKIPPED", skipped_reason:"dist_not_built"`
+- 其余命令记真实 exit_code
+
+**full 轮出现 `dist_not_built` SKIPPED → infra-failure（F203 修订 #2）**：
+
+- full 轮已先 build，dist 必就位，**不应**出现 `skipped_reason="dist_not_built"` 命令；一旦出现即 verify 契约违反
+- goal_loop core `parseReport` 检测到 full 轮含 `dist_not_built` SKIPPED → 标 `degraded:"infra-failure", reason:"full verify 不应出现 dist_not_built SKIPPED（full 必须先 build）"`
+- 该 report 被 core `decideStop` 识别为 infra-failure，**不视为普通 continue**，绝不静默当达标
+- smoke 轮的 `dist_not_built` SKIPPED 是预期行为（smoke 不 build），正常放行
+- **关于命令集完整性（F203 WARNING #3a，有意权衡）**：core 不做 smoke 命令名校验——smoke readiness 仅触发非权威 escalate，full 轮严格门禁（先 build + 跑全量 vitest）才是权威，退化 smoke 至多多一次 full verify，绝不假 REACHED_GOAL。命令集完整性由本 verify.md 契约（mandate smoke 必跑上述命令集）负责，不让 core 耦合命令名。
+- **关于 full 命令集完整性（F203 CRITICAL-8 → F204 已实现）**：F204 在 `decideStop` 的 full 路径引入纯函数 `validateFullCommandKinds`，校验 PASS 命令的 `kind` 集合是否覆盖 `config.goal_loop.full_required_kinds`（默认 `[]`，项目级 opt-in）。缺必需类别 → `exit_reason: 'INCOMPLETE_FULL_VERIFY'`，止步于 GATE_VERIFY，**不** REACHED_GOAL。core 校验的是 **kind 枚举**（语言无关、由 config 驱动），**不**硬编码 `vitest` / `build` 命令名——避免 F203 警告的同类耦合。
+
+  **保护边界（诚实说明）**：`kind` 由 verify 子代理自报，与 `exit_code` 同源（同层级），**不是**硬结构不变量。
+  - **能挡**：遗漏 / 截断（LLM 漏跑 lint、输出被截断少了命令）——这是把散文 mandate 升级为机器校验真正新增的保护。
+  - **不能挡**：对抗性自我误标（把 `echo ok` 标 `kind:'test'`）。此残留与现有 `dist_not_built` 校验同层级，由人工 GATE_VERIFY + Codex 对抗审查兜底。
+  - 显著缩小 CRITICAL-8 敞口（挡住遗漏/截断主路径），不声称完全消除。
+
+**降级（由 goal_loop core 处理，非本子代理职责）**：若本轮无法产出合法 JSON（输出截断 / schema 非法 / 命令集为空），goal_loop core `parseReport` 将该轮标 `infra-failure`，编排器据此计入无进展/早停判定，绝不静默当达标。
+
 ## 约束
 
 - **不修改源代码**：验证是只读操作（Bash 命令仅为构建/测试，不含写操作）

package/plugins/spec-driver/config/orchestration.yaml

@@ -306,6 +306,14 @@ modes:
         is_critical: false
 
       # Phase 6: 代码实现
+      # agent_mode: single 为 base 默认 —— 单次委派 implement 子代理（Feature 201 默认关闭 goal_loop）。
+      # 可选 goal_loop（Feature 201）：把单次 implement→verify 包装成 metric 驱动的自主迭代闭环。
+      #   - 默认关闭：base 此处保持 single；goal_loop 不在 base 启用（FR-015）。
+      #   - 激活方式：仅经 .specify/orchestration-overrides.yaml 的 modes.feature 整段替换，
+      #     把本 implement phase 的 agent_mode 改为 goal_loop（feature 是唯一运行时消费 YAML phases 的 mode）。
+      #   - golden 模板：见 plugins/spec-driver/templates/goal-loop-override-template.yaml
+      #     （含完整 feature phase 列表，仅本 phase 改 goal_loop；整段替换语义不继承 base）。
+      #   - 循环逻辑在 feature SKILL.md 的「goal_loop 闭环编排」小节（声明性标签 + 散文编排）。
       - id: "6"
         name: implement
         display_name: 代码实现
@@ -368,21 +376,21 @@ modes:
         is_critical: true
 
   # ─────────────────────────────────────────────────────────────
-  # Story 模式：故事式快速迭代（7 阶段）
+  # Story 模式：故事式快速迭代（5 阶段）
   # ─────────────────────────────────────────────────────────────
   story:
-    name: "Story 模式（7 阶段快速迭代）"
+    name: "Story 模式（5 阶段：宪法-规范-规划-实现-验证）"
     description: "基于 product-research 快速迭代小功能"
     phases:
       - id: "1"
-        name: clarify
-        display_name: 需求澄清
-        agent: clarify
+        name: constitution
+        display_name: Constitution 检查
+        agent: null
         agent_mode: single
         gates_before: null
         gates_after: null
         conditional: null
-        skip_if_exists: "spec.md"
+        skip_if_exists: null
         is_critical: false
 
       - id: "2"
@@ -399,29 +407,18 @@ modes:
 
       - id: "3"
         name: plan
-        display_name: 技术规划
+        display_name: 技术规划+任务分解
         agent: plan
         agent_mode: single
         gates_before:
           - GATE_DESIGN
-        gates_after: null
-        conditional: null
-        skip_if_exists: "plan.md"
-        is_critical: true
-
-      - id: "4"
-        name: tasks
-        display_name: 任务分解
-        agent: tasks
-        agent_mode: single
-        gates_before: null
         gates_after:
           - GATE_TASKS
         conditional: null
-        skip_if_exists: "tasks.md"
+        skip_if_exists: "plan.md"
         is_critical: true
 
-      - id: "5"
+      - id: "4"
         name: implement
         display_name: 代码实现
         agent: implement
@@ -432,9 +429,9 @@ modes:
         skip_if_exists: null
         is_critical: true
 
-      - id: "6"
+      - id: "5"
         name: verify
-        display_name: 验证与交付
+        display_name: 验证闭环
         agent: verify
         agent_mode: single
         gates_before: null
@@ -523,16 +520,27 @@ modes:
         is_critical: true
 
   # ─────────────────────────────────────────────────────────────
-  # Fix 模式：修复流程（3 阶段最小化）
+  # Fix 模式：修复流程（4 阶段）
   # ─────────────────────────────────────────────────────────────
   fix:
-    name: "Fix 模式（3 阶段修复流程）"
+    name: "Fix 模式（4 阶段：诊断-规划-修复-验证）"
     description: "快速处理 bug 和小型修复"
     phases:
       - id: "1"
-        name: specify
-        display_name: 需求规范
-        agent: specify
+        name: diagnose
+        display_name: 问题诊断
+        agent: null
+        agent_mode: single
+        gates_before: null
+        gates_after: null
+        conditional: null
+        skip_if_exists: null
+        is_critical: true
+
+      - id: "2"
+        name: plan
+        display_name: 修复规划
+        agent: plan
         agent_mode: single
         gates_before: null
         gates_after:
@@ -541,9 +549,9 @@ modes:
         skip_if_exists: null
         is_critical: true
 
-      - id: "2"
+      - id: "3"
         name: implement
-        display_name: 代码实现
+        display_name: 代码修复
         agent: implement
         agent_mode: single
         gates_before: null
@@ -552,9 +560,9 @@ modes:
         skip_if_exists: null
         is_critical: true
 
-      - id: "3"
+      - id: "4"
         name: verify
-        display_name: 验证与交付
+        display_name: 验证闭环
         agent: verify
         agent_mode: single
         gates_before: null

package/plugins/spec-driver/contracts/orchestration-overrides-contract.yaml

@@ -13,6 +13,31 @@ description: >
 
 canonical_schema: "plugins/spec-driver/contracts/orchestration-schema.mjs"
 
+runtime_consumption_caveat:
+  summary: >
+    重要：当前只有 feature 模式在运行时消费 orchestration 的 phase 序列（经
+    orchestrator-cli get-phases 驱动动态编排）。fix / story / implement / refactor / resume
+    等模式的 phase 序列由各自 SKILL.md 正文**固定编排**，运行时不读取 yaml 的 phases。
+  user_impact: >
+    因此对这些非 feature 模式的 modes.<mode> 做 phase 序列覆盖（整段替换 phases），
+    **当前不会改变该模式实际跑的阶段** —— 例如改写 modes.fix 的 phases，fix 实际仍按
+    spec-driver-fix SKILL.md 的 4 阶段（诊断-规划-修复-验证）执行，yaml 仅作文档性描述。
+  scope: >
+    orchestration.yaml 中 fix / story / implement 等段的 phase 序列是对应 SKILL.md 真实流程的
+    **文档性摘要**（phase 计数与主干顺序、GATE 卡点对齐），而非逐字等价：yaml 一阶段一 agent 的
+    结构**无法表达** SKILL 正文里的复合委派（如 fix「修复规划」阶段实际依次调 plan + tasks 两个
+    子代理、story「技术规划+任务分解」同理）与条件委派（如 story 的 clarify 在 skip_if_exists 命中
+    时跳过）。读 yaml 了解"跑哪几个阶段、什么顺序、卡哪些 GATE"即可；阶段内部的子代理编排细节
+    以 SKILL.md 为准。phase 序列单源化（让所有模式运行时统一消费 yaml）视成本拆后续 milestone。
+  affected_modes:
+    - fix
+    - story
+    - implement
+    - refactor
+    - resume
+  runtime_consuming_modes:
+    - feature
+
 vs_spec_driver_config:
   description: >
     orchestration-overrides.yaml 与 spec-driver.config.yaml 职责分工说明
@@ -31,6 +56,8 @@ supported_overrides:
     notes: >
       overrides 中出现同名 mode 时，整段 phases 数组替换 base 对应 mode；
       base 的其余 phase 字段不保留。无法局部 patch 单个 phase，需完整声明 phases 数组。
+      ⚠️ 见 runtime_consumption_caveat：仅 feature 模式运行时消费 phase 序列；对
+      fix/story/implement/refactor/resume 的 phase 序列覆盖当前不改变其实际执行阶段。
     reserved_modes:
       - feature
       - story