universal-dev-standards 6.8.0 → 6.10.0

package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md

@@ -45,7 +45,7 @@ status: current
   ◯ Windsurf (.windsurfrules)
   ◯ Cline (.clinerules)
   ◯ GitHub Copilot (.github/copilot-instructions.md)
-  ◯ Google Antigravity (INSTRUCTIONS.md) - Gemini Agent
+  ◯ Google Antigravity (.agents/AGENTS.md) - Gemini Agent
   ── AGENTS.md Tools ──
   ◯ OpenAI Codex (AGENTS.md) - OpenAI Codex CLI
   ◯ OpenCode (AGENTS.md) - Open-source AI coding agent
@@ -68,7 +68,7 @@ status: current
 | **Windsurf** | `.windsurfrules` | Plaintext | Windsurf IDE 规则文件 |
 | **Cline** | `.clinerules` | Plaintext | Cline 扩展规则文件 |
 | **GitHub Copilot** | `.github/copilot-instructions.md` | Markdown | Copilot 自定义指示 |
-| **Google Antigravity** | `INSTRUCTIONS.md` | Markdown | Gemini Agent 系统指令 |
+| **Google Antigravity** | `.agents/AGENTS.md` | Markdown | Gemini Agent 系统指令 |
 | **OpenAI Codex** | `AGENTS.md` | Markdown | OpenAI Codex CLI |
 | **OpenCode** | `AGENTS.md` | Markdown | 开源 AI 编码 Agent（与 Codex 共用文件） |
 | **Gemini CLI** | `GEMINI.md` | Markdown | Google Gemini CLI |
@@ -626,21 +626,26 @@ uds init
 ```
 ? Select content level:
 ❯ Standard (推荐) - Summary + links to full docs
-  Full Embed - All rules in one file (larger)
   Minimal - Core rules only (smallest)
 ```
 
 ### 说明
 
-决定 AI 工具集成文件中嵌入多少标准内容。这是影响 AI 合规程度的关键设置。
+决定 AI 工具集成文件中嵌入多少标准内容。
+
+> **第三个模式 `full`（Full Embed）已于 UDS 6.9.0 移除。**
+> 它从来没有产生过与 `index` 不同的文件——生成器只在 `minimal` 上分支，
+> 因此两者在实测的 24 组（工具 × 语言）组合中输出逐位相同。
+> `--content-mode full` 仍然接受，并解析为 `index`；manifest 中记录的 `full`
+> 会在下一次执行时改写为 `index`。**任何项目拿到的文件都不会改变**，
+> 因为两个模式本来就产生相同的字节。详见 XSPEC-357 R7。
 
 ### 选项
 
-| 模式 | 文件大小 | AI 可见性 | 适用情境 |
-|------|----------|-----------|----------|
-| **Standard** (推荐) | 中等 | 高 | 大多数项目 |
-| **Full Embed** | 最大 | 最高 | 企业级合规 |
-| **Minimal** | 最小 | 低 | 旧项目迁移 |
+| 模式 | 内容 | 适用情境 |
+|------|------|----------|
+| **Standard**（`index`，推荐） | 标准索引 + MUST/SHOULD 任务对照表 | 大多数项目 |
+| **Minimal**（`minimal`） | 仅文件引用 | 由 Skills 提供任务指引的项目 |
 
 ### 详细说明
 
@@ -714,47 +719,17 @@ uds init
 - ✅ 希望 AI 遵守规范但不想文件太大
 - ✅ AI 工具会读取项目文件
 
-#### Full Embed 模式
-
-**生成内容**：完整嵌入所有规则
-
-```markdown
-## Anti-Hallucination Protocol
-Reference: .standards/anti-hallucination.md
-
-### Core Principle
-You are an AI assistant that prioritizes accuracy over confidence...
-
-### Evidence-Based Analysis
-1. **File Reading Requirement**
-   - You MUST read files before analyzing them
-   - Do not guess APIs, class names, or library versions
-...
-
----
-
-## Commit Message Standards
-Reference: .standards/commit-message.ai.yaml
+#### Full Embed 模式（已移除）
 
-### Format Structure
-<type>(<scope>): <subject>
-
-### Commit Types
-| Type | Description | Example |
-| feat | New feature | feat(auth): add OAuth2 login |
-...
-```
+这一节原本描述一个把完整规则正文嵌入集成文件的模式，声称能「**保证**」AI
+看到所有标准，并产生「比 Index 大 3-5 倍」的文件。
 
-**特点**：
-- 所有核心规则直接嵌入
-- AI **保证**看到所有标准
-- 文件大小可能是 Index 的 3-5 倍
+**这些从来都没有被实现。** `full` 与 `index` 走同一条代码路径、写出相同的字节。
+它也不可能按描述运作：`.standards/` 约 248k token，远超过任何集成文件装得下的量。
+该模式已于 UDS 6.9.0 移除（XSPEC-357 R7），现在解析为 `index`。
 
-**适用情境**：
-- ✅ 企业级合规要求
-- ✅ AI 可能不读取外部文件
-- ✅ 不能容许 AI 遗漏任何规则
-- ✅ 新团队导入，确保完全了解规范
+若你当初是为了合规理由选择它，你拿到的一直都是 `index` 的输出，
+因此产生的文件不会有任何改变。
 
 ### 决策流程
 
@@ -763,19 +738,8 @@ Reference: .standards/commit-message.ai.yaml
         │
         ▼
   ┌─────────────────────────────┐
