universal-dev-standards 6.8.0 → 6.9.0

package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md

@@ -1,7 +1,7 @@
 # UDS 功能参考手册
 
 > Universal Development Standards - 完整功能文档
-> Auto-generated | Last updated: 2026-08-19
+> Auto-generated | Last updated: 2026-09-14
 
 **Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | [繁體中文](../../zh-TW/docs/FEATURE-REFERENCE.md) | 简体中文
 
@@ -14,10 +14,10 @@
 3. [技能](#skills) (55)
 4. [代理](#agents) (5)
 5. [工作流程](#workflows) (5)
-6. [核心规范](#core-standards) (150)
-7. [脚本](#scripts) (54)
+6. [核心规范](#core-standards) (152)
+7. [脚本](#scripts) (59)
 
-**Total Features: 343**
+**Total Features: 350**
 
 ---
 
@@ -49,10 +49,10 @@
 | `--framework` | Framework extension (fat-free) |
 | `--locale` | Locale extension (zh-tw) |
 | `--skills-location` | Skills location (marketplace, user, project, none) [default: marketplace] |
-| `--content-mode` | Content mode for integration files (minimal, index, full) [default: index] |
+| `--content-mode` | Content mode for integration files (minimal, index) [default: index]; full is retired and resolves to index |
 | `--agents-md` | Generate AGENTS.md universal summary |
 | `--no-agents-md` | Skip AGENTS.md generation |
-| `--with-hooks` | Install enforcement hooks (commit-msg, security, logging) |
+| `--with-hooks` | Install enforcement hooks declared by the installed standards |
 | `--content-layout` | Content layout (flat, layered) [default: flat] |
 | `-y, --yes` | Use defaults, skip interactive prompts |
 | `-E, --experimental` | Enable experimental features (methodology) |
@@ -153,6 +153,7 @@
 | `--plan` | Show reconciliation plan without executing (like terraform plan); combines with --skills/--commands to plan just that scope, still writing nothing |
 | `--apply` | Apply exactly the plan --plan prints (plain `uds update` does not); with --skills/--commands it does the reconciliation AND that scope, not only the scope |
 | `--force` | Force update all files, ignoring hash comparison |
+| `--prune` | Delete .standards/ files UDS wrote but no longer ships (listed without this flag; never touches files UDS did not write) |
 | `--rollback` | Rollback to the most recent backup |
 | `--locale` | Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env |
 
@@ -182,6 +183,8 @@
 | `--trend` | Show historical score trend (use with --score) |
 | `--ci` | CI mode: output score only, exit 1 if below threshold (use with --score) |
 | `--threshold` | Score threshold for CI mode (default: 75) |
+| `--effects` | Static effect boundary gate: do the implementations of each declared effect interface reach anything outside this process |
+| `--effects-config` | Path to the effect-family config (default: .uds/effect-boundary.json) |
 
 ### `uds deps`
 
@@ -425,10 +428,10 @@
 
 | Standard | 版本 | 说明 |
 |----------|---------|-------------|
-| `acceptance-criteria-traceability` | 1.1.0 |  |
+| `acceptance-criteria-traceability` | 1.2.0 |  |
 | `acceptance-test-driven-development` | 1.1.0 |  |
 | `accessibility-standards` | 1.1.0 | This standard defines comprehensive guidelines for creating accessible software  |
-| `adr-standards` | 1.0.0 | Architecture Decision Records capture the context, options, and rationale behind |
+| `adr-standards` | 1.1.0 | Architecture Decision Records capture the context, options, and rationale behind |
 | `adversarial-test` | - |  |
 | `agent-behavior-discipline` | 1.0.0 | This standard defines four behavioral disciplines for AI agents that elevate per |
 | `agent-communication-protocol` | 1.0.0 | Define a unified communication protocol for AI agents across the AsiaOstrich pro |
@@ -456,7 +459,7 @@
 | `checkin-standards` | 1.8.0 | This standard defines quality gates that MUST be passed before committing code t |
 | `circuit-breaker` | - |  |
 | `class-level-fix` | 1.1.0 | A defect is almost never alone. It is one member of a set — one flag in a dispat |
-| `code-review-checklist` | 1.4.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
+| `code-review-checklist` | 1.5.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
 | `commit-message-guide` | 1.3.0 | Standardized commit messages improve code review efficiency, facilitate automate |
 | `container-image-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
 | `container-security` | - |  |
@@ -469,6 +472,7 @@
 | `data-migration-testing` | - |  |
 | `data-pipeline` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
 | `database-standards` | 1.0.0 | This standard defines guidelines for database design, querying, migration, and o |
+| `deferred-item-exit` | 1.0.0 | Several standards require documents that **produce deferred items** — an ADR's a |
 | `deployment-standards` | 1.1.0 | This standard defines guidelines for safely deploying software to production, co |
 | `deprecation-standards` | 1.1.0 |  |
 | `design-document-standards` | 1.0.0 |  |
@@ -483,7 +487,7 @@
 | `estimation-standards` | 1.0.0 |  |
 | `execution-history` | 1.0.0 |  |
 | `failure-source-taxonomy` | - |  |
-| `feature-discovery-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-05-13 |  |
+| `feature-discovery-standards` | 1.1.0 | **Status**: Active | **Updated**: 2026-08-24 |  |
 | `feature-flag-standards` | 1.0.0 |  |
 | `feature-manifest-standard` | - |  |
 | `flaky-test-management` | - |  |
@@ -493,7 +497,7 @@
 | `full-coverage-testing` | - |  |
 | `git-workflow` | 1.4.0 | This standard defines Git branching strategies and workflows to ensure consisten |
 | `git-worktree` | 1.1.0 | Define a lifecycle for using Git worktrees to isolate development work, ensuring |
-| `governance-layer` | 1.0.0 | A governance layer provides a shared anchor for all agents and roles in a projec |
+| `governance-layer` | 1.1.0 | A governance layer provides a shared anchor for all agents and roles in a projec |
 | `health-check-standards` | - |  |
 | `iac-design-principles` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
 | `immutability-first` | - |  |
@@ -532,9 +536,9 @@
 | `replay-test` | - |  |
 | `requirement-engineering` | 1.1.0 |  |
 | `resource-cost-boundary` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
-| `retrospective-standards` | 1.0.0 | Retrospectives are structured team reflections that identify what worked well, w |
+| `retrospective-standards` | 1.1.0 | Retrospectives are structured team reflections that identify what worked well, w |
 | `retry-standards` | - |  |
-| `reverse-engineering-standards` | 1.2.0 | This standard defines the principles, workflows, and best practices for reverse  |
+| `reverse-engineering-standards` | 1.3.0 | This standard defines the principles, workflows, and best practices for reverse  |
 | `rollback-standards` | - |  |
 | `runbook-standards` | 1.0.0 |  |
 | `runbook` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
@@ -551,14 +555,14 @@
 | `slo-sli` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
 | `slo-standards` | 1.0.0 |  |
 | `smoke-test` | - |  |
-| `spec-driven-development` | 2.4.0 |  |
+| `spec-driven-development` | 2.5.0 |  |
 | `standard-admission-criteria` | - |  |
 | `standard-lifecycle-management` | - |  |
 | `structured-task-definition` | 1.0.0 |  |
 | `supply-chain-attestation` | - |  |
 | `supply-chain-security-standards` | 1.1.0 |  |
 | `systematic-debugging` | 1.0.0 | Define a structured, four-phase debugging workflow that prevents the common anti |
-| `tech-debt-standards` | 1.0.0 |  |
+| `tech-debt-standards` | 1.1.0 |  |
 | `test-completeness-dimensions` | 1.1.0 | This document defines a systematic framework for evaluating test completeness. I |
 | `test-data-standards` | 1.0.0 |  |
 | `test-driven-development` | 1.2.0 |  |
@@ -567,6 +571,7 @@
 | `timeout-standards` | - |  |
 | `token-budget` | - |  |
 | `translation-lifecycle-standards` | 1.0.1 | Translation lifecycle standards: MISSING vs OUTDATED distinction, semver-aware s |
+| `turn-completion-integrity` | 1.3.0 | An agent writes *"I'll do X next"* and then ends the turn without doing X. |
 | `user-journey-testing` | - |  |
 | `user-story-mapping` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
 | `verification-evidence` | 1.3.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
@@ -590,6 +595,7 @@
 | `check-ai-agent-sync.ps1` | Check Ai Agent Sync |
 | `check-ai-agent-sync.sh` | AI Agent Sync Checker |
 | `check-ai-yaml-parses.mjs` | Every shipped .ai.yaml must parse, and must parse into what it says. |
+| `check-bump-sync-roundtrip.mjs` | check-bump-sync-roundtrip — 測「跑完 bump 之後 check 必須通過」這個不變量。 |
 | `check-cli-docs-sync.ps1` | Check Cli Docs Sync |
 | `check-cli-docs-sync.sh` | CLI-to-Documentation Sync Checker |
 | `check-commands-sync.ps1` | Check Commands Sync |
@@ -599,6 +605,7 @@
 | `check-docs-integrity.sh` | Documentation Integrity Checker |
 | `check-docs-sync.ps1` | Check Docs Sync |
 | `check-docs-sync.sh` | Documentation Sync Checker |
+| `check-error-exit.mjs` | 🔴 沒填就是沒設定，而沒設定會 exit 2， |
 | `check-external-references.mjs` | External Reference Checker (SPEC-SELFDIAG-001 REQ-5, AC-7) |
 | `check-orphan-specs.ps1` | Check Orphan Specs |
 | `check-orphan-specs.sh` | Orphan Spec Detection Script |
@@ -612,6 +619,7 @@
 | `check-standards-reference-sync.sh` | check-standards-reference-sync.sh |
 | `check-standards-sync.ps1` | Check Standards Sync |
 | `check-standards-sync.sh` | Standards Consistency Checker |
+| `check-translation-hash-ratchet.sh` | XSPEC-392 R6 棘輪：新的翻譯必須帶 source_hash，既有的欠債冷凍為基線。 |
 | `check-translation-sync.ps1` | Check Translation Sync |
 | `check-translation-sync.sh` | Translation Sync Checker |
 | `check-usage-docs-sync.ps1` | Check if usage documentation needs to be regenerated |
@@ -623,7 +631,9 @@
 | `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
 | `fix-manifest-paths.ps1` | Fix Manifest Paths |
 | `fix-manifest-paths.sh` | Manifest Path Fixer |
+| `generate-adoption-skills.mjs` | Self-Adoption Skill Copy Generator and Drift Gate — XSPEC-385 |
 | `generate-docs.mjs` | Look up the release date for `version` from CHANGELOG.md's own |
+| `generate-llms-txt.mjs` | llms.txt Generator and Drift Gate — XSPEC-385 |
 | `generate-locale-coverage.mjs` | Locale Coverage Generator |
 | `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9, AC-14) |
 | `install-hooks.mjs` | Install Hooks |

package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md

@@ -58,7 +58,6 @@ status: current
 
 **配置方式**：
 - 安裝时选择 `standardsScope: full` + Skills 安裝
-- 或透過 `contentMode: full` 獲得完整规范
 
 **包含内容**：
 - 16 个 Claude Code Skills
@@ -212,7 +211,7 @@ uds init -y --skills-location marketplace --content-mode index
 
 **配置方式**：
 ```bash
-uds init -y --skills-location none --content-mode full
+uds init -y --skills-location none --content-mode index
 ```
 
 ### 場景 4：学习 UDS 标准体系

package/bundled/locales/zh-CN/integrations/google-antigravity/{INSTRUCTIONS.md → AGENTS.md}

@@ -1,5 +1,5 @@
 ---
-source: ../../../../integrations/google-antigravity/INSTRUCTIONS.md
+source: ../../../../integrations/google-antigravity/AGENTS.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-13

package/bundled/locales/zh-CN/integrations/google-antigravity/README.md

@@ -19,7 +19,7 @@ Google Antigravity 是一个先进的代理程序代码开发助理。此集成
 - **[.antigravity/rules.md](../../../../integrations/google-antigravity/.antigravity/rules.md)**（推荐）：
   项目级规则文件，Antigravity 会自动加载。
 
-- **[INSTRUCTIONS.md](./INSTRUCTIONS.md)**：
+- **[AGENTS.md](./AGENTS.md)**：
   用于手动配置的系统提示词片段。
 
 ## 规则配置
@@ -53,7 +53,7 @@ curl -o .antigravity/rules.md https://raw.githubusercontent.com/AsiaOstrich/univ
    确保 `core/` 规范已复制到您的项目（例如 `.standards/`）。
 
 2. **配置代理**：
-   将 `INSTRUCTIONS.md` 的内容复制到您的 Antigravity「用户规则」或特定任务指令中。
+   将 `AGENTS.md` 的内容复制到您的 Antigravity「用户规则」或特定任务指令中。
 
 ### 验证合规性
 
@@ -65,7 +65,7 @@ curl -o .antigravity/rules.md https://raw.githubusercontent.com/AsiaOstrich/univ
 
 - [防幻觉规范](../../../../core/anti-hallucination.md)
 - [Commit 消息指南](../../../../core/commit-message-guide.md)
-- [INSTRUCTIONS.md](./INSTRUCTIONS.md)
+- [AGENTS.md](./AGENTS.md)
 
 ---
 

package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md

@@ -77,5 +77,7 @@ So that [benefit].
 
 ## 参考
 
+- [验收标准撰写指南](./acceptance-criteria-guide.md) — 要撰写或审查验收标准时读它。
+- [ATDD 工作流程指南](./atdd-workflow.md) — 要完整跑一轮 ATDD 循环时读它。
 - 详细指南：[guide.md](./guide.md)
 - 核心规范：[acceptance-test-driven-development.md](../../../../core/acceptance-test-driven-development.md)

package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md

@@ -74,5 +74,7 @@ Feature: User Login
 
 ## 参考
 
+- [BDD 工作流程指南](./bdd-workflow.md) — 要把探索、制定、自动化当一个循环跑时读它。
+- [Gherkin 快速参考指南](./gherkin-guide.md) — 要写 Given／When／Then 而需要确切语法时读它。
 - 详细指南：[guide.md](./guide.md)
 - 核心规范：[behavior-driven-development.md](../../../../core/behavior-driven-development.md)

package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: brainstorm-assistant
 source: ../../../../skills/brainstorm-assistant/SKILL.md
-source_version: 4.1.0
-source_hash: 711404f2c4af
-translation_version: 4.2.0
-last_synced: 2026-08-17
+source_version: 4.2.0
+source_hash: 02e63146c84e
+translation_version: 4.3.0
+last_synced: 2026-08-24
 status: current
 description: |
   [UDS] 在规格出现之前执行的结构化多角色头脑风暴，并附带评分质量关卡。
@@ -26,6 +26,10 @@ description: |
 
 **v4 的核心改动:** v3 提供了强健的*机制*，却没有可判定 pass/fail 的质量闸。v4 在其上叠加一道**时序化质量契约**——**头脑风暴质量标准（BQS v1）**——且不移除任何 v3 行为。BQS 是**四层 × 时间轴**结构：第 0 层宣告 explore/exploit 配比；第 1 层（过程、leading、发散期全程可见）跑维度 **D1–D4**；第 2 层（产物、leading、收敛后仅施于推荐集，即 Agg. Score ≥ 3.5、不限笔数的想法）跑 **D5–D8** 加 Seeds 栏与争议区；第 3 层是不受治理的 **Judgment Override**。第一原理：**决策用 leading 信号、校准用 lagging 信号——两者是时间前后，而非对错取舍。** 硬序列闸禁止 D5–D8 在发散期被揭示或评分。详见下方「BQS v1 — 质量契约」。
 
+**v4.2 的核心改动（XSPEC-388）：** D4 原本只钉住判官坐在哪里，一个字都没说它得想得动。一个独立 context 跑字面遵循型模型会逐字满足旧条文，然后照 D5–D8 逐条打勾放行——与一场真的有人反对过的评审在报告上无从分辨。v4.2 给 D4 加上**第二个轴**：评审还必须宣告其**模型层级**要求（见下方术语说明）。CONVERGE 的提示改为**目标＋约束**形状——D5–D8 是判断必须满足的判准，不是按顺序执行的步骤；既有固定句型与逐准则分数指南保留为参考格式。发散侧引用 [core/model-selection.md](../../../../core/model-selection.md)（Standard 或更高）而不另立规则。不移除任何 v3 机制。
+
+> **术语——「模型层级」，不用「tier」：** 在本 skill 内，`tier` 已被占用两次——BQS 分级表（套用哪些维度）与 Enhanced Tier。[core/model-selection.md](../../../../core/model-selection.md) 定义的模型能力轴（该标准称 *model tier*）在本 skill 一律写作**模型层级（model level）**。模型层级是该标准的**厂商中立标签**；本 skill 绝不指名具体厂商模型（见 D4）。
+
 ## 使用前先选模式
 
 使用前套用以下**客观触发条件**。默认为完整 v3，路由规则是跳过阶段的快捷方式，而非额外障碍。
@@ -68,7 +72,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 | **D1 框架纯度** | 问题内嵌特定方案或「像 X 给 Y」→fail；须 5-Whys 到根因 |
 | **D2 发散覆盖** | 存活想法跨 <3 独立 persona/透镜→fail（受第 0 层权重调节）；连一轮零新增才算饱和 |
 | **D3 跨会话多样性** | 种子是竞品类比→fail；Top 全来自单一 lens→fail |
-| **D4 评估去偏** | 须 ≥3 评审 + 硬角色 Devil's Advocate + Steelman；**pass 须在独立 context 执行**，否则标 `[degraded]` 不得标 pass |
+| **D4 评估去偏** | 须 ≥3 评审 + 硬角色 Devil's Advocate + Steelman；**pass 须同时满足两轴**：(1) 独立 context，**且** (2) 以 [model-selection](../../../../core/model-selection.md) 的厂商中立标签宣告**模型层级**要求——指名具体厂商模型即违规。缺任一轴→标 `[degraded]` 不得标 pass |
 
 > **硬序列闸：** D5–D8 禁止在发散期揭示或评分；CONVERGE 的 critic 不得在**最后一个 persona** 产完前被调用。
 
@@ -92,7 +96,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 ### 结构规则
 
 1. **Meta 停止规则：** 该层维度全绿 **且** 再跑一轮后 **推荐集成员不变**（看集合成员、不看内部排序）→停。**硬上限 2 轮**。取代模糊的「不翻决策」。
-2. **判官≠产生者：** D2/D4/D5/D7 判定须独立视角；单 context 自评只能 `[degraded]`，不得 pass。
+2. **判官≠产生者：** D2/D4/D5/D7 判定须独立视角；单 context 自评只能 `[degraded]`，不得 pass。D4 另需宣告模型层级——独立性只是它两轴之一（见 D4）。
 3. **校准回路（吃 lagging）：** v3 的三个工作阶段自评指标收编为此回路 **lagging** 端——**Adoption Rate＝D6 滞后验证、Diversity＝D2/D3 滞后观测、Cognitive Load＝成本约束**；**禁两套平行评估**。
 4. **BQS 自我演化（轻量）：** 版本化 + 证据清单 last-reviewed 逾期 flag；「定期对 BQS 自身 brainstorm」列可选。
 5. **最小充分原则：** 套用该 tier 所需的最少维度 + 把第 2 层限缩在推荐集（Agg. Score ≥ 3.5），而非全部发散想法——认知经济性的守门，不另设成本维度。
@@ -149,6 +153,8 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 
 > **v3 核心机制：** **persona 集成**——每个 persona 以**思维链**在**隔离**状态下推理——再乘上**多样性透镜**。Meincke、Mollick、Terwiesch（2024）发现「思维链 + persona」的想法多样性高于所有受测的提示策略，接近人类团体。光冲数量是弱代理；结构性逼出不同视角才是真正的杠杆。
 
+> **模型层级（发散侧）：** 发散提示只给目标与约束——正是 core/model-selection.md 的 [MS-004](../../../../core/model-selection.md#rules)／[Criterion 2](../../../../core/model-selection.md#criterion-2--specification-definiteness規格明確度) 的触发条件：发散以 **Standard 或更高**层级执行。不是「最高层级」——那会同时超出 MS-004 所说的与我们的证据。lagging 登记：此选择由校准回路既有的 **Diversity（D2/D3 滞后观测）** 栏验证，不另开第二套登记。
+
 #### 步骤 2a —— persona 集成
 
 通过默认 persona 组生成想法。每个 persona **逐步推理（思维链）**，**只从自己的视角**产出 2–4 个想法。用户可用 `--personas` 增减或改名。
@@ -195,9 +201,11 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 
 > **v3 核心机制：** **多评审面板**取代单一加权评分者。单一 LLM 是弱且有偏的评估者（Li 等，2025：LLM 强于生成 / 精炼、弱于评估——人类保留最终裁决权）。三个独立评审透镜各自对每个想法评分后聚合。
 
+> **评审提示形状——目标＋约束（v4.2）：** 对面板、Devil's Advocate、Steelman 派工时——尤其派入独立 context（`--enhanced`）——提示**必须**以**目标＋其判断必须满足的约束**表达，不得写成按顺序执行的步骤清单。D5–D8 与下方的具体性要求是**判准**（「你的判断必须满足这些」），不是**步骤**（「照这个顺序做这些事」）。既有固定句型、逐准则 1–5 指南与评审权重公式**保留为参考格式**，皆非必经步骤。理由：core/model-selection.md 的 [MS-009](../../../../core/model-selection.md#rules)。
+
 #### 步骤 3a：多评审面板
 
-运行**三个独立评审**，各自以自己的透镜对每个想法打 1–5 分。取平均聚合以降低单评审偏误。每位评审皆套用下方的加权公式。
+运行**三个独立评审**，各自以自己的透镜对每个想法打 1–5 分。取平均聚合以降低单评审偏误。下方加权准则定义默认透镜——是参考格式，不是评审必须逐步照走的脚本。
 
 | 评审透镜 | 它负责的加权标准 |
 |----------|------------------|
@@ -205,7 +213,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 | **用户影响** | 影响 70% · 一致性 30% |
 | **战略一致性** | 一致性 60% · 影响 40% |
 
-各标准指引（1–5）：可行性（5=轻而易举 … 1=几乎不可能）；影响（5=变革性 … 1=可忽略）；工作量（5=数小时 … 1=数个季度，反向计分，工作量越低分数越高）；一致性（5=核心使命 … 1=偏离使命）。
+各标准指引（1–5，参考格式）：可行性（5=轻而易举 … 1=几乎不可能）；影响（5=变革性 … 1=可忽略）；工作量（5=数小时 … 1=数个季度，反向计分，工作量越低分数越高）；一致性（5=核心使命 … 1=偏离使命）。
 
 > **可选——RICE / ICE（产品功能）：** 排序可发布功能时用 `RICE =（Reach × Impact × Confidence）/ Effort` 或较轻的 `ICE = Impact × Confidence × Ease`。Effort 交由工程师估、不要让 LLM 估（它没有代码库知识）。RICE 偏好渐进式胜利，别单独用于战略性押注。
 
@@ -213,7 +221,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 
 软性的「请批评一下」指令只会得到附和（谄媚）。v3 指派**硬角色**：对**推荐集**（Agg. Score ≥ 3.5，不限笔数）中的每一个想法各跑一个 **Devil's Advocate**（「你的任务是论证此案会失败」）与一个 **Steelman**（「说出反方最强而善意的版本」）。两者一起对韧性做压力测试，而非只是戳一下。
 
-每个反对理由必须采用以下形式：「在 [具体情境] 下，此想法会失败，因为 [具体原因]。」模糊顾虑（「这可能有点难」）不接受。
+约束：每个反对理由须指出**具体情境**与**具体原因**——模糊顾虑（「这可能有点难」）不接受。句型「在 [具体情境] 下，此想法会失败，因为 [具体原因]」是参考格式，不是必用句式。
 
 用户**必须**对每个反对理由给出回应才能继续：
 
@@ -225,16 +233,17 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 
 **旗标:** `--no-rebuttal` 跳过此步骤；报告区段标注「Rebuttal: skipped」。
 
-> **BQS D4 — 判官≠产生者：** D4 唯有**评审/Devil's Advocate 在独立 context 执行**（`--enhanced` 隔离 agent 宿主）才可 pass。baseline 单 context 下，面板是同 context 自评，标 `[degraded]`、**不得标 pass**——诚实但非独立。不得把 baseline 跑当成 D4 pass 静默通过。
+> **BQS D4 — 判官≠产生者，两轴：** D4 唯有**两轴同时成立**才可 pass。**(1) 座位——独立性**：评审/Devil's Advocate 在独立 context 执行（`--enhanced` 隔离 agent 宿主）。**(2) 心智——宣告模型层级**：评审宣告其**模型层级**要求，以 [core/model-selection.md](../../../../core/model-selection.md) 的厂商中立标签表达；选层依据为该标准的判准（引用，不复述）。指名具体厂商模型即违规——层级标签是唯一合法的表达方式。缺任一轴→面板标 `[degraded]`、**不得标 pass**：独立 context 跑字面遵循型模型会逐字满足座位轴，成为一枚完全合规的橡皮图章——认出「不同名字下的同一件事」是打勾做不到的判断工作。baseline 单 context 下，面板是同 context 自评，标 `[degraded]`、不得 pass——诚实但非独立。不得把 baseline 跑当成 D4 pass 静默通过。
 
 #### 步骤 3c：BQS 第 2 层——对推荐集的产物闸
 
-收敛后，**仅对推荐集**（Agg. Score ≥ 3.5 的想法，不限笔数）套用 **D5–D8**（绝不对全部发散想法）。若无想法达 3.5，仍保留分数最高的 1 个，标记 `[未达门槛——仅供参考]`，避免报告空白。对推荐集中每个想法：
+收敛后，**仅对推荐集**（Agg. Score ≥ 3.5 的想法，不限笔数）套用 **D5–D8**（绝不对全部发散想法）。若无想法达 3.5，仍保留分数最高的 1 个，标记 `[未达门槛——仅供参考]`，避免报告空白。D5–D8 是**判断必须满足的判准**——不限顺序，不是程序。对推荐集中每个想法，判断必须满足：
 
 - **D5 接地：** 将每个主张分流为 `[现状/外部事实]`（需 file:line 或来源，否则 fail）vs `[未来/假说]`（免接地、标 `[假说]`）。**外部事实宣称为跨级地板**——creative 级也须接地。
 - **D6 净值：** 推荐集中每个想法须答「解谁问题／我们真有吗／不做的代价」；至少一个淘汰为「不值得做」；挂 **lagging 登记栏**（事后哪个信号验证）。
 - **D7 可证伪（二态）：** 标 `[现可陈述证伪]` **或** `[需先做 X 才能定义证伪]`。后者**转 next-step 喂 D8——不算 fail**。
 - **D8 可行动：** 每个存活想法需 next-step 裁决（含明确「暂不做」）；无 → fail。
+  - 裁决为「暂不做」者，以及 **Seeds（来自被淘汰的想法）** 中每个被搁置的想法，皆为 [deferred-item-exit](../../../../core/deferred-item-exit.md) 所指的延后项目。
 
 > **Meta 停止规则（BQS 结构规则 1）：** 当套用的维度全绿 **且** 再跑一轮后 **推荐集成员不变**（看集合成员、非内部排序）→停。**硬上限 2 轮。**
 
@@ -289,7 +298,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 - [ ] Proceed to `/sdd` if requirements are clear
 ```
 
-> **BQS 输出新增（v4）：** **Seeds** 区（规则：被杀 ≥1 则非空）、**争议区**（高方差想法不按 mean 淘汰）、**Judgment Override** 通道（人类裁决凌驾聚合分）为 BQS 第 2/3 层所要求。Recommendations 区块为推荐集（不限笔数）中每个想法逐项记录 D5–D8 状态。
+> **BQS 输出新增（v4）：** **Seeds** 区（规则：被杀 ≥1 则非空）、**争议区**（高方差想法不按 mean 淘汰）、**Judgment Override** 通道（人类裁决凌驾聚合分）为 BQS 第 2/3 层所要求。Recommendations 区块为推荐集（不限笔数）中每个想法逐项记录 D5–D8 状态。自 v4.2 起，报告表头并记录评审宣告的**模型层级**（厂商中立标签）——没有它，D4 为 `[degraded]`，且宣告无处可验。
 
 ## 多样性崩塌防护
 
@@ -366,6 +375,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 ## 参考
 
 - 详细指南：[guide.md](./guide.md)
+- 模型层级依据：[core/model-selection.md](../../../../core/model-selection.md)——D4 心智轴与发散侧层级皆以该标准的判准为准。**引用、不复述**——摘要会随来源被更正而腐坏，指针不会。
 
 ## AI 代理行为
 

package/bundled/locales/zh-CN/skills/brainstorm-assistant/guide.md

@@ -1,10 +1,10 @@
 ---
 scope: universal
 source: ../../../../skills/brainstorm-assistant/guide.md
-source_version: 4.1.0
-source_hash: c5cd260548c2
-translation_version: 4.1.0
-last_synced: 2026-07-09
+source_version: 4.2.0
+source_hash: f789b3bbc31a
+translation_version: 4.2.0
+last_synced: 2026-08-21
 status: current
 description: |
   指导在编写规格前进行结构化 AI 辅助头脑风暴。
@@ -16,8 +16,8 @@ description: |
 
 > **语言**: [English](../../../../skills/brainstorm-assistant/guide.md) | 简体中文
 
-**版本**: 4.1.0
-**最后更新**: 2026-07-09
+**版本**: 4.2.0
+**最后更新**: 2026-08-21
 **适用范围**: 所有软件项目
 **Scope**: universal
 **类型**: 工具型 Skill（无对应核心标准）
@@ -292,7 +292,7 @@ HMW（默认起点）、SCAMPER（改善既有功能：Substitute、Combine、Ad
 | **用户影响** | 影响 70% · 对齐 30% |
 | **战略对齐** | 对齐 60% · 影响 40% |
 
-**逐准则指引（1–5）：**
+**逐准则指引（1–5，参考格式——不是评审必须逐步照走的脚本）：**
 
 | 准则 | 5 | 3 | 1 |
 |------|---|---|---|
@@ -318,7 +318,7 @@ HMW（默认起点）、SCAMPER（改善既有功能：Substitute、Combine、Ad
 - **Devil's Advocate**：「你的任务是论证这个想法*会*失败。给出 2 个具体的失败条件。」
 - **Steelman**：「陈述反方论点最强、最善意的版本——一个有思想的对手实际会提出的那种。」
 
-每个反方论点必须采取以下形式：**「这个想法会在 [特定上下文] 失败，因为 [特定理由]。」**
+约束：每个反方论点必须指出**特定上下文**与**特定理由**。句型**「这个想法会在 [特定上下文] 失败，因为 [特定理由]」**是参考格式，不是必用句式（v4.2——评审提示为目标＋约束，见 SKILL.md「评审提示形状」）。
 
 **不可接受**（太空泛）：「这可能很难。」/「可能会有 edge case。」
 
@@ -354,6 +354,7 @@ HMW（默认起点）、SCAMPER（改善既有功能：Substitute、Combine、Ad
 **Personas Used**: [domain expert, skeptic, analogist, ...]
 **Lenses Used**: [analogical, reversal, ...]
 **Pre-flight**: [Completed / Skipped]   **Rebuttal**: [Completed / Skipped]   **Tier**: [Baseline / Enhanced]
+**评审模型层级（D4 心智轴）**: [core/model-selection.md 的厂商中立层级标签——指名厂商模型即违规；未宣告 → D4 [degraded]]
 
 ## Problem Statement
 [Refined problem + root cause from 5 Whys]
@@ -566,7 +567,7 @@ BQS v1 是**叠加的质量契约**，不是推倒重来。v3 的一切都保留
 
 - **所有旗标**：`--personas`、`--lens`、`--enhanced`、`--skip-preflight`、`--no-rebuttal`、`--quick`、`--technique` 行为与 v3 完全相同。v4 仅新增一个可选旗标 `--intent`，供第 0 层宣告。
 - **所有机制**：PRE-FLIGHT 防锚定、FRAME 5-Whys／HMW、persona 集成、多样性透镜、多评审面板、硬角色反驳（Devil's Advocate + Steelman）、多样性坍缩护栏、Enhanced 层，皆不变。
-- **`--enhanced` 隔离 agent 宿主**正是让 BQS **D4 pass**（判官≠产生者）的条件；baseline 单 context 标 `[degraded]`、不静默通过。
+- **`--enhanced` 隔离 agent 宿主**满足的是 BQS **D4 的座位轴**（判官≠产生者）；自 v4.2（XSPEC-388）起，D4 pass 另需评审宣告**模型层级**（心智轴——依 core/model-selection.md 的厂商中立标签）。baseline 单 context 标 `[degraded]`、不静默通过。
 
 ---
 
@@ -601,6 +602,7 @@ BQS v1 是**叠加的质量契约**，不是推倒重来。v3 的一切都保留
 | [Requirement Engineering](../../core/requirement-engineering.md) | 头脑风暴输出馈入需求编写 |
 | [Spec-Driven Development](../../core/spec-driven-development.md) | 头脑风暴输出馈入 SDD 提案 |
 | [Anti-Hallucination](../../core/anti-hallucination.md) | 评审的可行性主张必须基于证据，而非断言 |
+| [Model Selection](../../core/model-selection.md) | D4 心智轴（宣告模型层级）与发散侧层级（Standard 或更高）皆以此标准的判准为准——引用、绝不复述 |
 
 ---
 
@@ -608,6 +610,7 @@ BQS v1 是**叠加的质量契约**，不是推倒重来。v3 的一切都保留
 
 | 版本 | 日期 | 变更 |
 |------|------|------|
+| 4.2.0 | 2026-08-21 | XSPEC-388：D4 的 pass 条件加上第二个轴——座位（独立 context，不变）加上心智（评审必须宣告其**模型层级**要求，且只能以 core/model-selection.md 的厂商中立标签表达；指名具体厂商模型即违规；未宣告 → `[degraded]`、不得 pass）。CONVERGE 评审提示依 MS-009 改为目标＋约束形状：D5–D8 以「判断必须满足的判准」呈现、不得以按顺序执行的程序呈现；固定反驳句型、逐准则 1–5 指引与评审权重公式保留为参考格式、非必经步骤。发散侧引用 MS-004／Criterion 2（Standard 或更高——刻意不是「最高」），由校准回路既有的 Diversity（D2/D3）lagging 栏验证。术语：模型能力轴全文写作「模型层级」，因为「tier」已被 BQS 分级与 Enhanced Tier 占用。所有 v3 旗标与机制保留。 |
 | 4.1.0 | 2026-07-09 | XSPEC-325：把固定 Top-3 推荐上限改为分数门槛**推荐集**（Agg. Score ≥ 3.5，不限笔数），贯穿 BQS 第 2 层——产物闸（D5–D8）、硬角色反驳轮（Devil's Advocate + Steelman）、Meta 停止规则（集合成员稳定性）、多样性坍缩护栏、OUTPUT 推荐区块，全部改以推荐集为对象，不再是固定 3 个。若无想法达 3.5，仍显示分数最高的 1 个并标示「未达门槛，仅供参考」，避免报告空白。 |
 | 4.0.0 | 2026-06-22 | XSPEC-296：头脑风暴质量标准（BQS v1）——叠加于 v3 的四层 × 时间轴质量契约。第 0 层 explore/exploit 意图（调节 D2 权重）；第 1 层过程 leading 维度 D1–D4 + 硬序列闸（发散期禁 D5–D8）；第 2 层产物 leading 维度 D5–D8 仅施于 Top 3，加 Seeds 栏与高方差争议区；第 3 层 Judgment Override（凌驾聚合分）。D4 判官≠产生者（须独立 context，否则 `[degraded]`）；D5 主张分流（外部事实跨级地板）；D7 二态证伪（「需先做 X」→next-step、不算 fail）；Meta 停止规则（Top-3 集合稳定 + 硬上限 2 轮）。工作阶段自评重新定位为校准回路 lagging 端（Adoption→D6、Diversity→D2/D3、Cognitive Load→成本；禁两套平行评估）。第一原理修正为「决策用 leading、校准用 lagging」。分级绑客观模式选择触发。新增旗标 `--intent`。所有 v3 旗标／机制保留。 |
 | 3.0.0 | 2026-06-01 | XSPEC-247：DIVERGE 重新聚焦于 persona 集成 + 多样性透镜（类比 / 反转 / 形态学）；CONVERGE 重新聚焦于多评审面板 + 硬角色反驳（Devil's Advocate + Steelman）；多样性坍缩护栏；Enhanced 层级（并行 persona/评审智能体，优雅回退）；Research Foundations 基于 6 项已验证的 2024–2026 出处重建；效度说明重新评级（飞行前为低、Nijstad/Nemeth 降级）；新旗标 `--personas`/`--lens`/`--enhanced`；反种子护栏 |

package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md

@@ -63,5 +63,6 @@ description: |
 
 ## 参考
 
+- [Pre-Commit Checklist（提交前检查清单）](./checkin-checklist.md) — 提交之前当作最后一道检查时读它。
 - 详细指南：[guide.md](./guide.md)
 - 核心规范：[code-review-checklist.md](../../../../core/code-review-checklist.md)

package/bundled/locales/zh-CN/skills/commands/brainstorm.md

@@ -1,9 +1,10 @@
 ---
 source: ../../../../skills/commands/brainstorm.md
-source_version: 4.0.0
-source_hash: b4d32a8b638e
-translation_version: 4.0.0
-last_synced: 2026-07-09
+source_version: 4.2.0
+source_hash: 319f8ad4f02f
+translation_version: 4.2.0
+last_synced: 2026-08-21
+status: current
 ---
 
 ---
@@ -34,7 +35,7 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
 | **PRE-FLIGHT** | 防止 AI 锚定 | 用户先写 3 个想法；不用类比种子；**BQS 第 0 层意图（explore/exploit）** |
 | **FRAME** | 清楚定义问题 | 5 Whys, HMW, Stakeholder Map；**D1 框架纯度** |
 | **DIVERGE** | 逼出视角多样性 | persona 集成 + 多样性透镜；**BQS 第 1 层 D1–D4，硬闸隐藏 D5–D8** |
-| **CONVERGE** | 经偏误检查的选择 | 多评审面板 + Devil's Advocate/Steelman；**BQS 第 2 层 D5–D8 施于 Top 3，D4 判官≠产生者** |
+| **CONVERGE** | 经偏误检查的选择 | 多评审面板 + Devil's Advocate/Steelman；**BQS 第 2 层 D5–D8 施于推荐集（Agg. ≥ 3.5），D4 判官≠产生者（两轴：独立 context＋宣告模型层级）** |
 | **OUTPUT** | 可执行的报告 | Brainstorm Report + Seeds + 争议区 + **第 3 层 Judgment Override** |
 
 > **BQS v1（XSPEC-296）：** v4 在 v3 上叠加四层 × 时间轴质量契约。完整 oracle 与结构规则见 skill：[Brainstorm Assistant Skill](../brainstorm-assistant/SKILL.md#bqs-v1--质量契约)。
@@ -68,7 +69,7 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
 ## Problem Statement
 [Refined problem from FRAME phase]
 
-## Top 3 Recommendations
+## Recommendations (Agg. Score ≥ 3.5 — uncapped)
 1. **[Idea]** — Agg. X.X ✓ Passed rebuttal — Persona: [..] — [Why recommended]
 
 ## Diversity Note
@@ -100,7 +101,7 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
 | `/brainstorm "topic"` | 以指定主题启动 PRE-FLIGHT，再进入 FRAME |
 | `/brainstorm --personas "a,b,c"` | 以自定义 persona 组进入 DIVERGE |
 | `/brainstorm --lens <name>` | 以指定多样性透镜为主进入 DIVERGE |
-| `/brainstorm --enhanced` | 若宿主支持子代理则并行跑 persona/评审，否则静默退回 baseline；此模式下 BQS D4 方可 pass |
+| `/brainstorm --enhanced` | 若宿主支持子代理则并行跑 persona/评审，否则静默退回 baseline；此模式满足 BQS D4 的座位轴（独立 context），pass 另需宣告模型层级（心智轴，见 skill D4） |
 | `/brainstorm --intent exploit` | 以 exploit 意图启动（BQS 第 0 层），D2 低覆盖不扣分 |
 
 ### 交互脚本
@@ -125,12 +126,13 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
 3. 至少套用一个多样性透镜（类比／假设反转／形态矩阵）
 4. 以多样性（覆盖的 persona/透镜数，D2/D3）而非数量为继续门槛
 5. **硬序列闸**：D5–D8 在最后一个 persona 产完前**不得揭示或评分**；CONVERGE critic 不得提前调用
+6. **模型层级（发散侧）**：以 **Standard 或更高**层级执行——依 core/model-selection.md 的 MS-004／Criterion 2（引用，不复述；不是「最高层级」）
 
-#### CONVERGE 阶段（BQS 第 2 层 — D5–D8 仅施于 Top 3）
-1. 以 3 个独立评审（工程可行性／用户影响／战略一致）各自评分后聚合
-2. 对前 3 名跑硬角色 Devil's Advocate（论证会失败）+ Steelman；用户以 (a)修改/(b)反驳/(c)移除 回应。**D4 判官≠产生者**：评审须在独立 context（`--enhanced`）方可 pass，否则标 `[degraded]` 不得 pass
-3. **仅对 Top 3** 套用 D5 接地（外部事实需 file:line／来源、跨级地板；假说免接地）、D6 净值（解谁问题／真有吗／不做代价＋挂 lagging 栏）、D7 二态证伪（「需先做 X」转 next-step、不算 fail）、D8 next-step 裁决
-4. **Meta 停止规则**：维度全绿且再跑一轮 Top 3 集合成员不变→停；硬上限 2 轮
+#### CONVERGE 阶段（BQS 第 2 层 — D5–D8 仅施于推荐集）
+1. 以 3 个独立评审（工程可行性／用户影响／战略一致）各自评分后聚合；**评审提示以「目标＋约束」表达**（判准，不是步骤清单——理由见 skill 引用的 core/model-selection.md MS-009），加权公式与逐准则指引为参考格式
+2. 对**推荐集**（Agg. Score ≥ 3.5，不限笔数）跑硬角色 Devil's Advocate（论证会失败）+ Steelman；用户以 (a)修改/(b)反驳/(c)移除 回应。**D4 判官≠产生者，两轴**：(1) 评审在独立 context（`--enhanced`）执行，且 (2) 宣告模型层级（core/model-selection.md 的厂商中立标签；指名具体厂商模型即违规）——缺任一轴标 `[degraded]` 不得 pass
+3. **仅对推荐集**套用 D5 接地（外部事实需 file:line／来源、跨级地板；假说免接地）、D6 净值（解谁问题／真有吗／不做代价＋挂 lagging 栏）、D7 二态证伪（「需先做 X」转 next-step、不算 fail）、D8 next-step 裁决——四者为判准、不限顺序
+4. **Meta 停止规则**：维度全绿且再跑一轮推荐集集合成员不变→停；硬上限 2 轮
 
 🛑 **STOP**: 展示 Brainstorm Report（含 Seeds／争议区／Judgment Override）后等待用户决定下一步
 
@@ -151,13 +153,15 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
 | 使用「像 X 但给 Y」种子 | 改写为底层问题再继续（反种子 guardrail） |
 | 指定的 persona/透镜不存在 | 列出可用选项供选择 |
 | `--enhanced` 但宿主不支持子代理 | 静默退回 baseline，照常进行 |
-| 前 3 名全来自同一 persona/透镜 | 标示并在输出前再跑一个透镜 |
+| 推荐集全来自同一 persona/透镜 | 标示并在输出前再跑一个透镜 |
 | baseline 单 context 跑评审（无独立 context） | BQS D4 标 `[degraded]`，不得标 pass |
+| 评审未宣告模型层级（或以具体厂商模型名宣告） | BQS D4 标 `[degraded]` 不得 pass；模型名改为 core/model-selection.md 的层级标签 |
 | 外部事实宣称无 file:line／来源 | D5 接地 fail，要求补来源或改标 `[假说]` |
 
 ## 参考
 
 * [Brainstorm Assistant Skill](../brainstorm-assistant/SKILL.md)
 * [Brainstorm Assistant Guide](../brainstorm-assistant/guide.md)
+* [Model Selection](../../core/model-selection.md) — BQS D4 与发散侧的模型层级标签（引用，不复述）
 * [Requirement Assistant](../requirement-assistant/SKILL.md)
 * [Spec-Driven Development](../spec-driven-dev/SKILL.md)

package/bundled/locales/zh-CN/skills/commands/config.md

@@ -167,7 +167,6 @@ Current Skills status:
 | 模式 | 说明 |
 |------|------|
 | `standard` | 摘要 + 任务映射，AI 知道何时读取哪个标准（推荐） |
-| `full` | 在集成文件中完整嵌入所有标准 |
 | `minimal` | 仅嵌入核心规则 |
 
 ## 配置变更的影响

package/bundled/locales/zh-CN/skills/commands/init.md

@@ -41,7 +41,7 @@ argument-hint: "[--level N | --yes]"
 | **OpenCode** | `AGENTS.md` | ✅ | ✅ |
 | **Gemini CLI** | `GEMINI.md` | ✅ | ✅ |
 | **Codex** | `AGENTS.md` | ✅ | ❌ |
-| **Antigravity** | `INSTRUCTIONS.md` | ✅ | ❌ |
+| **Antigravity** | `.agents/AGENTS.md` | ✅ | ❌ |
 
 预选环境中检测到的工具。注意：Codex 和 OpenCode 共用 `AGENTS.md`。
 
@@ -210,7 +210,6 @@ Options:
 | 选项 | 说明 |
 |------|------|
 | **标准（建议）** | 摘要 + 任务映射，AI 知道何时读取哪个标准 |
-| **完整嵌入** | 嵌入所有规则，AI 可立即使用但文件较大 |
 | **最简** | 仅文件引用，搭配 Skills 使用最佳 |
 
 ### 步骤 13：确认并执行

package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md

@@ -125,6 +125,8 @@ Closes #123
 
 ## 参考
 
+- [Conventional Commits 指南](./conventional-commits.md) — 需要确切的 type、scope 与格式规则时读它。
+- [Commit Message 语言选项](./language-options.md) — 要决定 commit message 用哪一种语言时读它。
 - 详细指南：[guide.md](./guide.md)
 - 核心规范：[commit-message-guide.md](../../../../core/commit-message-guide.md)
 

package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md

@@ -102,6 +102,7 @@ ASSESS ──► CHOOSE ──► DEFINE ──► IMPLEMENT ──► VERIFY
 
 ## 参考
 
+- 详细指南：[guide.md](./guide.md) — 契约测试的策略与实现。要配置 Pact／OpenAPI，或把契约测试接入 CI 时读它。
 - 详细指南：[contract-testing.md](../../options/testing/contract-testing.md)
 - 相关：[api-design-assistant](../api-design-assistant/SKILL.md)
 

package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md

@@ -104,6 +104,8 @@ argument-hint: "[动作] [参数]"
 
 ## 参考
 
+- [创建自定义 Methodology 指南](./create-methodology.md) — 要自建方法论而不是用现成的那几套时读它。
+- [Methodology Runtime 指南](./runtime.md) — 需要知道方法论在执行当下如何运作时读它。
 - 详细指南：[guide.md](./guide.md)
 
 ## AI 代理行为

package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md

@@ -46,6 +46,7 @@ description: |
 
 ## 参考
 
+- 详细指南：[guide.md](./guide.md) — 日志、指标、追踪三大支柱的完整说明。要搭建监控、选择指标类型、引入追踪或评估成熟度时读它。
 - 核心规范：[observability-standards.md](../../../../core/observability-standards.md)
 - 核心规范：[alerting-standards.md](../../../../core/alerting-standards.md)
 - 核心规范：[slo-standards.md](../../../../core/slo-standards.md)

package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md

@@ -150,6 +150,7 @@ project/
 
 ## 相关标准
 
+- [各语言的项目结构](./language-patterns.md) — 按语言列出的实际目录布局（Node.js/TypeScript、Python、Go 等）。要为某个特定语言安排项目结构时读它。
 - [核心：项目结构](../../core/project-structure.md)
 - [核心：文档结构](../../core/documentation-structure.md)
 - [指南：文件归档决策指南](../../core/guides/file-placement-guide.md)

package/bundled/locales/zh-CN/skills/release-standards/SKILL.md

@@ -70,5 +70,8 @@ description: |
 
 ## 参考
 
+- [变更日誌格式指南](./changelog-format.md) — 要撰写或审查变更日志时读它。
+- [發布流程指南](./release-workflow.md) — 真的要发一版、需要逐步流程时读它。
+- [語意化版本指南](./semantic-versioning.md) — 要判断一个变更算 major、minor 还是 patch 时读它。
 - 详细指南：[guide.md](./guide.md)
 - 核心规范：[versioning.md](../../../../core/versioning.md)

package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md

@@ -73,5 +73,7 @@ So that [benefit].
 
 ## 参考
 
+- [需求完整性检查清单](./requirement-checklist.md) — 要在需求被接受之前检查它完不完整时读它。
+- [需求撰写指南](./requirement-writing.md) — 要从零开始写一份需求时读它。
 - 详细指南：[guide.md](./guide.md)
 - 核心规范：[requirement-engineering.md](../../../../core/requirement-engineering.md)