team-skills 1.3.9 → 1.4.0

package/CHANGELOG.md

@@ -7,6 +7,23 @@
 
 ## [Unreleased]
 
+## [1.4.0] - 2026-06-27
+
+### 新增
+
+- `team-range` 开发者命令：逐文件遍历项目文件执行用户指定操作，修改后重检直到干净再处理下一个
+
+### 变更
+
+- CLAUDE.md §2.2 引用规范更新：新增 `**REF**` 关键词统一外部规则引用格式，新增内联引用反引号格式规范
+- README 对齐 CLAUDE.md 命名规范：Agent 类名 → Skill 名称、H1-H4 → 正式介入点名称（CONFIRM_GOAL/CONFIRM_SPEC/ASK_HUMAN/HUMAN_ACCEPT）、Mermaid 核心架构图节点标签同步更新
+- `team-refine` 打磨顺序调整
+
+### 修复
+
+- 29 个文件全量一致性修复：22 处 Skill 名称反引号统一、4 处角色命名统一（"Agent" → "Skill"）、5 处模板章节编号修正
+- README 事实修正：SDD 章节数 7→9、设计原则数 20→21、refine 维度数修正、开发者命令表补齐 `/team-range`
+
 ## [1.3.9] - 2026-06-27
 
 ### 新增

package/README.md

@@ -38,7 +38,7 @@
 
 ```
 传统方式：用户 → AI（一句话）→ 代码（随机产出）
-Team Skills：用户 → H1确认 → SDD规格 → H2确认 → TDD实现 → 测试 → Review → H4验收
+Team Skills：用户 → CONFIRM_GOAL → SDD 规格 → CONFIRM_SPEC → TDD 实现 → 测试 → Review → HUMAN_ACCEPT
 ```
 
 每个环节有明确的输入/输出标准，AI 不是"猜需求"，而是**执行规格**。
@@ -46,8 +46,8 @@ Team Skills：用户 → H1确认 → SDD规格 → H2确认 → TDD实现 →
 ### 🔄 有向图回退，不是线性流水线
 
 ```
-testAgent 发现 bug ──→ 自动回退 implAgent
-reviewAgent 发现 spec 遗漏 ──→ 自动回退 specAgent
+team-test 发现 bug ──→ 自动回退 team-impl
+team-review 发现 spec 遗漏 ──→ 自动回退 team-spec
 同一阶段回退 ≤ 2 次，超过触发人类介入
 ```
 
@@ -63,7 +63,7 @@ reviewAgent 发现 spec 遗漏 ──→ 自动回退 specAgent
 ### 📝 规则沉淀，不是"每次从零"
 
 - **三层规则体系**：项目级 → 模块级 → 任务级，冲突按优先级覆盖
-- **消费方契约**：每条规则含触发条件 + 可执行指令 + 示例，下游 Agent 可直接执行
+- **消费方契约**：每条规则含触发条件 + 可执行指令 + 示例，下游 Skill 可直接执行
 
 ### 📊 量化评估，不是"凭感觉"
 
@@ -156,7 +156,7 @@ npx team-skills@latest update
 /team-orchestrator 实现用户登录功能
 ```
 
-编排器自动完成：H1 确认目标 → specAgent 产出 SDD → H2 确认规格 → implAgent TDD 实现 → testAgent 四维测试 → reviewAgent 五维审查 → 分支完成处理 → H4 验收交付
+编排器自动完成：CONFIRM_GOAL 确认目标 → `team-spec` 产出 SDD → CONFIRM_SPEC 确认规格 → `team-impl` TDD 实现 → `team-test` 四维测试 → `team-review` 五维审查 → 分支完成处理 → HUMAN_ACCEPT 验收交付
 
 简单任务可用精简模式：
 
@@ -193,46 +193,46 @@ flowchart TD
     classDef kill fill:#ffebee,stroke:#c62828,stroke-width:2px,stroke-dasharray: 5 5,color:#b71c1c;
 
     START(("用户提出需求"))
-    H1["H1: 人类确认目标理解<br/>← 人类介入点 #1"]:::human
+    CG["CONFIRM_GOAL<br/>人类确认目标理解"]:::human
     BRANCH["创建功能分支<br/>{slug} 分支"]:::git
-    SPEC["specAgent — 规格制定<br/>产出 01-05 + prompt-template<br/>Socratic 提问 → SDD 规格"]:::agent
-    H2["H2: 人类确认规格方案<br/>← 人类介入点 #2"]:::human
-    IMPL["implAgent — TDD 实现<br/>红-绿-重构循环<br/>增量提交 + 决策记录"]:::agent
-    TEST["testAgent — 四维测试<br/>功能/边界/异常/代码分支"]:::agent
-    REVIEW["reviewAgent — 五维审查<br/>资产沉淀 + 复盘"]:::agent
+    SPEC["team-spec — 规格制定<br/>产出 01-05 + prompt-template<br/>Socratic 提问 → SDD 规格"]:::agent
+    CS["CONFIRM_SPEC<br/>人类确认规格方案"]:::human
+    IMPL["team-impl — TDD 实现<br/>红-绿-重构循环<br/>增量提交 + 决策记录"]:::agent
+    TEST["team-test — 四维测试<br/>功能/边界/异常/代码分支"]:::agent
+    REVIEW["team-review — 五维审查<br/>资产沉淀 + 复盘"]:::agent
     FINISH["team-finish — 分支完成<br/>merge / PR / keep"]:::git
-    H4["H4: 人类验收交付物<br/>← 人类介入点 #4"]:::human
-    H3("H3: 人类介入 #3<br/>阻塞 / 决策 / Kill Switch"):::human
+    HA["HUMAN_ACCEPT<br/>人类验收交付物"]:::human
+    AH("ASK_HUMAN<br/>阻塞 / 决策 / Kill Switch"):::human
 
-    START --> H1
-    H1 -->|确认| BRANCH
-    H1 -->|不确认| START
+    START --> CG
+    CG -->|确认| BRANCH
+    CG -->|不确认| START
 
     BRANCH --> SPEC
-    SPEC --> H2
-    H2 -->|确认| IMPL
-    H2 -->|不确认| SPEC
-    H2 -.->|Kill Switch| H3
+    SPEC --> CS
+    CS -->|确认| IMPL
+    CS -->|不确认| SPEC
+    CS -.->|Kill Switch| AH
 
     IMPL --> TEST
 
     TEST -->|全部通过| REVIEW
     TEST -->|发现 bug| IMPL
     TEST -->|spec 遗漏| SPEC
-    TEST -.->|不可行| H3
+    TEST -.->|不可行| AH
 
     REVIEW -->|无问题| FINISH
     REVIEW -->|P0/P1| IMPL
     REVIEW -->|spec 遗漏| SPEC
-    REVIEW -.->|不可行| H3
+    REVIEW -.->|不可行| AH
 
-    FINISH --> H4
-    H4 -->|验收通过| DONE(("完成 ✅"))
-    H4 -->|不通过| IMPL
+    FINISH --> HA
+    HA -->|验收通过| DONE(("完成 ✅"))
+    HA -->|不通过| IMPL
 ```
 
-> H3 可在**任何阶段**触发，包括：发现任务不可行（Kill Switch）、回退超限、或需要人类决策的复杂问题。
-> 功能分支在 H1 确认后自动创建，在 Review 通过后由 team-finish 处理（merge/PR/keep/discard）。
+> ASK_HUMAN 可在**任何阶段**触发，包括：发现任务不可行（Kill Switch）、回退超限、或需要人类决策的复杂问题。
+> 功能分支在 CONFIRM_GOAL 确认后自动创建，在 Review 通过后由 `team-finish` 处理（merge/PR/keep/discard）。
 
 ---
 
@@ -310,7 +310,7 @@ docs/
 │   │   ├── 00-design-brief.md      #   设计概要（team-brainstorm 产出，可选）
 │   │   ├── 01-plan.md              #   任务规划（目标 + 分期 + 预算）
 │   │   ├── 02-context.md           #   上下文选择（术语 + 引用 + 排除）
-│   │   ├── 03-sdd.md              #   SDD 规格（七部分完整）
+│   │   ├── 03-sdd.md              #   SDD 规格（九章节完整）
 │   │   ├── 04-boundary.md          #   修改边界（allow + deny）
 │   │   ├── 05-risk.md              #   风险 + 验证计划
 │   │   ├── prompt-template.md      #   AI 任务提示词模板
@@ -369,7 +369,7 @@ Team Skills 融合了业界多个 AI 协作框架的精华：
 | **OpenSpec** (Fission AI) | Delta Spec 增量规格、RFC 2119 + Given/When/Then |
 | **Karpathy Skills** | 过度抽象防御、死代码清理、困惑管理 |
 | **Agent-Style** | 5 条 LLM 输出质量约束 |
-| **独创** | 有向图回退、质量追溯矩阵、消费方契约、H1-H4 人类介入点、100 分制量化评估、Skill Spec Language（20 条设计原则） |
+| **独创** | 有向图回退、质量追溯矩阵、消费方契约、CONFIRM_GOAL-HUMAN_ACCEPT 人类介入点、100 分制量化评估、Skill Spec Language（21 条设计原则） |
 
 ---
 