-  │ AI 是否会主动读取项目文件？  │
-  └─────────────────────────────┘
-        │
-    ┌───┴───┐
-    │       │
-   是       否
-    │       │
-    ▼       ▼
-Index    Full
-    │
-    ▼
-  ┌─────────────────────────────┐
-  │ 是否有严格合规要求？         │
+  │ 是否已安装 Skills 并由它     │
+  │ 提供任务指引？               │
   └─────────────────────────────┘
         │
     ┌───┴───┐
@@ -783,10 +747,7 @@ Index    Full
    是       否
     │       │
     ▼       ▼
- Full    Index
-
-
-旧项目迁移 / 想要最小改动？ → Minimal
+Minimal  Index
 ```
 
 ### 使用案例
@@ -794,11 +755,11 @@ Index    Full
 | 案例 | 推荐模式 | 理由 |
 |------|----------|------|
 | 创业团队的 SaaS 项目 | **Index** | 平衡效率与规范 |
-| 银行核心系统 | **Full** | 法规要求，不能遗漏 |
+| 银行核心系统 | **Index** | 索引会列出每一条适用标准与适用时机 |
 | 个人 side project | **Minimal** | 轻量就好 |
 | 开源项目 | **Index** | 让贡献者 AI 知道规范 |
 | 从旧设置迁移 | **Minimal** | 保留现有设置 |
-| 新导入 AI 的传统企业 | **Full** | 确保 AI 完全遵循 |
+| 新导入 AI 的传统企业 | **Index** | 与已移除的 `full` 模式产出相同 |
 
 ---
 
@@ -895,8 +856,8 @@ uds init -y \
   --test-levels unit,integration \
   --content-mode index
 
-# 企业级完整设置
-uds init -y --content-mode full
+# 最小化集成文件（由 Skills 提供任务指引）
+uds init -y --content-mode minimal
 
 # 生成 AGENTS.md 通用摘要（--yes 模式默认生成）
 uds init -y --agents-md

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/MIGRATION-v6.md

@@ -32,14 +32,13 @@ UDS 6.0.0 是 **major** 版本：包含一项 breaking 更名、移除 8 个已
 
 **不受影响**：指涉外部工具内建 review 命令（如 Codex）的 `/review` 字样与 UDS 无关，刻意保留原样。
 
-## 2. 移除：8 个已弃用的机器可读标准（`.ai.yaml`）
+## 2. 移除：7 个已弃用的机器可读标准（`.ai.yaml`）
 
-这 8 个标准的 runtime 已于 5.4.0 移交采用层（XSPEC-086/095；UDS 定义活动、采用层编排流程——DEC-049），其 `.ai.yaml` stub 如期移除：
+这些标准的 runtime 已于 5.4.0 移交采用层（XSPEC-086/095；UDS 定义活动、采用层编排流程——DEC-049），其 `.ai.yaml` stub 如期移除：
 
 | 移除的 `.ai.yaml` | 保留的人类可读文件 |
 |---|---|
 | `agent-communication-protocol` | `core/agent-communication-protocol.md` |
-| `agent-dispatch` | `core/agent-dispatch.md` |
 | `branch-completion` | `core/branch-completion.md` |
 | `change-batching-standards` | `core/change-batching-standards.md` |
 | `execution-history` | `core/execution-history.md` |
@@ -51,7 +50,12 @@ UDS 6.0.0 是 **major** 版本：包含一项 breaking 更名、移除 8 个已
 
 - 若从未直接载入这些 `.ai.yaml`：不需动作——人类可读概念仍留在 `core/` 作为参考文件。
 - 若采用层（agent runtime、orchestrator、CI）曾载入这些 stub：在自家工具链实作等效机制。这些 stub 自 5.4.0 起本身就是指向此方向的弃用告示。
-- 这些标准不再由 `uds init` / `uds update` 发布。专案 `.standards/` 中既有副本不会被自动删除——想要干净树的话请手动移除。
+- 这些标准不再由 `uds init` / `uds update` 发布。每一份保留下来的 `core/*.md` 都在自己的开头写明这件事，而 `scripts/reference-only-standards.json` 是那份清单的机器可读版本。
+- **`agent-dispatch` 曾在这张表上，现在不在了。** 它的 `.ai.yaml` 已于 XSPEC-362 R5a 恢复、正常发布，而本指南在那之后仍把它列为已移除，跨了两个大版本。**你的 manifest 里若还有它，那是对的。**
+- 专案 `.standards/` 中既有副本不会被自动删除。请用 **`uds update --prune`**，不要手动删：
+  - `--prune` 会连同 `fileHashes` 里的记录一起移除。手动删只删掉文件，记录还在，`uds check` 会把每一个报成「遗失」并建议 `uds check --restore`——**而那个还原不可能成功**，因为上游已经没有来源了。
+  - **从 6.8.x 以前升上来之后的第一次 `uds update` 什么都不会删**，不论你加什么旗标：此时还没有文件归属记录，而 UDS 不会凭一笔不存在的记录删东西。先跑一次 `uds update`，再跑 `uds update --prune`。
+  - `--prune` 不会清 `integrationConfigs[<文件名>].installedStandards`。那份快照正是 `uds update --sync-refs` 重新生成时所依据的东西，所以残留在那里的项目仍可能把错的标准数写进你的 CLAUDE.md。`uds update --integrations-only` 则是从 manifest 重算。
 
 ## 3. 移除：4 个已弃用的 CLI 命令
 

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 代理行为