universal-dev-standards 6.8.0 → 6.9.0

package/bundled/locales/zh-TW/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-TW/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-CN/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-TW/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-TW/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-TW/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-TW/skills/adr-assistant/SKILL.md

@@ -2,7 +2,7 @@
 name: adr-assistant
 source: ../../../../skills/adr-assistant/SKILL.md
 source_version: 1.0.0
-source_hash: 7d8bf5944cf4
+source_hash: a5c79c6a04fe
 translation_version: 1.1.0
 last_synced: 2026-08-17
 status: current

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

@@ -80,5 +80,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-TW/skills/bdd-assistant/SKILL.md

@@ -77,5 +77,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-TW/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 滯後觀測）** 欄驗證，不另開第二套登記。
+
 #### Step 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)。
+
 #### Step 3a: 多評審面板
 
-跑**三個獨立評審**，各自以自己的透鏡對每個想法打 1–5 分；取平均聚合以降低單評審偏誤。每位評審皆套用下方加權公式。
+跑**三個獨立評審**，各自以自己的透鏡對每個想法打 1–5 分；取平均聚合以降低單評審偏誤。下方加權準則定義預設透鏡——是參考格式，不是評審必須逐步照走的腳本。
 
 | 評審透鏡 | 它所負責的加權準則 |
 |---------|-------------------|
@@ -205,7 +213,7 @@ BQS 是**四層 × 時間軸**契約。它是 v3 的**疊加**——所有 v3
 | **User impact（使用者影響）** | Impact 70% · Alignment 30% |
 | **Strategic alignment（策略一致性）** | Alignment 60% · Impact 40% |
 
-各準則評分指南（1–5）：Feasibility（5=輕而易舉 … 1=幾乎不可能）；Impact（5=變革性 … 1=可忽略）；Effort（5=數小時 … 1=數季，反向計分，工作量越低分越高）；Alignment（5=核心使命 … 1=偏離使命）。
+各準則評分指南（1–5，參考格式）：Feasibility（5=輕而易舉 … 1=幾乎不可能）；Impact（5=變革性 … 1=可忽略）；Effort（5=數小時 … 1=數季，反向計分，工作量越低分越高）；Alignment（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 靜默通過。
 
 #### Step 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-TW/skills/brainstorm-assistant/guide.md

@@ -5,10 +5,10 @@ description: |
   使用時機：模糊想法、功能探索、問題再框架、創意發想。
   關鍵字：brainstorm, ideation, persona ensemble, multi-critic, HMW, SCAMPER, 腦力激盪, 發想, 創意。
 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
 ---
 
@@ -16,8 +16,8 @@ status: current
 
 > **語言**: [English](../../../../skills/brainstorm-assistant/guide.md) | 繁體中文
 
-**版本**: 4.1.0
-**最後更新**: 2026-07-09
+**版本**: 4.2.0
+**最後更新**: 2026-08-21
 **適用範圍**: 所有軟體專案
 **Scope**: universal
 **類型**: 工具型 Skill（無對應核心標準）
@@ -280,7 +280,7 @@ HMW（預設起點）、SCAMPER（改善既有功能：Substitute 取代、Combi
 | **使用者衝擊** | 衝擊 70% · 對齊 30% |
 | **策略對齊** | 對齊 60% · 衝擊 40% |
 
-**各準則指引（1–5）：**
+**各準則指引（1–5，參考格式——不是評審必須逐步照走的腳本）：**
 
 | 準則 | 5 | 3 | 1 |
 |------|---|---|---|
@@ -306,7 +306,7 @@ HMW（預設起點）、SCAMPER（改善既有功能：Substitute 取代、Combi
 - **Devil's Advocate（魔鬼代言人）**：「你的任務是論證這個想法*會*失敗。提出 2 個具體的失敗條件。」
 - **Steelman（強論立場）**：「陳述最強、最善意版本的反論點——一個有思考力的對手真的會提出的那種。」
 
-每個反論點都必須採取以下形式：**「這個想法會在 [特定脈絡] 失敗，因為 [特定理由]。」**
+約束：每個反論點都必須指出**特定脈絡**與**特定理由**。句型**「這個想法會在 [特定脈絡] 失敗，因為 [特定理由]」**是參考格式，不是必用句式（v4.2——評審提示為目標＋約束，見 SKILL.md「評審提示形狀」）。
 
 **不可接受**（太空泛）：「這可能很難。」／「可能會有 edge case。」
 
@@ -342,6 +342,7 @@ HMW（預設起點）、SCAMPER（改善既有功能：Substitute 取代、Combi
 **Personas Used**: [領域專家, 懷疑者, 類比者, ...]
 **Lenses Used**: [類比, 反轉, ...]
 **Pre-flight**: [Completed / Skipped]   **Rebuttal**: [Completed / Skipped]   **Tier**: [Baseline / Enhanced]
+**評審模型層級（D4 心智軸）**: [core/model-selection.md 的廠商中立層級標籤——指名廠商模型即違規；未宣告 → D4 [degraded]]
 
 ## Problem Statement
 [精煉後的問題 + 5 Whys 的根本原因]
@@ -549,7 +550,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]`、不靜默通過。
 
 ---
 
@@ -584,6 +585,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 或更高）皆以此標準的判準為準——引用、絕不複述 |
 
 ---
 
@@ -591,6 +593,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／評審代理、優雅退回）；認知科學依據以 6 項已驗證的 2024–2026 出處重建；效度說明重新評等（pre-flight 為低、Nijstad／Nemeth 降級）；新增旗標 `--personas`／`--lens`／`--enhanced`；反種子護欄 |

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

@@ -66,5 +66,6 @@ description: |
 
 ## 參考
 
+- [Pre-Commit Checklist（提交前檢查清單）](./checkin-checklist.md) — 提交之前當作最後一道檢查時讀它。
 - 詳細指南：[guide.md](./guide.md)
 - 核心規範：[code-review-checklist.md](../../../../core/code-review-checklist.md)