@@ -392,7 +392,7 @@ npm run setup      # 安装 Skills 到全局目录
 
 ### Skill 编写规范
 
-编写或修改 Skill 时，请参考 `CLAUDE.md` §2.8（Skill Spec：格式约定 + 关键词参考 + 设计原则）。
+编写或修改 Skill 时，请参考 `CLAUDE.md` §2.7（Skill Spec：格式约定 + 关键词参考 + 设计原则）。
 
 ### 开发者斜杠命令（Claude Code）
 
@@ -400,7 +400,8 @@ npm run setup      # 安装 Skills 到全局目录
 
 | 命令 | 说明 | 参数 |
 |------|------|------|
-| `/team-refine` | 对抗审计（10 维度）+ 执行质量打磨（5 维度），按编排流程顺序逐 Skill 精炼到收敛 | 轮次数，默认 5 |
+| `/team-refine` | 改进飞轮：规范 ↔ SKILL.md 双向对抗审计（15 维度）+ LLM 执行质量打磨，逐轮收敛 | 轮次数，默认 5 |
+| `/team-range` | 逐文件遍历：对项目文件逐个执行指定操作，修改后重检直到干净 | `--scope skills\|rules\|commands\|all\|<glob>` + 操作描述 |
 | `/team-release` | 版本发布：更新 package.json + CHANGELOG，运行 install/format/lint/cli-test | `patch` / `minor` / `major` / `x.y.z` |
 
 ### CI 流程

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "team-skills",
-  "version": "1.3.9",
+  "version": "1.4.0",
   "description": "AI Agent Skills framework — Spec-Driven development with directed-graph rollback and quality gates",
   "type": "module",
   "bin": {

package/skills/_team-rules/ai-collaboration-standards.md

@@ -28,7 +28,7 @@
   - ❌ 错误：{坏的做法}
 ```
 
-不满足三要素的规则视为"空口号"，team-review **MUST** 补全或删除。
+不满足三要素的规则视为"空口号"，`team-review` **MUST** 补全或删除。
 
 ### 1.3 资产维护机制
 
@@ -45,14 +45,14 @@
 
 | 内容类别    | 定义位置                                                                  |
 | ----------- | ------------------------------------------------------------------------- |
-| 业务术语    | team-spec `02-context.md` 模板（术语表）                                  |
-| 系统架构    | orchestrator 有向图流程图 + team-spec `03-sdd.md` §四 数据流              |
+| 业务术语    | `team-spec` `02-context.md` 模板（术语表）                                |
+| 系统架构    | `team-orchestrator` 有向图流程图 + `team-spec` `03-sdd.md` §四 数据流     |
 | 代码结构    | `_team-rules/task-lifecycle.md` §1（17 文件目录结构）                     |
-| 接口约定    | team-spec `02-context.md`（接口约束表）+ `03-sdd.md` §五/§六              |
-| 编码规范    | `_team-rules/spec-driven-workflow.md` §2 TDD + 本文件 §2.3 输出质量约束 + team-impl 各阶段禁止项 |
-| 测试要求    | `_team-rules/verification-protocol.md` + team-test 四维测试矩阵           |
-| Review 标准 | team-review 五维度审查 + 严重级别校准（P0-P3 实例）                       |
-| 交付要求    | orchestrator Step 8 完整性检查                                            |
+| 接口约定    | `team-spec` `02-context.md`（接口约束表）+ `03-sdd.md` §五/§六           |
+| 编码规范    | `_team-rules/spec-driven-workflow.md` §2 TDD + 本文件 §2.3 输出质量约束 + `team-impl` 各阶段禁止项 |
+| 测试要求    | `_team-rules/verification-protocol.md` + `team-test` 四维测试矩阵        |
+| Review 标准 | `team-review` 五维度审查 + 严重级别校准（P0-P3 实例）                     |
+| 交付要求    | `team-orchestrator` Step 8 完整性检查                                     |
 
 ## §2 Prompt 工程规范
 

package/skills/_team-rules/spec-driven-workflow.md

@@ -7,7 +7,7 @@
 ### 1.1 规格先于代码
 
 - 任何功能实现必须有对应的 SDD（Software Design Document）作为输入
-- SDD 是 team-impl 和 team-test 的唯一规格来源——不依赖口头约定或聊天记录
+- SDD 是 `team-impl` 和 `team-test` 的唯一规格来源——不依赖口头约定或聊天记录
 - 修改类任务使用 Delta Spec（ADDED/MODIFIED/REMOVED），新建类任务使用完整 SDD
 
 ### 1.2 SDD 九章节质量标准
@@ -17,14 +17,14 @@
 | 章节          | 内容                                                       | 消费方                       |
 | ------------- | ---------------------------------------------------------- | ---------------------------- |
 | §一 背景与动机    | 为什么做、痛点、用户场景                                   | 所有 Agent                   |
-| §二 业务规则      | RFC 2119 强度标记（MUST/SHOULD/MAY）+ Given/When/Then 场景 | team-test → 直接映射测试用例 |
-| §三 关键设计决策  | 选择方案 + 拒绝方案 + 拒绝理由                             | team-review → 审查决策合理性 |
-| §四 数据流总览    | ASCII 架构图                                               | team-impl → 理解调用链路     |
-| §五 输入规格 | 参数类型、约束、默认值、示例                               | team-impl + team-test        |
-| §六 输出规格 | 场景、HTTP 状态、输出结构、示例                            | team-impl + team-test        |
-| §七 边界条件      | 空值、极值、并发、格式异常                                 | team-test → 边界测试         |
-| §八 异常场景      | 错误码、错误消息、HTTP 状态                                | team-test → 异常测试         |
-| §九 验收 Checklist | 验收条件、验证方式、预期结果                               | team-review → 验收检查       |
+| §二 业务规则      | RFC 2119 强度标记（MUST/SHOULD/MAY）+ Given/When/Then 场景 | `team-test` → 直接映射测试用例 |
+| §三 关键设计决策  | 选择方案 + 拒绝方案 + 拒绝理由                             | `team-review` → 审查决策合理性 |
+| §四 数据流总览    | ASCII 架构图                                               | `team-impl` → 理解调用链路     |
+| §五 输入规格 | 参数类型、约束、默认值、示例                               | `team-impl` + `team-test`        |
+| §六 输出规格 | 场景、HTTP 状态、输出结构、示例                            | `team-impl` + `team-test`        |
+| §七 边界条件      | 空值、极值、并发、格式异常                                 | `team-test` → 边界测试         |
+| §八 异常场景      | 错误码、错误消息、HTTP 状态                                | `team-test` → 异常测试         |
+| §九 验收 Checklist | 验收条件、验证方式、预期结果                               | `team-review` → 验收检查       |
 
 ### 1.3 规格驱动的验证链
 
@@ -72,10 +72,10 @@ COMMIT: git commit（每个功能点一次，不攒多个功能点）
 
 | 发现者      | 问题类型         | 回退目标           |
 | ----------- | ---------------- | ------------------ |
-| team-test   | 实现 bug         | → team-impl        |
-| team-test   | SDD 未定义的场景 | → team-spec        |
-| team-review | P0/P1 实现 bug   | → team-impl        |
-| team-review | spec 遗漏        | → team-spec        |
+| `team-test`   | 实现 bug         | → `team-impl`        |
+| `team-test`   | SDD 未定义的场景 | → `team-spec`        |
+| `team-review` | P0/P1 实现 bug   | → `team-impl`        |
+| `team-review` | spec 遗漏        | → `team-spec`        |
 | 任何 Agent  | 任务不可行       | → Kill Switch → ASK_HUMAN |
 
 ### 3.2 回退携带上下文

package/skills/_team-rules/task-lifecycle.md

@@ -56,7 +56,7 @@ docs/tasks/{NNNN}-{keyword}/
 | 介入点 | 时机             | 目的                               |
 | ------ | ---------------- | ---------------------------------- |
 | CONFIRM_GOAL     | 编排器初始化后   | 确认目标理解 + 方案方向            |
-| CONFIRM_SPEC     | team-spec 产出后 | 确认规格方案 + 分期策略            |
+| CONFIRM_SPEC     | `team-spec` 产出后 | 确认规格方案 + 分期策略            |
 | ASK_HUMAN     | 发现阻塞/需决策  | 人类决策（Kill Switch / 方案选择） |
 | HUMAN_ACCEPT     | 全部完成后       | 验收交付物 + P2 决策               |
 

package/skills/_team-rules/verification-protocol.md

@@ -19,7 +19,7 @@
 
 ```
 
-违反此协议的声明视为无效，team-review MUST 标记为 P0。
+违反此协议的声明视为无效，`team-review` MUST 标记为 P0。
 
 ## 结构化证据格式
 

package/skills/team-brainstorm/SKILL.md

@@ -92,7 +92,7 @@ NO IMPLEMENTATION WITHOUT USER APPROVED DESIGN FIRST
 > TRAP：你会倾向于接受用户的初始框架，不质疑其前提假设。
 > 用户说"我需要一个缓存层"——但也许问题根源是查询太慢，缓存只是用户想到的第一个方案。
 
-> 一次最多 3 个问题，优先用选项形式降低用户认知负担（First Principle #1）。
+> 一次最多 3 个问题，优先用选项形式降低用户认知负担 `_team-rules/first-principles.md: First Principle #1`。
 
 向用户展示最多 3 个关键问题，等待用户一次回复：
 
@@ -137,7 +137,7 @@ NO IMPLEMENTATION WITHOUT USER APPROVED DESIGN FIRST
 
 ### Phase 4：展示设计
 
-> 逐段确认而非一次倾倒，每段确认后再展示下一段。目标是让用户在每个维度上做出知情决策，而非被信息量压垮后草率同意（First Principle #1）。
+> 逐段确认而非一次倾倒，每段确认后再展示下一段。目标是让用户在每个维度上做出知情决策，而非被信息量压垮后草率同意 `_team-rules/first-principles.md: First Principle #1`。
 
 逐段展示设计，每段后等待用户确认：
 
@@ -242,11 +242,14 @@ NO IMPLEMENTATION WITHOUT USER APPROVED DESIGN FIRST
 
 ## CONSTITUTIONAL_RULES
 
-引用 `_team-rules/constitutional-rules.md`。brainstorm 阶段尤其注意：
+**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 
-- **Rule #1 人类介入是一等公民**：每个方案设计决策必须等待用户确认，不可擅自决定（First Principle #1）
-- **Rule #5 分期交付优先**：方案设计时主动考虑分期交付（First Principle #3）
-- **Rule #4 Kill Switch**：如果探索阶段发现需求不可行，立即暂停而非继续设计（First Principle #1 + First Principle #3）
+brainstorm 阶段尤其注意：
+
+- **Rule #1 人类介入是一等公民**：每个方案设计决策必须等待用户确认，不可擅自决定 `_team-rules/first-principles.md: First Principle #1`
+- **Rule #5 分期交付优先**：方案设计时主动考虑分期交付 `_team-rules/first-principles.md: First Principle #3`
+- **Rule #4 Kill Switch**：如果探索阶段发现需求不可行，立即暂停而非继续设计 `_team-rules/first-principles.md: First Principle #1 + First Principle #3`
 
 ## SELF_CHECK
 
@@ -264,6 +267,8 @@ NO IMPLEMENTATION WITHOUT USER APPROVED DESIGN FIRST
 
 ## COMPLETION
 
+**REF** `_team-rules/four-state-protocol.md` — 四态完成状态
+
 **MATCH** `result`：
 
 - 用户确认设计 + `00-design-brief.md` 已写入 → **DONE**

package/skills/team-debug/SKILL.md

@@ -16,7 +16,7 @@ description: Use when encountering any bug, test failure, or unexpected behavior
 
 ### 推理检查点
 
-> 每次修复必须能解释"为什么之前坏了"。"应该能修好"是无效声明（First Principle #4）。95% 的"找不到根因"是调查不充分。
+> 每次修复必须能解释"为什么之前坏了"。"应该能修好"是无效声明 `_team-rules/first-principles.md: First Principle #4`。95% 的"找不到根因"是调查不充分。
 
 **推理框架**：
 
@@ -174,7 +174,7 @@ NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
 ## STOP_SIGNALS
 
 - **跳过**根因调查直接写修复代码
-- **同时**修改多个变量，无法隔离有效改动
+- **修改**多个变量同时进行，无法隔离有效改动
 - **继续**尝试 3 次修复失败后仍不触发 `ASK_HUMAN`
 - **绕过**调查流程（"先快速修一下，后面再查根因"）
 
@@ -204,12 +204,16 @@ NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
 
 ## CONSTITUTIONAL_RULES
 
-引用 `_team-rules/constitutional-rules.md`。调试阶段尤其注意：
+**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
+**REF** `_team-rules/verification-protocol.md` — 5 步验证协议
 
-- **Rule #9 TDD 顺序不可逆**：修复 bug 必须先写失败的回归测试再写修复代码（First Principle #2）
-- **Rule #3 产出必须验证**：修复完成后必须执行 `_team-rules/verification-protocol.md` 的 5 个步骤（First Principle #4）
-- **Rule #7 回退次数上限**：3 次修复失败必须触发 `ASK_HUMAN`，不可无限重试（First Principle #1）
-- **Rule #2 有向图回退**：调试发现根源在 spec 歧义/遗漏 → `ROLLBACK` team-spec（First Principle #4）
+调试阶段尤其注意：
+
+- **Rule #9 TDD 顺序不可逆**：修复 bug 必须先写失败的回归测试再写修复代码 `_team-rules/first-principles.md: First Principle #2`
+- **Rule #3 产出必须验证**：修复完成后必须执行验证协议 `_team-rules/verification-protocol.md: 验证执行步骤` `_team-rules/first-principles.md: First Principle #4`
+- **Rule #7 回退次数上限**：3 次修复失败必须触发 `ASK_HUMAN`，不可无限重试 `_team-rules/first-principles.md: First Principle #1`
+- **Rule #2 有向图回退**：调试发现根源在 spec 歧义/遗漏 → `ROLLBACK` `team-spec` `_team-rules/first-principles.md: First Principle #4`
 
 ## SELF_CHECK
 
@@ -227,6 +231,8 @@ NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
 
 ## COMPLETION
 
+**REF** `_team-rules/four-state-protocol.md` — 四态完成状态
+
 **MATCH** `result`：
 
 - 根因确定 + 修复验证通过 → **DONE**

package/skills/team-feedback/SKILL.md

@@ -128,7 +128,7 @@ NO IMPLEMENTATION WITHOUT TECHNICAL VERIFICATION FIRST
 
 ### Phase 4：实施
 
-> 逐项实施、逐项测试。批量实施后再测试 = 出问题时无法定位是哪项修改引入的（First Principle #2）。全部单项通过后再跑全量测试确认无交叉回归。
+> 逐项实施、逐项测试。批量实施后再测试 = 出问题时无法定位是哪项修改引入的 `_team-rules/first-principles.md: First Principle #2`。全部单项通过后再跑全量测试确认无交叉回归。
 
 > TRAP：你会倾向于修改实现去匹配反馈，而不检查反馈是否与 SDD 一致。
 > 实施前先确认：这项修改是让代码更接近 SDD，还是偏离 SDD？偏离 → 先路由 team-spec。
@@ -161,7 +161,7 @@ NO IMPLEMENTATION WITHOUT TECHNICAL VERIFICATION FIRST
    |--------|------|------|----------|----------|----------|
    | {feedback_desc} | {reviewer} | 接受 / 推回 / 部分接受 | {evidence} | {change_desc} | ✅/❌ `{test_output}` |
 
-**验证协议**（步骤 3-4 声明"通过"前必须执行 `_team-rules/verification-protocol.md` 的 5 个步骤）
+**验证协议**：步骤 3-4 声明"通过"前必须执行 `_team-rules/verification-protocol.md: 验证执行步骤`
 
 ## 禁止回应
 
@@ -215,16 +215,19 @@ NO IMPLEMENTATION WITHOUT TECHNICAL VERIFICATION FIRST
 
 - **实施**反馈建议前没有验证技术正确性
 - **回应**"你说得太对了""好主意"等表演性同意
-- **批量**实施多项反馈而不逐项测试
+- **跳过**逐项测试而批量实施多项反馈
 - **忽略**外部反馈与代码库现实的冲突而不推回
 
 ## CONSTITUTIONAL_RULES
 
-引用 `_team-rules/constitutional-rules.md`。反馈处理阶段尤其注意：
+**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 
-- **Rule #9 TDD 顺序不可逆**：每项修改必须单独测试，不可批量实施后再测试（First Principle #2）
-- **Rule #2 有向图回退**：反馈揭示 spec 遗漏 → 回退 team-spec，不可擅自决定（First Principle #4）
-- **Rule #1 人类介入是一等公民**：反馈揭示架构问题 → 触发 `ASK_HUMAN`（First Principle #1）
+反馈处理阶段尤其注意：
+
+- **Rule #9 TDD 顺序不可逆**：每项修改必须单独测试，不可批量实施后再测试 `_team-rules/first-principles.md: First Principle #2`
+- **Rule #2 有向图回退**：反馈揭示 spec 遗漏 → 回退 `team-spec`，不可擅自决定 `_team-rules/first-principles.md: First Principle #4`
+- **Rule #1 人类介入是一等公民**：反馈揭示架构问题 → 触发 `ASK_HUMAN` `_team-rules/first-principles.md: First Principle #1`
 
 ## SELF_CHECK
 
@@ -244,6 +247,8 @@ NO IMPLEMENTATION WITHOUT TECHNICAL VERIFICATION FIRST
 
 ## COMPLETION
 
+**REF** `_team-rules/four-state-protocol.md` — 四态完成状态
+
 **WRITE**（对话中）反馈处理摘要：
 
 ```

package/skills/team-finish/SKILL.md

@@ -18,7 +18,7 @@ description: Use when implementation is complete, all tests pass, and you need t
 
 ### 推理检查点
 
-> 测试未通过 = 不展示合并选项（First Principle #4）。用户未选择 = 不执行操作（First Principle #1）。每步有明确前置条件。
+> 测试未通过 = 不展示合并选项 `_team-rules/first-principles.md: First Principle #4`。用户未选择 = 不执行操作 `_team-rules/first-principles.md: First Principle #1`。每步有明确前置条件。
 
 **推理框架**：
 
@@ -66,7 +66,7 @@ NO BRANCH COMPLETION WITHOUT TEST VERIFICATION FIRST
 
 > TRAP：你会倾向于引用上一轮的测试结果来跳过重新执行。Iron Law 不允许——每次进入 finish 都必须重新运行。
 
-**EXEC** 项目测试命令（声明"通过"前须执行 `_team-rules/verification-protocol.md` 的 5 个步骤）
+**EXEC** 项目测试命令 — 声明"通过"前须执行验证协议 `_team-rules/verification-protocol.md: 验证执行步骤`
 
 **ASSERT** `exit_code == 0` && `failures == 0`
 
@@ -75,7 +75,7 @@ NO BRANCH COMPLETION WITHOUT TEST VERIFICATION FIRST
   - `orchestrated` → **ROLLBACK** 编排器，向编排器报告：建议路由到 `team-impl`（附上失败输出）
   - *DEFAULT* → **WRITE**（对话中）失败详情，推荐 `team-debug`，修复后 **GOTO** Step 1
 
-> 不可忽略失败继续展示选项（First Principle #4）。
+> 不可忽略失败继续展示选项 `_team-rules/first-principles.md: First Principle #4`。
 
 ### Step 1.5：凭证泄露扫描
 
@@ -138,7 +138,7 @@ NO BRANCH COMPLETION WITHOUT TEST VERIFICATION FIRST
        - **GOTO** 子步骤 4.1
      - **ELSE**：
        - 继续下一步
-  3. **EXEC** 项目测试命令（声明"通过"前须执行 `_team-rules/verification-protocol.md` 的 5 个步骤）
+  3. **EXEC** 项目测试命令 — 声明"通过"前须执行验证协议 `_team-rules/verification-protocol.md: 验证执行步骤`
      - **ASSERT** `exit_code == 0` && `failures == 0`
        - 失败 → 记录回归详情 → **BLOCKED**
   4. **EXEC** `git branch -d {branch}`
@@ -279,11 +279,14 @@ NO BRANCH COMPLETION WITHOUT TEST VERIFICATION FIRST
 
 ## CONSTITUTIONAL_RULES
 
-引用 `_team-rules/constitutional-rules.md`。分支完成阶段尤其注意：
+**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 
-- **Rule #1 人类介入是一等公民**：所有分支操作（合并/PR/丢弃）必须等待用户明确选择（First Principle #1）
-- **Rule #8 验证先行**：展示选项前必须通过新鲜测试执行验证（First Principle #4）
-- **Rule #3 产出必须验证**：合并后必须重新运行测试确认无回归（First Principle #4）
+分支完成阶段尤其注意：
+
+- **Rule #1 人类介入是一等公民**：所有分支操作（合并/PR/丢弃）必须等待用户明确选择 `_team-rules/first-principles.md: First Principle #1`
+- **Rule #8 验证先行**：展示选项前必须通过新鲜测试执行验证 `_team-rules/first-principles.md: First Principle #4`
+- **Rule #3 产出必须验证**：合并后必须重新运行测试确认无回归 `_team-rules/first-principles.md: First Principle #4`
 
 ## SELF_CHECK
 
@@ -304,6 +307,8 @@ NO BRANCH COMPLETION WITHOUT TEST VERIFICATION FIRST
 
 ## COMPLETION
 
+**REF** `_team-rules/four-state-protocol.md` — 四态完成状态
+
 **MATCH** `result`：
 
 - `操作成功` → **DONE**

package/skills/team-impl/SKILL.md

@@ -22,7 +22,7 @@ description: Use when SDD exists and you need TDD implementation with 06-08 docs
 
 ### 推理检查点
 
-**核心指令**：先让测试通过，再优化代码。三行重复优于过早抽象。测试通过是客观事实，代码美观是主观判断——顺序不可逆（First Principle #2）。
+**核心指令**：先让测试通过，再优化代码。三行重复优于过早抽象。测试通过是客观事实，代码美观是主观判断——顺序不可逆 `_team-rules/first-principles.md: First Principle #2`。
 
 **推理框架**（首个功能点完整推理 5 点；后续仅推理 1、4，其余沿用）：
 
@@ -119,7 +119,7 @@ NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
 
 #### 循环 1：红（Red）— 写测试
 
-> TRAP：你会想"我已经知道实现怎么写了，先写实现再补测试也一样"。不一样——后写的测试只会验证你已经写的代码，不会验证需求（First Principle #2）。
+> TRAP：你会想"我已经知道实现怎么写了，先写实现再补测试也一样"。不一样——后写的测试只会验证你已经写的代码，不会验证需求 `_team-rules/first-principles.md: First Principle #2`。
 
 1. **READ** `03-sdd.md` → 提取该功能点的规格
 2. **WRITE** 测试 → 覆盖 Happy Path + 边界条件（SDD §七）+ 异常场景（SDD §八）
@@ -217,7 +217,7 @@ NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
 
 **ELSE** → 继续正常 TDD 循环
 
-> 为什么 TDD 顺序不可逆？后写测试被实现偏见污染（First Principle #2）：测的是已构建的行为，不是需求。"先实现再补测试效果一样""已经手动测试过了""删掉 X 小时工作太浪费了"——这些借口均不成立。
+> 为什么 TDD 顺序不可逆？后写测试被实现偏见污染 `_team-rules/first-principles.md: First Principle #2`：测的是已构建的行为，不是需求。"先实现再补测试效果一样""已经手动测试过了""删掉 X 小时工作太浪费了"——这些借口均不成立。
 
 #### 卡住时怎么办
 
@@ -289,7 +289,7 @@ NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
 3. **EXEC** 项目 lint 命令 → **ASSERT** `exit_code == 0`
 4. **EXEC** 项目 CI 命令 → **ASSERT** `exit_code == 0`
 
-**验证协议**（步骤 2-4 每次声明"通过"前须执行 `_team-rules/verification-protocol.md` 的 5 个步骤）
+**验证协议**：步骤 2-4 每次声明"通过"前须执行 `_team-rules/verification-protocol.md: 验证执行步骤`
 
 5. **EXEC** `git diff --name-only` → **READ** `04-boundary.md` deny 列表 → **ASSERT** `无越界修改`
 6. **READ** `01-plan.md` 预算 → **ASSERT** `未超出自我约束预算`
@@ -304,7 +304,7 @@ NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
 
 **ELSE** → 继续 Phase 2 下一步骤
 
-> 不可跳过失败继续后续步骤（First Principle #4）。预算超支砍范围，不放宽预算。
+> 不可跳过失败继续后续步骤 `_team-rules/first-principles.md: First Principle #4`。预算超支砍范围，不放宽预算。
 
 ### 回退路由
 
@@ -338,12 +338,18 @@ NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
 
 ## CONSTITUTIONAL_RULES
 
-引用 `_team-rules/constitutional-rules.md`。实现阶段尤其注意：
+**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
+**REF** `_team-rules/verification-protocol.md` — 5 步验证协议
+**REF** `_team-rules/spec-driven-workflow.md` — Spec-Driven 开发原则与 TDD 工作流
+**REF** `_team-rules/ai-collaboration-standards.md` — AI 协作资产与 Prompt 工程规范
 
-- **Rule #9 TDD 顺序不可逆**：RED 必须在 GREEN 之前，先写实现再补测试则删除代码重新开始（First Principle #2）
-- **Rule #2 有向图回退**：发现 spec 问题必须 `ROLLBACK` team-spec，不可擅自假设正确行为（First Principle #4）
-- **Rule #6 自我约束预算**：超出预算砍范围，不放宽预算（First Principle #3）
-- **Rule #8 验证先行**：声明"测试通过"前必须执行验证协议 5 步（First Principle #4）
+实现阶段尤其注意：
+
+- **Rule #9 TDD 顺序不可逆**：RED 必须在 GREEN 之前，先写实现再补测试则删除代码重新开始 `_team-rules/first-principles.md: First Principle #2`
+- **Rule #2 有向图回退**：发现 spec 问题必须 `ROLLBACK` team-spec，不可擅自假设正确行为 `_team-rules/first-principles.md: First Principle #4`
+- **Rule #6 自我约束预算**：超出预算砍范围，不放宽预算 `_team-rules/first-principles.md: First Principle #3`
+- **Rule #8 验证先行**：声明"测试通过"前必须执行验证协议 `_team-rules/verification-protocol.md: 验证执行步骤` `_team-rules/first-principles.md: First Principle #4`
 
 ## SELF_CHECK
 
@@ -366,6 +372,8 @@ NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
 
 ## COMPLETION
 
+**REF** `_team-rules/four-state-protocol.md` — 四态完成状态
+
 **MATCH** `result`：
 
 - `TDD 完成` && `CI 通过` && `边界合规` → **DONE**（`文件: {N} 修改 / {N} 新增`, `测试: {N} pass / {N} fail`, `CI: pass`）

package/skills/team-orchestrator/SKILL.md

@@ -31,7 +31,7 @@ flowchart TD
 
 ```
 角色：流程编排器——有向图编排，非线性流水线
-核心原则：根据产出质量动态决定回退或继续，对"先记着后面修"零容忍（First Principle #4）
+核心原则：根据产出质量动态决定回退或继续，对"先记着后面修"零容忍 `_team-rules/first-principles.md: First Principle #4`
 流程：
 1. 理解需求，拆解子任务
 2. 有向图调度：team-spec → team-impl → team-test → team-review
@@ -49,7 +49,7 @@ flowchart TD
 
 ### 路由推理检查点
 
-**核心指令**：价值在于协调而非执行。关注：Agent 是否卡住（需回退或 ASK_HUMAN），下一个 Agent 需要什么上下文。对"先记着后面修"零容忍（First Principle #4）。
+**核心指令**：价值在于协调而非执行。关注：Agent 是否卡住（需回退或 ASK_HUMAN），下一个 Agent 需要什么上下文。对"先记着后面修"零容忍 `_team-rules/first-principles.md: First Principle #4`。
 
 **推理框架**：
 
@@ -80,7 +80,8 @@ NO AGENT DISPATCH WITHOUT CONFIRM_GOAL HUMAN CONFIRMATION FIRST
 
 ## COMPLETION_PROTOCOL
 
-引用 `_team-rules/four-state-protocol.md`，不内联重复。
+**REF** `_team-rules/four-state-protocol.md` — 四态完成状态
+**REF** `_team-rules/task-lifecycle.md` — 任务目录结构与 CONFIRM_GOAL-HUMAN_ACCEPT 协议
 
 ## 有向图流程
 
@@ -273,7 +274,7 @@ NO AGENT DISPATCH WITHOUT CONFIRM_GOAL HUMAN CONFIRMATION FIRST
 | 来源 | 必需 | 说明 |
 |------|------|------|
 | 用户任务描述 | **required** | 自然语言任务请求 |
-| `00-design-brief.md` | 可选 | team-brainstorm 产出的设计概要 |
+| `00-design-brief.md` | 可选 | `team-brainstorm` 产出的设计概要 |
 | `.checkpoint.json` | 可选 | 断点续传状态（恢复中断的任务） |
 | 项目 CLAUDE.md | 自动 | 项目级规则和验证命令 |
 
@@ -945,17 +946,20 @@ TDD 强制要求：每个功能点必须先 git commit 失败测试（test: {功
 - **跳过** CONFIRM_GOAL 或 HUMAN_ACCEPT 人类介入点
 - **延迟**回退（"先记着后面一起修"）
 - **信任** Agent 自我声明而不验证产出
-- **超出**预算却不砍范围
-- **编排器自己写实现代码**（必须 dispatch 子 Skill，不得亲自实现。编排器的价值在于协调，不是执行）
+- **超出**预算不砍范围，或亲自执行实现代码而非 dispatch 子 Skill
 
 ## CONSTITUTIONAL_RULES
 
-引用 `_team-rules/constitutional-rules.md`。编排阶段尤其注意：
+**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
+**REF** `_team-rules/ai-collaboration-standards.md` — AI 协作资产与 Prompt 工程规范
 
-- **Rule #1 人类介入是一等公民**：CONFIRM_GOAL-HUMAN_ACCEPT 不可被任何 Agent 自动确认，"用户没回复就默认同意"是违规（First Principle #1）
-- **Rule #2 有向图回退**：team-test/team-review 发现问题必须 `ROLLBACK` 对应 Agent，不可"先记着后面一起修"（First Principle #4）
-- **Rule #7 回退次数上限**：同一 source→target 对回退 ≤ 2 次，第 3 次强制触发 `ASK_HUMAN`（First Principle #1）
-- **Rule #9 TDD 顺序不可逆**：team-impl 完成后必须验证 `06-tdd-log.md` 中 RED 在 GREEN 之前（First Principle #2）
+编排阶段尤其注意：
+
+- **Rule #1 人类介入是一等公民**：CONFIRM_GOAL-HUMAN_ACCEPT 不可被任何 Agent 自动确认，"用户没回复就默认同意"是违规 `_team-rules/first-principles.md: First Principle #1`
+- **Rule #2 有向图回退**：team-test/team-review 发现问题必须 `ROLLBACK` 对应 Agent，不可"先记着后面一起修" `_team-rules/first-principles.md: First Principle #4`
+- **Rule #7 回退次数上限**：同一 source→target 对回退 ≤ 2 次，第 3 次强制触发 `ASK_HUMAN` `_team-rules/first-principles.md: First Principle #1`
+- **Rule #9 TDD 顺序不可逆**：team-impl 完成后必须验证 `06-tdd-log.md` 中 RED 在 GREEN 之前 `_team-rules/first-principles.md: First Principle #2`
 
 ## SELF_CHECK
 
@@ -975,6 +979,8 @@ TDD 强制要求：每个功能点必须先 git commit 失败测试（test: {功
 
 ## COMPLETION
 
+**REF** `_team-rules/four-state-protocol.md` — 四态完成状态
+
 **MATCH** `result`：
 
 - `全流程完成 + 质量检查通过` → **DONE**（`模式: {完整/精简}`, `文件: {17/11}`, `质量检查: pass`）

package/skills/team-orchestrator/references/14-team-template.md

@@ -10,7 +10,7 @@
 | AI 编码       | team-impl    | TDD 开发、Prompt 优化、决策记录          | 06-08 + 代码                  |
 | 测试验证      | team-test    | 测试矩阵设计、补充测试、覆盖率           | 09-10 + 测试代码              |
 | Review & 沉淀 | team-review  | 代码审查、资产维护、复盘                 | 11-13 + task-rules + 资产更新 |
-| 编排协调      | team         | 调度、一致性检查、交付包装               | 14-15                         |
+| 编排协调      | team-orchestrator | 调度、一致性检查、交付包装               | 14-15                         |
 
 ## 二、协作资产一致性检查（自动化验证）
 

package/skills/team-review/SKILL.md

@@ -11,7 +11,7 @@ description: Use when code + tests exist and you need structured review + asset
 
 ```
 角色：审查专家——第一反应永远是"证据在哪里？"
-核心原则：不信任 Agent 自我声明（First Principle #4），审查目标是"会在什么条件下失败"而非"能不能工作"
+核心原则：不信任 Agent 自我声明 `_team-rules/first-principles.md: First Principle #4`，审查目标是"会在什么条件下失败"而非"能不能工作"
 流程：
 1. 五维度 Review：正确性、可维护性、性能、安全、测试覆盖
 2. Constitutional 合规检查：验证 9 条硬约束
@@ -25,7 +25,7 @@ description: Use when code + tests exist and you need structured review + asset
 
 ### 推理检查点
 
-**核心指令**：不被代码表面整洁度打动，不因"测试都通过了"放松警惕（First Principle #4）。审查寻找"会在什么条件下失败"。
+**核心指令**：不被代码表面整洁度打动，不因"测试都通过了"放松警惕 `_team-rules/first-principles.md: First Principle #4`。审查寻找"会在什么条件下失败"。
 
 **推理框架**：
 
@@ -129,9 +129,9 @@ NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK FIRST
 
 ### Phase 1.5：Constitutional 合规检查
 
-> 验证流程纪律，不依赖 Agent 自我声明（First Principle #4）。每条 Rule 要有具体证据，不是"看起来遵守了"。
+> 验证流程纪律，不依赖 Agent 自我声明 `_team-rules/first-principles.md: First Principle #4`。每条 Rule 要有具体证据，不是"看起来遵守了"。
 
-> TRAP：容易对 Constitutional 检查走过场——逐条打勾但不去看实际文件内容。特别是 TDD Iron Law（Rule #9），必须打开 06-tdd-log.md 确认 RED 在 GREEN 之前且有失败输出。
+> TRAP：容易对 Constitutional 检查走过场——逐条打勾但不去看实际文件内容。特别是 TDD Iron Law `_team-rules/constitutional-rules.md: Rule #9`，必须打开 06-tdd-log.md 确认 RED 在 GREEN 之前且有失败输出。
 
 `[精简模式]` 01-plan.md、02-context.md、05-risk.md 不存在时，涉及这些文件的检查项改为检查 03-sdd.md 中是否有对应信息，或标注"精简模式豁免"。
 
@@ -206,8 +206,9 @@ NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK FIRST
 2. **EXEC** 项目测试命令 — 确认修复正确
    **ASSERT** `exit_code == 0` — 测试失败 → 回滚修改 → **GOTO** Phase 2
 3. **EXEC** 项目 CI 检查命令 — 确认无 lint 问题
+   **ASSERT** `exit_code == 0` — lint 失败 → 修复后重新执行
 
-**验证协议**（步骤 2-3 声明"通过"前必须执行 `_team-rules/verification-protocol.md` 的 5 个步骤）
+**验证协议**：步骤 2-3 声明"通过"前必须执行 `_team-rules/verification-protocol.md: 验证执行步骤`
 
 4. **ASSERT** `exit_code == 0` && `failures == 0`
    - 通过 → **WRITE** 修复详情（问题 ID + 修复内容 + 验证结果）到 `11-review.md` §三修复记录
@@ -450,18 +451,21 @@ NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK FIRST
 ## STOP_SIGNALS
 
 - **跳过** Constitutional 合规检查或三视角对抗审查
-- **擅自修复** P0/P1 问题而不向编排器报告路由到 team-impl/team-spec
+- **擅自修复** P0/P1 问题而不向编排器报告路由到 `team-impl`/`team-spec`
 - **省略**消费方契约三要素（触发条件/可执行指令/示例）
 - **泛泛而谈**复盘（"做得不错""继续努力"）而非给出具体事例
 
 ## CONSTITUTIONAL_RULES
 
-引用 `_team-rules/constitutional-rules.md`。审查阶段尤其注意：
+**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 
-- **Rule #3 产出必须验证**：审查结论必须基于代码 diff 和测试运行结果，不可仅凭 Agent 自我声明（First Principle #4）
-- **Rule #2 有向图回退**：P0/P1 问题必须回退 team-impl 或 team-spec，不可降级处理（First Principle #4）
-- **Rule #9 TDD 顺序不可逆**：Phase 1.5 中必须验证 06-tdd-log.md 的 RED→GREEN 时间序（First Principle #2）
-- **Rule #1 人类介入是一等公民**：安全漏洞和多方案决策必须触发 `ASK_HUMAN`（First Principle #1）
+审查阶段尤其注意：
+
+- **Rule #3 产出必须验证**：审查结论必须基于代码 diff 和测试运行结果，不可仅凭 Agent 自我声明 `_team-rules/first-principles.md: First Principle #4`
+- **Rule #2 有向图回退**：P0/P1 问题必须回退 team-impl 或 team-spec，不可降级处理 `_team-rules/first-principles.md: First Principle #4`
+- **Rule #9 TDD 顺序不可逆**：Phase 1.5 中必须验证 06-tdd-log.md 的 RED→GREEN 时间序 `_team-rules/first-principles.md: First Principle #2`
+- **Rule #1 人类介入是一等公民**：安全漏洞和多方案决策必须触发 `ASK_HUMAN` `_team-rules/first-principles.md: First Principle #1`
 
 ## SELF_CHECK
 
@@ -481,13 +485,15 @@ NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK FIRST
 
 ## COMPLETION
 
+**REF** `_team-rules/four-state-protocol.md` — 四态完成状态
+
 **MATCH** `result`：
 
 - 全部通过，无 P0/P1 遗留 → **DONE**
   - 产出目录：`docs/tasks/{slug}/`
   - 文件清单：`11-review.md` / `12-asset-update.md` / `13-retrospective.md` / `task-rules.md`
   - 审查结果：`{N}` 个文件审查，发现 `{N}` 个问题
-  - 修复记录：直接修复 `{N}` 个，回退 team-impl `{N}` 个，回退 team-spec `{N}` 个，人类决策 `{N}` 个
+  - 修复记录：直接修复 `{N}` 个，回退 `team-impl` `{N}` 个，回退 `team-spec` `{N}` 个，人类决策 `{N}` 个
   - 资产更新：`{N}` 个文件已更新
   - → 编排器将补全团队级证据并交付用户验收
 - 全部通过但有保留意见（P2 建议未采纳等） → **DONE_WITH_CONCERNS**

package/skills/team-review/references/11-review-template.md

@@ -13,7 +13,7 @@
 | 安全       | ✅/⚠️    |
 | 测试覆盖   | ✅/⚠️    |
 
-## 一.5、Constitutional 合规检查
+## 二、Constitutional 合规检查
 
 | 规则             | 结果     | 说明 |
 | ---------------- | -------- | ---- |
@@ -28,7 +28,7 @@
 | 回退次数上限     | ✅/⚠️/❌ | ...  |
 | 验证先行原则     | ✅/⚠️/❌ | ...  |
 
-## 二、发现的问题
+## 三、发现的问题
 
 ### P0（必须修复）
 
@@ -48,7 +48,7 @@
 | --- | ---- | ---- | -------- | -------- | -------- |
 | ... | ...  | ...  | ...      | 自行修复 | ...      |
 
-## 三、修复记录
+## 四、修复记录
 
 | ID  | 修复方式    | 修复内容 | 验证方式     | 状态 |
 | --- | ----------- | -------- | ------------ | ---- |
@@ -56,7 +56,7 @@
 | ... | → team-impl | ...      | ...          | ⏳   |
 | ... | → ASK_HUMAN        | ...      | ...          | ⏳   |
 
-## 四、剩余风险
+## 五、剩余风险
 
 | 风险描述 | 影响 | 接受理由 |
 | -------- | ---- | -------- |

package/skills/team-review/references/12-asset-update-template.md

@@ -28,7 +28,7 @@
 - **规则内容**：{具体规则}
 - **触发条件**：{什么情况下触发}
 - **可执行指令**：{具体做什么}
-- **消费方**：{哪些下游 Agent 会用到这条规则}
+- **消费方**：{哪些下游 Skill 会用到这条规则}
 - **示例**：
   - ✅ 正确：{好的做法}
   - ❌ 错误：{坏的做法}

package/skills/team-review/references/13-retrospective-template.md

@@ -26,14 +26,14 @@
 
 - ...
 
-## 二.5、本次沉淀的新规则
+## 三、本次沉淀的新规则
 
 | 新规则 | 写入位置                 | 为什么需要这条规则                          |
 | ------ | ------------------------ | ------------------------------------------- |
 | ...    | 项目 AI 规范 §{section}  | 本次发现 {pattern}，需固化为规则避免重复    |
 | ...    | docs/review-checklist.md | 本次 Review 发现 {issue type}，需加入检查项 |
 
-## 三、下次改进承诺
+## 四、下次改进承诺
 
 | 改进项 | 具体行动 | 预期效果 |
 | ------ | -------- | -------- |

package/skills/team-score/SKILL.md

@@ -11,7 +11,7 @@ description: Use when evaluating AI collaboration maturity of a project
 
 ```
 角色：协作评分评委——证据驱动，找不到证据 = 0 分
-核心原则：只相信物证，不相信口供。默认 0 分，找到证据才加分（First Principle #4）
+核心原则：只相信物证，不相信口供。默认 0 分，找到证据才加分 `_team-rules/first-principles.md: First Principle #4`
 流程：
 1. 按 5 个维度分别收集证据（可并行扫描）
 2. 逐条检查 7 项硬门槛，任一不通过则标记不通过
@@ -24,7 +24,7 @@ description: Use when evaluating AI collaboration maturity of a project
 
 ### 推理检查点
 
-**核心指令**："项目做得不错"是口供，`06-tdd-log.md` 中 RED 时间戳早于 GREEN 是物证。每个评分项有罪推定——默认 0 分，找到证据才加分（First Principle #4）。
+**核心指令**："项目做得不错"是口供，`06-tdd-log.md` 中 RED 时间戳早于 GREEN 是物证。每个评分项有罪推定——默认 0 分，找到证据才加分 `_team-rules/first-principles.md: First Principle #4`。
 
 **推理框架**：
 
@@ -382,7 +382,7 @@ NO SCORE WITHOUT EVIDENCE FIRST
 
 ## STOP_SIGNALS
 
-- **凭印象**给分，没有找到实际文件或代码作为证据
+- **评分**凭印象而非证据，没有找到实际文件或代码
 - **跳过**无证据的评分项而不标注"未找到"
 - **只扫描**代码目录而不检查文档和测试目录
 - **省略**按优先级排列的改进建议
@@ -418,11 +418,16 @@ NO SCORE WITHOUT EVIDENCE FIRST
 
 ## CONSTITUTIONAL_RULES
 
-引用 `_team-rules/constitutional-rules.md`。评分阶段需特别验证被评项目对以下规则的遵守情况：
+**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
+**REF** `_team-rules/ai-collaboration-standards.md` — AI 协作资产与 Prompt 工程规范
+**REF** `_team-rules/verification-protocol.md` — 5 步验证协议
 
-- **Rule #9 TDD 顺序不可逆**：检查 06-tdd-log.md 中 RED→GREEN 的时间序证据（First Principle #2）
-- **Rule #3 产出必须验证**：检查验证声明是否基于当次新鲜执行（First Principle #4）
-- **Rule #1 人类介入是一等公民**：检查 CONFIRM_GOAL-HUMAN_ACCEPT 确认记录是否存在（First Principle #1）
+评分阶段需特别验证被评项目对以下规则的遵守情况：
+
+- **Rule #9 TDD 顺序不可逆**：检查 06-tdd-log.md 中 RED→GREEN 的时间序证据 `_team-rules/first-principles.md: First Principle #2`
+- **Rule #3 产出必须验证**：检查验证声明是否基于当次新鲜执行 `_team-rules/first-principles.md: First Principle #4`
+- **Rule #1 人类介入是一等公民**：检查 CONFIRM_GOAL-HUMAN_ACCEPT 确认记录是否存在 `_team-rules/first-principles.md: First Principle #1`
 
 ## SELF_CHECK
 
@@ -441,6 +446,8 @@ NO SCORE WITHOUT EVIDENCE FIRST
 
 ## COMPLETION
 
+**REF** `_team-rules/four-state-protocol.md` — 四态完成状态
+
 **MATCH** `result`：
 
 - 全部评分完成 + 改进建议已输出 → **DONE**（`总分: {N}/100`, `硬门槛: {N}/7`, `等级: {优秀/良好/合格/不合格}`, `改进建议: {N} 条`）

package/skills/team-security/SKILL.md

@@ -29,7 +29,7 @@ description: Use when AI usage involves sensitive data, external services, or au
 
 ### 推理检查点
 
-> 安全红线不可被任何业务理由绕过（First Principle #4）。"没人会利用这个漏洞"不是安全声明——声明必须基于证据。
+> 安全红线不可被任何业务理由绕过 `_team-rules/first-principles.md: First Principle #4`。"没人会利用这个漏洞"不是安全声明——声明必须基于证据。
 
 **推理框架**：
 
@@ -535,12 +535,16 @@ NO AI OPERATIONS WITHOUT RED LINE CHECK FIRST
 
 ## CONSTITUTIONAL_RULES
 
-引用 `_team-rules/constitutional-rules.md`。安全审计阶段尤其注意：
+**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
+**REF** `_team-rules/verification-protocol.md` — 5 步验证协议
 
-- **Rule #1 人类介入是一等公民**：一级红线违规必须触发 `ASK_HUMAN` 人类介入，不可擅自处置（First Principle #1）
-- **Rule #2 有向图回退**：违规发现须 `ROLLBACK` 到对应上游 Agent（team-spec / team-impl），不可降级忽略（First Principle #4）
-- **Rule #4 Kill Switch**：发现一级红线违规立即暂停，不可在违规基础上继续工作（First Principle #1 + First Principle #3）
-- **Rule #8 验证先行**：每项合规判定基于当次检查的完整输出，不引用历史检查结果（First Principle #4）
+安全审计阶段尤其注意：
+
+- **Rule #1 人类介入是一等公民**：一级红线违规必须触发 `ASK_HUMAN` 人类介入，不可擅自处置 `_team-rules/first-principles.md: First Principle #1`
+- **Rule #2 有向图回退**：违规发现须 `ROLLBACK` 到对应上游 Agent（`team-spec` / `team-impl`），不可降级忽略 `_team-rules/first-principles.md: First Principle #4`
+- **Rule #4 Kill Switch**：发现一级红线违规立即暂停，不可在违规基础上继续工作 `_team-rules/first-principles.md: First Principle #1 + First Principle #3`
+- **Rule #8 验证先行**：每项合规判定基于当次检查的完整输出，不引用历史检查结果 `_team-rules/first-principles.md: First Principle #4`
 
 ## SELF_CHECK
 
@@ -561,6 +565,8 @@ NO AI OPERATIONS WITHOUT RED LINE CHECK FIRST
 
 ## COMPLETION
 
+**REF** `_team-rules/four-state-protocol.md` — 四态完成状态
+
 **MATCH** `result`：
 
 - 全部合规，无红线违规、无不合规项 → **DONE**

package/skills/team-spec/SKILL.md

@@ -102,7 +102,7 @@ NO CODE WITHOUT SPEC FIRST
 
 ### Phase 1.5：探索结论展示 + 需求澄清（人类介入点）
 
-> 写任何文件之前先展示探索结论，获取用户确认。一次最多 3 个问题，优先用选项形式（First Principle #1）。
+> 写任何文件之前先展示探索结论，获取用户确认。一次最多 3 个问题，优先用选项形式 `_team-rules/first-principles.md: First Principle #1`。
 > 目标不是"让用户确认我已经做了探索"，而是"暴露我的理解偏差——我漏了什么、误解了什么"。
 
 **WRITE**（对话中）探索结论：
@@ -239,7 +239,7 @@ NO CODE WITHOUT SPEC FIRST
 
 > 切换到"攻击者"视角——假设这份 SDD 有致命遗漏，你的任务是找到它。"看起来完整"不等于"真的完整"。
 
-> TRAP：你刚写完 SDD，此刻最不适合评价它的质量——实现偏见会让你觉得"写了就是对的"（First Principle #2）。逐条对照检查清单，不要凭感觉。
+> TRAP：你刚写完 SDD，此刻最不适合评价它的质量——实现偏见会让你觉得"写了就是对的" `_team-rules/first-principles.md: First Principle #2`。逐条对照检查清单，不要凭感觉。
 
 **GATE** 产出前逐条检查（不通过则补全后再输出）：
 
@@ -278,11 +278,15 @@ NO CODE WITHOUT SPEC FIRST
 
 ## CONSTITUTIONAL_RULES
 
-引用 `_team-rules/constitutional-rules.md`。规格制定阶段尤其注意：
+**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
+**REF** `_team-rules/spec-driven-workflow.md` — Spec-Driven 开发原则与 TDD 工作流
 
-- **Rule #1 人类介入是一等公民**：规格产出后必须等 CONFIRM_SPEC 确认，不可自动进入实现（First Principle #1）
-- **Rule #4 Kill Switch**：探索阶段发现不可行 → 立即暂停，不可"先写个规格再说"（First Principle #1 + First Principle #3）
-- **Rule #5 分期交付优先**：复杂任务必须拆分分期，不可一次性全量规格（First Principle #3）
+规格制定阶段尤其注意：
+
+- **Rule #1 人类介入是一等公民**：规格产出后必须等 CONFIRM_SPEC 确认，不可自动进入实现 `_team-rules/first-principles.md: First Principle #1`
+- **Rule #4 Kill Switch**：探索阶段发现不可行 → 立即暂停，不可"先写个规格再说" `_team-rules/first-principles.md: First Principle #1 + First Principle #3`
+- **Rule #5 分期交付优先**：复杂任务必须拆分分期，不可一次性全量规格 `_team-rules/first-principles.md: First Principle #3`
 
 ## SELF_CHECK
 
@@ -300,6 +304,8 @@ NO CODE WITHOUT SPEC FIRST
 
 ## COMPLETION
 
+**REF** `_team-rules/four-state-protocol.md` — 四态完成状态
+
 **MATCH** `result`：
 
 - `全部文件产出 && 自检通过` → **DONE**（`模式: {完整/精简}`, `文件: [...]`）

package/skills/team-spec/references/01-plan-template.md

@@ -36,7 +36,7 @@
 
 ### P1（最小可用闭环）— 本次实现
 
-| 阶段 | 类型 | 内容 | 产出物 | 验收标准 | 负责 Agent  |
+| 阶段 | 类型 | 内容 | 产出物 | 验收标准 | 负责 Skill  |
 | ---- | ---- | ---- | ------ | -------- | ----------- |
 | 1    | 探索 | ...  | ...    | ...      | team-spec   |
 | 2    | 方案 | ...  | ...    | ...      | team-spec   |
@@ -62,7 +62,7 @@
 ## 三、执行链路
 
 team-spec → team-impl → team-test → team-review
-每个 Agent 的产出文件是下一个 Agent 的输入。
+每个 Skill 的产出文件是下一个 Skill 的输入。
 
 ## 四、给 AI 的任务提示词
 

package/skills/team-spec/references/04-boundary-template.md

@@ -1,6 +1,6 @@
 # 修改边界
 
-> team-spec 产出 | team-impl 必须严格遵守
+> `team-spec` 产出 | `team-impl` 必须严格遵守
 
 ## 允许修改的文件
 

package/skills/team-spec/references/sdd-template.md

@@ -1,6 +1,6 @@
 # SDD 规格说明：{功能名}
 
-> team-spec 产出 | 本文件是 team-impl 和 team-test 的唯一规格输入
+> `team-spec` 产出 | 本文件是 `team-impl` 和 `team-test` 的唯一规格输入
 
 ## 一、背景与动机
 

package/skills/team-test/SKILL.md

@@ -25,7 +25,7 @@ description: Use when implementation exists and you need test matrix + coverage
 
 ### 推理检查点
 
-**核心指令**：找不到 bug 是因为还没找够，不是因为不存在。"测试全部通过"是待验证声明（First Principle #4）。忠于 SDD 规格，不被实现偏见引导。
+**核心指令**：找不到 bug 是因为还没找够，不是因为不存在。"测试全部通过"是待验证声明 `_team-rules/first-principles.md: First Principle #4`。忠于 SDD 规格，不被实现偏见引导。
 
 **推理框架**：
 
@@ -59,7 +59,7 @@ NO COVERAGE CLAIMS WITHOUT SDD TRACEABILITY FIRST
 
 - `03-sdd.md`（规格）
 - `06-tdd-log.md`（TDD 日志）
-- team-impl 的代码变更和测试文件
+- `team-impl` 的代码变更和测试文件
 
 ### 完整输入（编排模式）
 
@@ -134,7 +134,7 @@ Phase 1 只分析，不写测试代码。
 > TRAP：写出"测试 mock 而非代码"的测试——mock 返回预期值，断言 mock 返回值等于预期值，永远通过。测试必须穿透 mock 层验证真实逻辑。
 > TRAP：测试紧耦合实现细节（如断言内部方法调用次数、私有状态）。实现重构后测试全部失败 ≠ 发现了 bug，= 测试设计有问题。
 
-> First Principle #2：实现偏见污染验证——修改实现代码会让 team-test 变成 team-impl 的共犯。
+> `_team-rules/first-principles.md: First Principle #2`：实现偏见污染验证——修改实现代码会让 team-test 变成 team-impl 的共犯。
 
 **IF** 新测试揭示真实 bug → 不修复实现，Phase 6 向编排器报告：建议路由到 `team-impl`
 
@@ -202,9 +202,9 @@ Phase 1 只分析，不写测试代码。
 
 - `failures != 0` → **GOTO** Phase 5（重新排查失败原因）
 
-> First Principle #4：声明不等于事实——跳过失败的测试套件不会让 bug 消失。
+> `_team-rules/first-principles.md: First Principle #4`：声明不等于事实——跳过失败的测试套件不会让 bug 消失。
 
-**验证协议**（声明"测试通过"前须执行 `_team-rules/verification-protocol.md` 的 5 个步骤）
+**验证协议**：声明"测试通过"前须执行 `_team-rules/verification-protocol.md: 验证执行步骤`
 
 ### Phase 6：回退路由决策
 
@@ -237,17 +237,20 @@ Phase 1 只分析，不写测试代码。
 ## STOP_SIGNALS
 
 - **检查**测试但不对照 SDD，或只覆盖 Happy Path
-- **决定**擅自实现 spec 遗漏（应向编排器报告路由到 team-spec）
+- **决定**擅自实现 spec 遗漏（应向编排器报告路由到 `team-spec`）
 - **修改**测试让它通过，或声明覆盖无量化证据
 - **跳过**失败继续产出文档
 
 ## CONSTITUTIONAL_RULES
 
-引用 `_team-rules/constitutional-rules.md`。测试审计阶段尤其注意：
+**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 
-- **Rule #8 验证先行**：覆盖率声明必须基于当次新鲜执行的完整输出，不可引用缓存结果（First Principle #4）
-- **Rule #3 产出必须验证**：测试矩阵中的每个覆盖声明必须有对应的测试运行证据（First Principle #4）
-- **Rule #2 有向图回退**：发现 spec 遗漏必须向编排器报告路由到 team-spec，发现实现 bug 必须向编排器报告路由到 team-impl，不可擅自修改实现代码（First Principle #4）
+测试审计阶段尤其注意：
+
+- **Rule #8 验证先行**：覆盖率声明必须基于当次新鲜执行的完整输出，不可引用缓存结果 `_team-rules/first-principles.md: First Principle #4`
+- **Rule #3 产出必须验证**：测试矩阵中的每个覆盖声明必须有对应的测试运行证据 `_team-rules/first-principles.md: First Principle #4`
+- **Rule #2 有向图回退**：发现 spec 遗漏必须向编排器报告路由到 `team-spec`，发现实现 bug 必须向编排器报告路由到 `team-impl`，不可擅自修改实现代码 `_team-rules/first-principles.md: First Principle #4`
 
 ## SELF_CHECK
 
@@ -269,6 +272,8 @@ Phase 1 只分析，不写测试代码。
 
 ## COMPLETION
 
+**REF** `_team-rules/four-state-protocol.md` — 四态完成状态
+
 **MATCH** `result`：
 
 - 全量通过 + 矩阵完整 → **DONE**（`补充测试: {N}`, `全量: {N} pass / {N} fail`, `路由: → team-review`）

package/skills/team-test/references/10-test-report-template.md

@@ -41,7 +41,7 @@
 
 - 失败输出：{粘贴关键错误信息}
 - 根因分析：{分析失败原因}
-- 路由决策：→ team-impl（bug）/ → team-spec（spec 遗漏）/ → ASK_HUMAN
+- 路由决策：→ `team-impl`（bug）/ → `team-spec`（spec 遗漏）/ → **ASK_HUMAN**
 
 ## 六、补充测试记录
 

package/skills/team-verify/SKILL.md

@@ -16,7 +16,7 @@ description: Use when about to claim work is complete, fixed, or passing - requi
 
 ### 推理检查点
 
-> 对所有声明零信任（First Principle #4）。上一轮结果是历史，不是当前事实。
+> 对所有声明零信任 `_team-rules/first-principles.md: First Principle #4`。上一轮结果是历史，不是当前事实。
 
 **推理框架**：
 
@@ -132,7 +132,9 @@ NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE FIRST
 
 1. 记录失败原因和错误输出
 2. 修复环境问题 → **EXEC** `verify_cmd`
-   - **IF** `exit_code == 0` → **GOTO** Step 3
+   - **ASSERT** `exit_code == 0`
+     - 通过 → **GOTO** Step 3
+     - 失败 → 继续 **REPEAT**
 3. 继续 **REPEAT**
 
 - *REPEAT_EXHAUSTED* → **BLOCKED**，触发 **ASK_HUMAN**
@@ -156,17 +158,19 @@ NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE FIRST
 
 ## STOP_SIGNALS
 
-- 使用推测性语言（"应该""可能""看起来"）声明通过
-- 引用上一轮运行结果而非当次新鲜执行
-- 跳过部分输出或 warning 就声明通过
-- 表达满意（"太好了""完美""完成了"）在验证之前
+- **使用**推测性语言（"应该""可能""看起来"）声明通过
+- **引用**上一轮运行结果而非当次新鲜执行
+- **跳过**部分输出或 warning 就声明通过
+- **表达**满意（"太好了""完美""完成了"）在验证之前
 
 ## CONSTITUTIONAL_RULES
 
-> 引用 `_team-rules/constitutional-rules.md`
+**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/verification-protocol.md` — 5 步验证协议
+**REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 
-- **Rule #8 验证先行**：本 skill 的核心使命——每个声明基于当次新鲜证据（First Principle #4）
-- **Rule #3 产出必须验证**：验证者自身的声明也不例外——报告必须含结构化证据（First Principle #4）
+- **Rule #8 验证先行**：本 skill 的核心使命——每个声明基于当次新鲜证据 `_team-rules/first-principles.md: First Principle #4`
+- **Rule #3 产出必须验证**：验证者自身的声明也不例外——报告必须含结构化证据 `_team-rules/first-principles.md: First Principle #4`
 
 ## SELF_CHECK
 
@@ -185,6 +189,8 @@ NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE FIRST
 
 ## COMPLETION
 
+**REF** `_team-rules/four-state-protocol.md` — 四态完成状态
+
 **MATCH** `result`：
 
 - 全部通过 → **DONE**

package/skills/using-team-skills/SKILL.md

@@ -54,18 +54,18 @@ NO SKILL RECOMMENDATION WITHOUT SCENE ANALYSIS FIRST
 
 | 场景 | 推荐 Skill |
 |------|-----------|
-| 需求模糊，先讨论再决定 | team-brainstorm |
-| 需求明确，需完整规格 | team-spec |
-| 规格已有，需 TDD 实现 | team-impl |
-| 实现已有，需测试审计 | team-test |
-| 代码 + 测试已有，需审查 | team-review |
-| 收到代码审查反馈，需应对 | team-feedback |
-| 遇到 bug，需根因分析 | team-debug |
-| 声明完成，需验证门禁 | team-verify |
-| 实现完成，需处理分支 | team-finish |
-| 评估项目 AI 协作成熟度 | team-score |
-| AI 使用涉及安全合规 | team-security |
-| 需完整交付流水线 | team-orchestrator |
+| 需求模糊，先讨论再决定 | `team-brainstorm` |
+| 需求明确，需完整规格 | `team-spec` |
+| 规格已有，需 TDD 实现 | `team-impl` |
+| 实现已有，需测试审计 | `team-test` |
+| 代码 + 测试已有，需审查 | `team-review` |
+| 收到代码审查反馈，需应对 | `team-feedback` |
+| 遇到 bug，需根因分析 | `team-debug` |
+| 声明完成，需验证门禁 | `team-verify` |
+| 实现完成，需处理分支 | `team-finish` |
+| 评估项目 AI 协作成熟度 | `team-score` |
+| AI 使用涉及安全合规 | `team-security` |
+| 需完整交付流水线 | `team-orchestrator` |
 
 ## STEPS
 
@@ -133,15 +133,18 @@ NO SKILL RECOMMENDATION WITHOUT SCENE ANALYSIS FIRST
 ## STOP_SIGNALS
 
 - **跳过**场景分析直接推荐 Skill
-- **推荐**实现类 Skill 给场景模糊的用户（应推荐 team-brainstorm）
-- **凭记忆**推荐而不读取当前版本的选择矩阵
+- **推荐**实现类 Skill 给场景模糊的用户（应推荐 `team-brainstorm`）
+- **依赖**记忆推荐而不读取当前版本的选择矩阵
 
 ## CONSTITUTIONAL_RULES
 
-引用 `_team-rules/constitutional-rules.md`。分诊阶段尤其注意：
+**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 
-- **Rule #1 人类介入是一等公民**：推荐后等待用户确认再启动 skill，不可自动跳转（First Principle #1）
-- **Rule #4 Kill Switch**：用户需求明显不可行时应告知而非推荐 skill 继续（First Principle #1 + First Principle #3）
+分诊阶段尤其注意：
+
+- **Rule #1 人类介入是一等公民**：推荐后等待用户确认再启动 skill，不可自动跳转 `_team-rules/first-principles.md: First Principle #1`
+- **Rule #4 Kill Switch**：用户需求明显不可行时应告知而非推荐 skill 继续 `_team-rules/first-principles.md: First Principle #1 + First Principle #3`
 
 ## SELF_CHECK
 
@@ -158,6 +161,8 @@ NO SKILL RECOMMENDATION WITHOUT SCENE ANALYSIS FIRST
 
 ## COMPLETION
 
+**REF** `_team-rules/four-state-protocol.md` — 四态完成状态
+
 **MATCH** `result`：
 
 - 推荐已给出且用户确认 → **DONE**