universal-dev-standards 6.0.0 → 6.1.1

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

@@ -1,7 +1,7 @@
 # UDS 功能参考手册
 
 > Universal Development Standards - 完整功能文档
-> Auto-generated | Last updated: 2026-06-20
+> Auto-generated | Last updated: 2026-07-09
 
 **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) (145)
-7. [脚本](#scripts) (57)
+6. [核心规范](#core-standards) (149)
+7. [脚本](#scripts) (58)
 
-**Total Features: 327**
+**Total Features: 332**
 
 ---
 
@@ -132,20 +132,6 @@
 
 **说明**: Manage UDS workflows (list, install, info, execute, status)
 
-**选项**:
-| Option | 说明 |
-|--------|-------------|
-| `--installed` | Show installation status for all AI tools |
-| `-t, --tool` | Target AI tool (default: claude-code) |
-| `-g, --global` | Install to user level instead of project level |
-| `-y, --yes` | Skip confirmation prompts |
-| `-t, --tool` | Target AI tool (default: claude-code) |
-| `--resume` | Resume from saved state |
-| `--restart` | Restart from beginning (discard saved state) |
-| `-v, --verbose` | Show detailed output |
-| `--dry-run` | Show steps without executing |
-| `-y, --yes` | Skip confirmation prompts |
-
 ### `uds ai-context`
 
 **说明**: Manage AI context configuration (init, validate, graph)
@@ -316,7 +302,7 @@
 | `alerting-standards` | 1.0.0 |  |
 | `anti-hallucination` | 1.5.1 | This standard defines strict guidelines for AI assistants to prevent hallucinati |
 | `anti-sycophancy-prompting` | 1.0.0 | This standard defines techniques and rules for designing prompts that elicit gen |
-| `api-design-standards` | 1.0.0 | This standard defines comprehensive guidelines for designing, building, and main |
+| `api-design-standards` | 1.1.0 | This standard defines comprehensive guidelines for designing, building, and main |
 | `audit-trail` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
 | `behavior-driven-development` | 1.1.0 |  |
 | `behavior-snapshot` | - |  |
@@ -344,7 +330,7 @@
 | `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 |
 | `deployment-standards` | 1.1.0 | This standard defines guidelines for safely deploying software to production, co |
-| `deprecation-standards` | 1.0.0 |  |
+| `deprecation-standards` | 1.1.0 |  |
 | `design-document-standards` | 1.0.0 |  |
 | `developer-memory` | 1.1.1 | This standard defines a structured system for capturing, retrieving, and surfaci |
 | `disaster-recovery-drill` | - |  |
@@ -357,6 +343,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-flag-standards` | 1.0.0 |  |
 | `feature-manifest-standard` | - |  |
 | `flaky-test-management` | - |  |
@@ -376,9 +363,10 @@
 | `license-compliance` | 2.1.0 | **Status**: Active | **Updated**: 2026-05-16 |  |
 | `llm-output-validation` | - |  |
 | `logging-standards` | 1.4.0 |  |
-| `mock-boundary` | 1.0.0 | This document defines rules for what can and cannot be mocked in tests. Its goal |
+| `mock-boundary` | 1.1.0 | This document defines rules for what can and cannot be mocked in tests. Its goal |
 | `model-provenance` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
 | `model-selection` | 1.0.1 | Define a cost-effective strategy for selecting AI model tiers based on task comp |
+| `multi-environment-e2e-testing` | 1.0.0 | **Status**: Active | **Updated**: 2026-05-13 |  |
 | `mutation-testing` | 1.0.0 | Mutation testing evaluates test suite effectiveness by injecting artificial bugs |
 | `no-cicd-deployment` | - |  |
 | `observability-standards` | 1.0.0 |  |
@@ -396,8 +384,9 @@
 | `project-structure` | 1.2.0 | This standard defines conventions for project directory structure beyond documen |
 | `prompt-regression` | - |  |
 | `property-based-testing` | - |  |
+| `push-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-04-23 |  |
 | `recovery-recipe-registry` | - |  |
-| `refactoring-standards` | 2.1.0 | This standard defines comprehensive guidelines for code refactoring, covering ev |
+| `refactoring-standards` | 2.2.0 | This standard defines comprehensive guidelines for code refactoring, covering ev |
 | `release-quality-manifest` | - |  |
 | `release-readiness-gate` | 1.0.0 | This standard defines a **single, aggregated Release Readiness Gate** that unifi |
 | `replay-test` | - |  |
@@ -405,7 +394,7 @@
 | `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 |
 | `retry-standards` | - |  |
-| `reverse-engineering-standards` | 1.1.0 | This standard defines the principles, workflows, and best practices for reverse  |
+| `reverse-engineering-standards` | 1.2.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 |  |
@@ -416,7 +405,7 @@
 | `security-decision` | - |  |
 | `security-standards` | 1.1.0 | This standard defines comprehensive security guidelines for software development |
 | `security-testing` | 1.1.0 | This document defines the security testing methodology for software projects. It |
-| `self-review-protocol` | 1.0.0 | This standard mandates a **self-review pass** on large markdown edits before com |
+| `self-review-protocol` | 1.1.0 | This standard mandates a **self-review pass** on large markdown edits before com |
 | `server-ops-security` | - |  |
 | `skill-standard-alignment-check` | - |  |
 | `slo-sli` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
@@ -438,10 +427,11 @@
 | `timeout-standards` | - |  |
 | `token-budget` | - |  |
 | `translation-lifecycle-standards` | 1.0.0 | Translation lifecycle standards: MISSING vs OUTDATED distinction, semver-aware s |
+| `user-journey-testing` | - |  |
 | `user-story-mapping` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
 | `verification-evidence` | 1.0.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
 | `verification-oracle` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
-| `versioning` | 1.2.0 | This standard defines how to version software releases using Semantic Versioning |
+| `versioning` | 1.5.0 | This standard defines how to version software releases using Semantic Versioning |
 | `virtual-organization-standards` | 1.0.0 | This standard treats the AI ecosystem as a "Virtual Organization." It defines ho |
 | `workflow-enforcement` | - |  |
 | `workflow-state-protocol` | 1.0.0 |  |
@@ -493,6 +483,7 @@
 | `check-version-sync.ps1` | Check Version Sync |
 | `check-version-sync.sh` | Version Sync Checker |
 | `check-workflow-compliance.sh` | DEPRECATED: Use 'npx tsx scripts/check-workflow-compliance.ts' instead (cross-platform). |
+| `commitlint-bilingual-rule.mjs` | commitlint-bilingual-rule.mjs — custom commitlint rules enforcing the |
 | `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 |

package/bundled/locales/zh-CN/docs/user/GLOSSARY.md

@@ -105,7 +105,7 @@ _参见：`/tdd`、`test-driven-development` 标准_
 ## U
 
 **UDS（Universal Development Standards，通用开发标准）**
-本项目。一套与语言无关、与框架无关的软件开发质量汇集，含 145 个核心标准、55 个 AI skill 与 51 个斜线命令。
+本项目。一套与语言无关、与框架无关的软件开发质量汇集，含 149 个核心标准、55 个 AI skill 与 51 个斜线命令。
 
 **UDS Manifest（`uds-manifest.json`）**
 所有 UDS 标准与 skill 的机器可读索引。包含统计数据、skill 对命令的对照，以及分类归属。供 UDS CLI 与文档生成器使用。

package/bundled/locales/zh-CN/options/commit-message/bilingual.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../../options/commit-message/bilingual.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2025-12-30
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-07-09
 status: current
 ---
 
@@ -136,6 +136,13 @@ docs: fix typo in README / 修正 README 错字
 - 「小变更」时跳过一种语言
 - 不必要地翻译技术术语
 
+## AI 助手执行期纪律
+
+本选项也适用于以此双语模式撰写用户对话文字的 AI 助手，不只 commit message。长对话中，助手刚处理完大量非目标语言内容（代码、log、英文文档）后，下一段回复容易漂移到错误语言。
+
+- **切换回复前先自检** — 处理完大量非目标语言内容后，写下一段用户对话文字前先确认会使用目标语言，不需等用户指出才发现。
+- **立即修正，不拖延** — 若用户已指出语言跑偏，下一则回复就要修正，不要重复道歉或继续漂移。
+
 ## 技术术语
 
 保持技术术语使用英文：

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.0.0
-source_hash: 25e622a7d063
-translation_version: 4.0.0
-last_synced: 2026-06-22
+source_version: 4.1.0
+source_hash: 0c1fa3392232
+translation_version: 4.1.0
+last_synced: 2026-07-09
 status: current
 description: |
   在编写规格前进行结构化 AI 辅助头脑风暴。
@@ -23,7 +23,7 @@ description: |
 
 **v3 的核心改动:** v3 把发散从「单一 AI 冲数量」改为 **persona 集成**（每个角色以思维链独立推理）×**多样性透镜**；把收敛从「单一 AI 评分 + 单一反驳」改为**多评审面板** + **硬角色反驳**（Devil's Advocate + Steelman）。这直接对应文献中最强的结论：多 persona 胜过单次 pass，而单一 LLM 评审既弱又易谄媚。
 
-**v4 的核心改动:** v3 提供了强健的*机制*，却没有可判定 pass/fail 的质量闸。v4 在其上叠加一道**时序化质量契约**——**头脑风暴质量标准（BQS v1）**——且不移除任何 v3 行为。BQS 是**四层 × 时间轴**结构：第 0 层宣告 explore/exploit 配比；第 1 层（过程、leading、发散期全程可见）跑维度 **D1–D4**；第 2 层（产物、leading、收敛后仅施于 Top 3）跑 **D5–D8** 加 Seeds 栏与争议区；第 3 层是不受治理的 **Judgment Override**。第一原理：**决策用 leading 信号、校准用 lagging 信号——两者是时间前后，而非对错取舍。** 硬序列闸禁止 D5–D8 在发散期被揭示或评分。详见下方「BQS v1 — 质量契约」。
+**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 — 质量契约」。
 
 ## 使用前先选模式
 
@@ -45,7 +45,7 @@ description: |
 ```
 [模式选择] ─► PRE-FLIGHT ─► FRAME ─► DIVERGE ───────────► CONVERGE ──────────► OUTPUT
   客观路由      防止锚定      定义问题   persona 集成+透镜       多评审面板+硬角色反驳    输出提案
-  ▲ 第 0 层 意图            ▲ 第 1 层（D1–D4，leading）       ▲ 第 2 层（D5–D8，Top 3）   ▲ 第 3 层 override
+  ▲ 第 0 层 意图            ▲ 第 1 层（D1–D4，leading）       ▲ 第 2 层（D5–D8，推荐集）   ▲ 第 3 层 override
 ```
 
 ---
@@ -71,9 +71,9 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 
 > **硬序列闸：** D5–D8 禁止在发散期揭示或评分；CONVERGE 的 critic 不得在**最后一个 persona** 产完前被调用。
 
-### 第 2 层 — 产物（收敛后 leading，仅施于 Top 3）
+### 第 2 层 — 产物（收敛后 leading，仅施于推荐集）
 
-> 评判维度限缩在**收敛后 × 仅 Top 3**，绝不在发散期对全部想法当硬闸（否则回溯污染发散、扼杀无证据的未来想法、制造填表剧场）。
+> 评判维度限缩在**收敛后 × 仅推荐集**（Agg. Score ≥ 3.5 的想法，不限笔数），绝不在发散期对全部想法当硬闸（否则回溯污染发散、扼杀无证据的未来想法、制造填表剧场）。
 
 | 维度 | Oracle |
 |------|--------|
@@ -90,11 +90,11 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 
 ### 结构规则
 
-1. **Meta 停止规则：** 该层维度全绿 **且** 再跑一轮后 **Top 3 集合成员不变**（看集合成员、不看内部排序）→停。**硬上限 2 轮**。取代模糊的「不翻决策」。
+1. **Meta 停止规则：** 该层维度全绿 **且** 再跑一轮后 **推荐集成员不变**（看集合成员、不看内部排序）→停。**硬上限 2 轮**。取代模糊的「不翻决策」。
 2. **判官≠产生者：** D2/D4/D5/D7 判定须独立视角；单 context 自评只能 `[degraded]`，不得 pass。
 3. **校准回路（吃 lagging）：** v3 的三个工作阶段自评指标收编为此回路 **lagging** 端——**Adoption Rate＝D6 滞后验证、Diversity＝D2/D3 滞后观测、Cognitive Load＝成本约束**；**禁两套平行评估**。
 4. **BQS 自我演化（轻量）：** 版本化 + 证据清单 last-reviewed 逾期 flag；「定期对 BQS 自身 brainstorm」列可选。
-5. **最小充分原则：** 套用该 tier 所需的最少维度 + Top-3 限缩——认知经济性的守门，不另设成本维度。
+5. **最小充分原则：** 套用该 tier 所需的最少维度 + 把第 2 层限缩在推荐集（Agg. Score ≥ 3.5），而非全部发散想法——认知经济性的守门，不另设成本维度。
 
 ### 分级（绑 v3 既有客观触发，非自评）
 
@@ -210,7 +210,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 
 #### 步骤 3b：硬角色反驳轮
 
-软性的「请批评一下」指令只会得到附和（谄媚）。v3 指派**硬角色**：对**前三名想法**各跑一个 **Devil's Advocate**（「你的任务是论证此案会失败」）与一个 **Steelman**（「说出反方最强而善意的版本」）。两者一起对韧性做压力测试，而非只是戳一下。
+软性的「请批评一下」指令只会得到附和（谄媚）。v3 指派**硬角色**：对**推荐集**（Agg. Score ≥ 3.5，不限笔数）中的每一个想法各跑一个 **Devil's Advocate**（「你的任务是论证此案会失败」）与一个 **Steelman**（「说出反方最强而善意的版本」）。两者一起对韧性做压力测试，而非只是戳一下。
 
 每个反对理由必须采用以下形式：「在 [具体情境] 下，此想法会失败，因为 [具体原因]。」模糊顾虑（「这可能有点难」）不接受。
 
@@ -226,16 +226,16 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 
 > **BQS D4 — 判官≠产生者：** D4 唯有**评审/Devil's Advocate 在独立 context 执行**（`--enhanced` 隔离 agent 宿主）才可 pass。baseline 单 context 下，面板是同 context 自评，标 `[degraded]`、**不得标 pass**——诚实但非独立。不得把 baseline 跑当成 D4 pass 静默通过。
 
-#### 步骤 3c：BQS 第 2 层——对 Top 3 的产物闸
+#### 步骤 3c：BQS 第 2 层——对推荐集的产物闸
 
-收敛后，**仅对 Top 3** 套用 **D5–D8**（绝不对全部发散想法）。对每个 Top-3 想法：
+收敛后，**仅对推荐集**（Agg. Score ≥ 3.5 的想法，不限笔数）套用 **D5–D8**（绝不对全部发散想法）。若无想法达 3.5，仍保留分数最高的 1 个，标记 `[未达门槛——仅供参考]`，避免报告空白。对推荐集中每个想法：
 
 - **D5 接地：** 将每个主张分流为 `[现状/外部事实]`（需 file:line 或来源，否则 fail）vs `[未来/假说]`（免接地、标 `[假说]`）。**外部事实宣称为跨级地板**——creative 级也须接地。
-- **D6 净值：** 每个 Top-3 须答「解谁问题／我们真有吗／不做的代价」；至少一个淘汰为「不值得做」；挂 **lagging 登记栏**（事后哪个信号验证）。
+- **D6 净值：** 推荐集中每个想法须答「解谁问题／我们真有吗／不做的代价」；至少一个淘汰为「不值得做」；挂 **lagging 登记栏**（事后哪个信号验证）。
 - **D7 可证伪（二态）：** 标 `[现可陈述证伪]` **或** `[需先做 X 才能定义证伪]`。后者**转 next-step 喂 D8——不算 fail**。
 - **D8 可行动：** 每个存活想法需 next-step 裁决（含明确「暂不做」）；无 → fail。
 
-> **Meta 停止规则（BQS 结构规则 1）：** 当套用的维度全绿 **且** 再跑一轮后 **Top 3 集合成员不变**（看集合成员、非内部排序）→停。**硬上限 2 轮。**
+> **Meta 停止规则（BQS 结构规则 1）：** 当套用的维度全绿 **且** 再跑一轮后 **推荐集成员不变**（看集合成员、非内部排序）→停。**硬上限 2 轮。**
 
 ---
 
@@ -259,12 +259,14 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 |---|------|---------|------|-------------|---------------|--------------|-----------|
 | 1 | ...  | Skeptic | Reversal | 4.0 | 4.5 | 4.0 | 4.2 |
 
-## Top 3 Recommendations (BQS Layer 2 applied)
-1. **[Idea]** ✓ Passed rebuttal — [Why] — Persona: [..] — [User rebuttal response]
+## Recommendations (BQS Layer 2 applied, Agg. Score ≥ 3.5 — uncapped)
+1. **[Idea]** (Agg. X.X) ✓ Passed rebuttal — [Why] — Persona: [..] — [User rebuttal response]
    - D5 grounding: [current-state claims with file:line | future claims marked [hypothesis]]
    - D6 net benefit: [whose problem / do we have it / cost of not doing] — lagging signal: [..]
    - D7 falsifiability: [falsifiable now | need to do X first → next-step]
    - D8 next-step: [action | defer]
+2. **[Idea]** (Agg. X.X) ✓ Passed rebuttal — ...
+<!-- 列出所有 Agg. Score ≥ 3.5 的想法，依分数由高到低排序——不限 3 条。若无想法达 3.5，仅列分数最高的 1 个，标「[below threshold — shown for reference]」。 -->
 
 ## Contested Zone (high critic-variance ideas)
 [Ideas whose critic variance exceeded threshold — surfaced, NOT eliminated by mean ranking (barbell long-tail)]
@@ -286,7 +288,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 - [ ] Proceed to `/sdd` if requirements are clear
 ```
 
-> **BQS 输出新增（v4）：** **Seeds** 区（规则：被杀 ≥1 则非空）、**争议区**（高方差想法不按 mean 淘汰）、**Judgment Override** 通道（人类裁决凌驾聚合分）为 BQS 第 2/3 层所要求。Top-3 区块逐项记录 D5–D8 状态。
+> **BQS 输出新增（v4）：** **Seeds** 区（规则：被杀 ≥1 则非空）、**争议区**（高方差想法不按 mean 淘汰）、**Judgment Override** 通道（人类裁决凌驾聚合分）为 BQS 第 2/3 层所要求。Recommendations 区块为推荐集（不限笔数）中每个想法逐项记录 D5–D8 状态。
 
 ## 多样性崩塌防护
 
@@ -294,7 +296,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
 
 - **绝不**用竞品或产品类比（「像 X 但给 Y」）当种子。
 - **改变透镜**，而非只改措辞——换个说法 ≠ 多样化。
-- 若存活的前三名全来自同一 persona/透镜，**标示出来**并在 OUTPUT 前再跑一个透镜。
+- 若存活的推荐集全来自同一 persona/透镜，**标示出来**并在 OUTPUT 前再跑一个透镜。
 
 ## 强化层——并行 persona
 

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.0.0
-source_hash: 24f4fe4819a4
-translation_version: 4.0.0
-last_synced: 2026-06-22
+source_version: 4.1.0
+source_hash: c5cd260548c2
+translation_version: 4.1.0
+last_synced: 2026-07-09
 status: current
 description: |
   指导在编写规格前进行结构化 AI 辅助头脑风暴。
@@ -16,8 +16,8 @@ description: |
 
 > **语言**: [English](../../../../skills/brainstorm-assistant/guide.md) | 简体中文
 
-**版本**: 4.0.0
-**最后更新**: 2026-06-22
+**版本**: 4.1.0
+**最后更新**: 2026-07-09
 **适用范围**: 所有软件项目
 **Scope**: universal
 **类型**: 工具型 Skill（无对应核心标准）
@@ -55,10 +55,10 @@ v3 提供了强健的*机制*，却没有**可判定 pass/fail 的质量闸**—
 
 - **第 0 层 — 意图**：宣告 explore/exploit 配比；调节维度权重。
 - **第 1 层 — 过程（发散期 leading、可见）**：维度 **D1 框架纯度／D2 发散覆盖／D3 跨会话多样性／D4 评估去偏**，各有 oracle。**硬序列闸**禁止评判维度 D5–D8 在发散期被揭示或评分。
-- **第 2 层 — 产物（收敛后 leading、仅 Top 3）**：**D5 接地／D6 净值／D7 可证伪／D8 可行动**，加 Seeds 栏与高方差想法的争议区。
+- **第 2 层 — 产物（收敛后 leading、仅施于推荐集——Agg. Score ≥ 3.5，不限笔数）**：**D5 接地／D6 净值／D7 可证伪／D8 可行动**，加 Seeds 栏与高方差想法的争议区。
 - **第 3 层 — 不可治理**：Judgment Override，人类直觉凌驾聚合分数。
 
-第一原理被修正：**决策用 leading 信号、校准用 lagging 信号——两者是时间前后，而非对错取舍**（移除任何「只用 leading 不用 lagging」绝对说法）。核心主张：评判维度限缩在**收敛后 × 仅 Top 3**，绝不在发散期对全部想法当硬闸——否则回溯污染发散、扼杀无证据的未来想法、制造填表剧场。完整契约、oracle 与结构规则见 **SKILL.md →「BQS v1 — 质量契约」**。
+第一原理被修正：**决策用 leading 信号、校准用 lagging 信号——两者是时间前后，而非对错取舍**（移除任何「只用 leading 不用 lagging」绝对说法）。核心主张：评判维度限缩在**收敛后 × 仅推荐集**（Agg. Score ≥ 3.5，不限笔数），绝不在发散期对全部想法当硬闸——否则回溯污染发散、扼杀无证据的未来想法、制造填表剧场。完整契约、oracle 与结构规则见 **SKILL.md →「BQS v1 — 质量契约」**。
 
 ---
 
@@ -313,7 +313,7 @@ HMW（默认起点）、SCAMPER（改善既有功能：Substitute、Combine、Ad
 
 ### Step 3b: 硬角色反驳轮
 
-软性的「请批评这个」大多得到附和——在弱批评框架下 LLM 会阿谀奉承。v3 对**前 3 个想法**分配**硬角色**：
+软性的「请批评这个」大多得到附和——在弱批评框架下 LLM 会阿谀奉承。v3 对**推荐集**（Agg. Score ≥ 3.5，不限笔数）中的每一个想法分配**硬角色**：
 
 - **Devil's Advocate**：「你的任务是论证这个想法*会*失败。给出 2 个具体的失败条件。」
 - **Steelman**：「陈述反方论点最强、最善意的版本——一个有思想的对手实际会提出的那种。」
@@ -366,10 +366,12 @@ HMW（默认起点）、SCAMPER（改善既有功能：Substitute、Combine、Ad
 |---|------|---------|------|--------------|---------------|---------------|------|
 | 1 | ...  | Skeptic | Reversal | 4.0 | 4.5 | 4.0 | 4.2 |
 
-## Top 3 Recommendations
+## Recommendations (Agg. Score ≥ 3.5 — uncapped)
 ### 1. [Idea] (Agg. X.X) ✓ Passed rebuttal
 - **Why**: [Reasoning]   - **Persona/Lens**: [..]   - **Rebuttal response**: [one line]   - **Scope**: [S/M/L]
 
+<!-- 列出所有 Agg. Score ≥ 3.5 的想法，依分数由高到低排序——不限 3 条。若无想法达 3.5，仅列分数最高的 1 个，标「(below threshold — shown for reference)」。 -->
+
 ## Diversity Note
 [How many distinct personas/lenses the surviving ideas span; flag if all from one cluster]
 
@@ -391,7 +393,7 @@ HMW（默认起点）、SCAMPER（改善既有功能：Substitute、Combine、Ad
 
 - **绝不**用竞品或产品类比做种子（「像 X 但用于 Y」）。
 - **变化透镜**，而非仅变化措辞——重写一个提示并不会让输出多样化。
-- 如果存活的前 3 名全部源自一个 persona 或透镜，**标记它**并在 OUTPUT 前额外运行一个透镜。
+- 如果存活的推荐集全部源自一个 persona 或透镜，**标记它**并在 OUTPUT 前额外运行一个透镜。
 - 早期优先使用**较低保真度**的想法陈述（一个粗略的方向，而非打磨过的概念）——高保真的 AI 输出会加深固着（发现 #3）。
 
 ---
@@ -606,6 +608,7 @@ BQS v1 是**叠加的质量契约**，不是推倒重来。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`；反种子护栏 |
 | 2.1.0 | 2026-05-09 | XSPEC-196 Phase 2：模式选择客观路由；自我评估框架；A/B 实验协议；研究效度说明；渐进采用协议 |

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

@@ -3,7 +3,7 @@ source: ../../../../skills/dev-methodology/guide.md
 source_version: 2.0.0
 translation_version: 2.0.0
 last_synced: 2026-06-10
-source_hash: cf9cbf22df6f
+source_hash: 0b4eb7c53f73
 status: current
 scope: partial
 description: |

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

@@ -5,10 +5,10 @@ description: |
   使用时机：新增日志、调试、设置可观测性。
   关键字：logging, log level, structured logging, observability, 日志, 记录, 结构化日志。
 source: ../../../../skills/logging-guide/SKILL.md
-source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-06-10
-source_hash: 6b7244c91aa0
+source_version: 1.4.0
+translation_version: 1.4.0
+last_synced: 2026-07-08
+source_hash: cf114de1df86
 status: current
 ---
 
@@ -16,8 +16,8 @@ status: current
 
 > **语言**: [English](../../../../skills/logging-guide/SKILL.md) | 简体中文
 
-**版本**: 1.1.0
-**最后更新**: 2026-05-26
+**版本**: 1.4.0
+**最后更新**: 2026-06-19
 **适用范围**: Claude Code Skills
 
 ---
@@ -62,6 +62,28 @@ status: current
 | **ERROR** | 失败的操作、捕获的异常、集成失败 |
 | **FATAL** | 无法恢复的错误、启动失败、失去关键资源 |
 
+## 强制事件
+
+把每条日志格式化得再完美，但**在真正关键的时刻却从不触发**，比什么都没有还糟——它会在事故当下给人虚假的安全感。核心标准定义了**9 个必须产生日志记录的标准事件**。若日志配置遵守级别／字段规则却遗漏这些事件，就是「规范上合格、实质上沉默」。务必全部实现这 9 项：
+
+| 事件 id | 时机 | 级别 | 核心必要字段 | 不可记录 |
+|----------|------|-------|----------------------|--------------|
+| `application_startup` | 启动后、**接受请求前** | INFO | app_name, version, git_sha, environment, hostname, pid, listening_endpoints | secrets、完整连接字符串 |
+| `request_received` | Middleware 首次看到请求时 | INFO / DEBUG | method, path, source_ip, request_id | request body、auth headers |
+| `validation_failure` | schema / ModelState / DTO 验证拒绝时 | WARN | request_id, path, missing_fields[], payload_shape（仅 keys） | 字段**值**、PII |
+| `authentication_failure` | 登录 / token 验证失败时 | WARN | uid（尝试值）, source_ip, failure_reason | password、token 值 |
+| `outbound_call_start` | 发起对外 HTTP/RPC 调用时 | INFO | target_url（host+path）, 传递的 request_id, timeout_ms | credentials、bearer tokens |
+| `outbound_call_complete` | 外部调用返回或失败时 | INFO / WARN / ERROR | status_code **或** failure_phase（dns/tcp/tls/http）, elapsed_ms, retries | 含 PII 的 response body |
+| `business_event` | 状态变更类业务操作完成时 | INFO | operation_name, actor, target ids, outcome | 完整 record payload、PII |
+| `heartbeat` | 长期运行的后台服务，≥ 1 次 / 60 秒 | INFO | service_name, queue_depth, items_processed_since_last_heartbeat | — |
+| `shutdown` | 进程退出时（正常或致命错误） | INFO / ERROR | app_name, signal/reason, uptime_seconds, pending_work_count | — |
+
+**为何是这些事件**——每一项都补上一个真实的事故盲区：静默的 `validation_failure` 会隐藏未记录的 payload；`authentication_failure` 若缺 `uid`／`source_ip` 就无法调查；缺少 `heartbeat` 意味着 0-byte 的日志文件不会被察觉；没有 `outbound_call_*` 会让「发送失败」变成一场找不到任何调用痕迹、耗时 2 天的排查。
+
+> 后台服务若在 60 秒内未写入任何 INFO/WARN/ERROR，**必须**发出一条 `heartbeat`；若连续 ≥ 2 倍间隔（≥ 120 秒）都没有出现，静默检测器**必须**告警。
+
+完整目录（每个事件的 `when`／`must_log`／`must_NOT_log`／`rationale` 及合规示例），请参见核心 [Logging Standards](../../core/logging-standards.md#强制事件mandatory-events) 的 **强制事件** 章节。
+
 ## 结构化日志
 
 ### 必要字段
@@ -310,6 +332,7 @@ logger.error('处理订单失败', {
 
 | 版本 | 日期 | 变更 |
 |------|------|------|
+| 1.4.0 | 2026-06-19 | 新增：强制事件章节（9 个标准事件），消除技能与核心标准之间的内容漂移；版本号与核心日志标准 v1.4.0 对齐（XSPEC-070 Phase 2） |
 | 1.1.0 | 2026-05-26 | 新增：日志文件轮转章节及核心标准轮转策略交叉引用；轮转检查清单（XSPEC-232） |
 | 1.0.0 | 2025-12-30 | 初始发布 |
 

package/bundled/locales/zh-CN/skills/spec-derivation/guide.md

@@ -3,7 +3,7 @@ source: ../../../../skills/spec-derivation/guide.md
 source_version: 2.0.0
 translation_version: 2.0.0
 last_synced: 2026-06-10
-source_hash: 8c89e24244a5
+source_hash: 3470ae083c12
 status: current
 scope: partial
 description: |

package/bundled/locales/zh-TW/CHANGELOG.md

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 6.0.0
-translation_version: 6.0.0
-last_synced: 2026-07-06
+source_version: 6.1.1
+translation_version: 6.1.1
+last_synced: 2026-07-18
 status: current
 ---
 
@@ -17,6 +17,41 @@ status: current
 
 ## [Unreleased]
 
+## [6.1.1] - 2026-07-18
+
+> **`uds check` 悄悄量錯了東西。** 它的落後檢查拿你的標準去比 CLI 自己 bundled 的副本、而非 npm——CLI 一舊就吐出倒退、無意義的訊息，且結構上永遠說不出「你的標準過期了」——還把那則訊息埋在逐檔一行的「未變更」底下。
+
+### Fixed
+
+- **`uds check` 現在拿你安裝的標準比對 npm 上的最新版，而非 CLI 自己 bundled 的副本**（XSPEC-342）。`displayAdoptionStatus` 原本拿 `manifest.upstream.version` 去比**跑這支 CLI 內建的**標準副本。CLI 一舊，那副本就比 npm 舊——於是檢查印出倒退的 `⚠ 有可用更新：6.1.0 → 5.12.1`（叫你「更新」到*更舊*的版本），且結構上永遠無法回報你的標準落後。現在改問 npm 最新版；當你的標準落後時，訊息改為 **「你安裝的標準落後最新版」**，並給出完整兩步驟修復——`npm update -g universal-dev-standards` **然後** `uds update`——因為只更新 CLI 不會動到你專案的 `.standards/`。`--offline` 靜默略過比對，不再退回誤導的 bundled 檢查。
+
+### Changed
+
+- **`uds check` 不再逐檔列出未變更的檔案**（XSPEC-342）。它原本對每個追蹤檔印一行 `✓ …（未變更）`——約佔指令輸出的 70%（實測 121 → 41 行）——淹沒了真正該讀的訊息，也讓輸出大到被自動化呼叫端（pre-commit agent）截斷。逐檔「未變更」列印已移除；計數仍保留在一行的完整性摘要，已修改／遺失／未雜湊的檔案仍逐一列出。
+
+## [6.1.0] - 2026-07-17
+
+> **同一種形狀的兩個失敗，一個在標準裡、一個在 CLI 裡**：一道檢查跑了、回傳了、回報成功，卻什麼都沒量到。`verification-evidence` 補上了為它命名的那一層；`uds init` 則不再是它的一個實例。
+
+### 修正
+
+- **`uds init` 不再覆蓋既有的 `prepare` script**（XSPEC-341）。自 2026-02-04 起，`uds init` 會對任何沒有 `.husky/` 目錄的 Node 專案執行 `npx husky init`。該指令是為**全新**專案設計的一次性 bootstrap：它會無條件把 `"prepare"` 設成 `"husky"`。若你的專案原本就有 `prepare`——而對一個要發布的套件而言，`prepare` 通常就是 build 步驟——**它會被靜默取代**，而 CLI 回報成功。`uds init` 現在改為串接而非覆寫（`"tsup"` → `"tsup && husky"`），會印出它所修改的每一個 `package.json` 欄位，也不再丟棄 husky 的 stderr。
+
+  > **⚠️ 若你曾在原本就有 `prepare` script 的專案上跑過 `uds init`，請立即檢查。** 這次修正保護的是往後的執行；它無法還原一個已經被改寫的 `package.json`。症狀是：你預期看到自己的 build 指令，實際看到的卻是 `"prepare": "husky"`——而如果你的套件會發布建置產物（`files: ["dist"]`、`main` 指向 `dist/`）且沒有 `prepack`／`prepublishOnly`，那麼你下一次 `npm publish` 送出去的將是一個未建置或過期的目錄。請以串接方式復原：`"prepare": "<你原本的指令> && husky"`。
+
+- **`uds init` 不再把 `npm test` 塞進 `.husky/pre-commit`**（XSPEC-341）。那一行來自 husky 的 init 範本，不是來自 UDS——它等於在每一次 commit 上架了一道採用者從未選擇加入的完整測試套件閘門。UDS 現在只附加自己的 `npx uds check`，而且是附加到既有 hook 之後，而不是改寫它們。
+
+- **新建的 husky hook 改以 v9 格式寫入**（XSPEC-341）。fallback 的 hook 範本仍在輸出 v8 的 `#!/usr/bin/env sh` + `. "$(dirname -- "$0")/_/husky.sh"` 前導段，該寫法在 husky v9 已棄用、v10 已移除——而 `uds init` 安裝的正是 husky `^9`。這原本是潛伏問題（過去 hook 是由 husky init 寫出的）；移除 `husky init` 後，fallback 升為主要路徑，因此一併修正。
+
+### 變更
+
+- **`verification-evidence` 1.1.0 → 1.2.0 —— 證據有效性**（XSPEC-340）。本標準原本把 `exit_code` 當成事實真相：`trust_rules` 寫著「`exit_code ≠ 0` → 驗證失敗」、`physical_spec.checks` 問的是「`exit_code` 是否為 0（成功）？」、VE-002 只要非零就觸發修復迴圈。**這三處現已全數加上限定條件**，因為一道驗證指令可以跑完、可以回傳，卻什麼意義都沒有：
+  - **新增 `evidence_validity` 層次與規則 VE-007 – VE-010**：只有在「成功時回傳 0」的工具上，`exit_code = 0` 才代表成功（VE-007）；在證明查詢工具確實執行過之前，「空／查無／0」不等於不存在（VE-008）；存在性檢查不得丟棄 stderr（VE-009）；pipeline 的 exit code 不屬於其中任何單一階段（VE-010）。
+  - **新增 `non_evidence_claims`**：「已完成」／「應該可以了」／「我改了程式碼」／「測試應該會通過」／「指令回傳 0」。
+  - 有別於 `anti-hallucination`——後者的禁令全都是「不要斷言你沒查過的事」的變形。這裡是相反的失敗：**確實查了，而查詢工具靜默地沒有運作**。`core/verification-evidence.md` 收錄了八筆真實案例作為證據。
+- **`verification-evidence` 的人類文件補上了 v1.1.0 的落差。** v1.1.0 的 `environment_layer` 工作（XSPEC-204）已落地於全部三份 `.ai.yaml`，卻**一份 `.md` 都沒有更新**（共四份）——人類文件自 2026-05-13 起就一直在錯誤地描述這個標準。`core/*.md` 現已載明 `environment_layer`、Environment Layers 章節，以及 VE-005 / VE-006。
+- **`verification-evidence` 新增三個先前只存在於 zh-TW 譯文的章節**：非證據的聲明（Non-Evidence Claims）、證據類型（Evidence Types）、相關標準（Related Standards）。譯文比它的來源更完整；這些章節現已上溯至英文來源，並同時存在於兩個語系。
+
 ## [6.0.0] - 2026-07-06
 
 > ⚠️ **重大版本（Major release）。** 包含一項 breaking 更名，並移除 8 個已棄用的機器可讀標準與 4 個已棄用的 CLI 命令（皆自 5.4.0 起帶有「將於 6.0.0 移除」告示）。**請參閱 [v6 遷移指南](docs/MIGRATION-v6.md)**（[English](../../docs/MIGRATION-v6.md) | [简体中文](../zh-CN/docs/MIGRATION-v6.md)）。

package/bundled/locales/zh-TW/CLAUDE.md

@@ -14,7 +14,7 @@ status: current
 
 Universal Development Standards 是一個語言無關、框架無關的文件化標準框架。它提供：
 
-- **核心規範** (`core/`)：145 個基礎開發標準
+- **核心規範** (`core/`)：149 個基礎開發標準
 - **AI 技能** (`skills/`)：用於 AI 輔助開發的 Claude Code 技能
 - **CLI 工具** (`cli/`)：用於採用標準的 Node.js CLI
 - **整合** (`integrations/`)：各種 AI 工具的配置

package/bundled/locales/zh-TW/MAINTENANCE.md

@@ -1,9 +1,9 @@
 ---
 source: ../../MAINTENANCE.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-06-10
-source_hash: ec4410b9245b
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-07-08
+source_hash: 5d0adbbf7d63
 status: current
 ---
 
@@ -25,7 +25,13 @@ status: current
 
 ## Bundle-Source 一致性（XSPEC-072 / DEC-045）
 
-每次發行前，請確認 bundle 一致性檢查通過：
+npm bundle 標準（`cli/bundled/`，由 `ai/` 產生）必須是真實來源 `.standards/`
+的**子集**。布局契約定義於 DEC-045 §6.2。
+
+### 發版時強制（自動 — XSPEC-072 Phase 4.2）
+
+`scripts/bump-version.mjs`（及舊版 `bump-version.sh`）會在改動任何版本檔
+**之前**先跑 pre-flight 一致性閘門，一致性漂移即**中止發版**。等效手動指令：
 
 ```bash
 cd cli
@@ -33,13 +39,31 @@ npm run prepack                # 從 ai/ 重新產生 cli/bundled/
 npm run check:bundle-parity    # 必須以 exit 0 結束（source == bundled，扣除排除項）
 ```
 
-若一致性檢查失敗：
+Break-glass：`SKIP_BUNDLE_PARITY=1 node scripts/bump-version.mjs <version>`
+可跳過閘門（會大聲警告）——僅在工具鏈壞損**且**你已用其他方式確認一致性時使用。
+
+GHA 工作流程 `bundle-parity.yml` 會在 PR 和推送至 `main` 時，對任何不符獨立
+強制失敗。這兩點（發版閘門 + CI）即強制面；本地 pre-commit/pre-push hook
+（XSPEC-072 Phase 3.2）**刻意不加**——它會在每次 push 重跑 `prepack`，相較上述
+兩道閘門邊際效益太低。
+
+### 新增標準時的 bundle 決策流程（DEC-045 §6.2）
+
+在 `.standards/` 新增 `.ai.yaml` 時，決定其 bundle 範圍：
+
+1. **Bundle ⊂ Source** — 每個 bundle 檔案都須在 `.standards/` 有對應；不允許 bundle-only。
+2. **預設啟發式（規則 5）：** **level ≤ 2** 的 core 標準也進 bundle → 加入 `ai/standards/<name>.ai.yaml`（供採用者使用）。**level ≥ 3** 或治理／AI 協作類標準維持 source-only → 將其路徑加入 `cli/scripts/bundle-exclude.json`，格式 `{ "path", "reason" }`（可推翻）。
+3. **選項檔** → 一律採巢狀布局 `options/<category>/<choice>.ai.yaml`；禁止平坦路徑。
+4. **禁止歧義重複** — 兩個同 basename 但不同路徑的檔案必須歸一，不能並存。
+
+之後執行 `cd cli && npm run prepack && npm run check:bundle-parity`，確認 exit 0。
+
+### 若一致性檢查失敗
+
 1. **`.standards/` 中的新檔案不在 `ai/`** → 複製至 `ai/standards/`（若供採用者使用），或加入 `cli/scripts/bundle-exclude.json`（若僅供 UDS 內部使用）
 2. **`ai/` 中的新檔案不在 `.standards/`** → 複製至 `.standards/`
 3. **新選項檔案** → 確保同時存在於 `ai/options/<cat>/` 與 `.standards/options/<cat>/`
 
-`scripts/bump-version.sh` 目前**不會**自動執行一致性檢查 — 請在標記版本前手動執行。GHA 工作流程 `bundle-parity.yml` 會在 PR 和推送至 `main` 時發生任何不符時強制失敗。
-
 ## 翻譯版本
 
 - [繁體中文](./MAINTENANCE.md)