universal-dev-standards 5.13.3 → 5.15.1

package/bundled/locales/COVERAGE.md

@@ -0,0 +1,226 @@
+# UDS Locale Coverage
+
+> Auto-generated by `scripts/generate-locale-coverage.mjs` on 2026-05-28.
+> Do not edit manually — re-run the script.
+
+> **Canonical**: `skills/` (54) + `core/` (127). **Locales tracked**: `zh-CN`, `zh-TW`.
+
+## Skills (54 canonical)
+
+| Skill | zh-CN | zh-TW |
+| :-- | :-: | :-: |
+| ac-coverage | :x: | :white_check_mark: 1.0.0 |
+| adr-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| ai-collaboration-standards | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| ai-friendly-architecture | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| ai-instruction-standards | :white_check_mark: 2.0.0 | :white_check_mark: 2.0.0 |
+| api-design-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| atdd-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| audit-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| bdd-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| brainstorm-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| changelog-guide | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| checkin-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| ci-cd-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| code-review-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| commit-standards | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| contract-test-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| database-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| deploy-assistant | :x: | :white_check_mark: 1.0.0 |
+| dev-methodology | :x: | :white_check_mark: 1.0.0 |
+| dev-workflow-guide | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| docs-generator | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| documentation-guide | :white_check_mark: 2.1.0 | :white_check_mark: 2.1.0 |
+| durable-execution-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| e2e-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| error-code-guide | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| git-workflow-guide | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| incident-response-assistant | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| journey-test-assistant | :x: | :white_check_mark: 1.0.0 |
+| logging-guide | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| metrics-dashboard-assistant | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| migration-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| observability-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| orchestrate | :x: | :warning: 1.0.0 (major) |
+| plan | :x: | :warning: 1.0.0 (major) |
+| pr-automation-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| project-discovery | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| project-structure-guide | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| push | :x: | :warning: 1.0.0 (major) |
+| refactoring-assistant | :white_check_mark: 2.0.0 | :white_check_mark: 2.0.0 |
+| release-standards | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| requirement-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| retrospective-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| reverse-engineer | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| runbook-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| security-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| security-scan-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| skill-builder | :x: | :white_check_mark: 1.0.0 |
+| slo-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| spec-derivation | :x: | :white_check_mark: 1.0.0 |
+| spec-driven-dev | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| sweep | :x: | :white_check_mark: 1.0.0 |
+| tdd-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| test-coverage-assistant | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| testing-guide | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+
+**zh-CN skills coverage**: 44/54 (81%)
+**zh-TW skills coverage**: 54/54 (100%)
+
+## Standards (`core/` — 127 canonical)
+
+| Standard | zh-CN | zh-TW |
+| :-- | :-: | :-: |
+| acceptance-criteria-traceability.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| acceptance-test-driven-development.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| accessibility-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| adr-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| adversarial-test.md | :x: | :x: |
+| agent-behavior-discipline.md | :x: | :x: |
+| agent-communication-protocol.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| agent-dispatch.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| ai-agreement-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| ai-command-behavior.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| ai-friendly-architecture.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| ai-instruction-standards.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| ai-response-navigation.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| alerting-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| anti-hallucination.md | :white_check_mark: 1.5.1 | :white_check_mark: 1.5.1 |
+| anti-sycophancy-prompting.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| api-design-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| behavior-driven-development.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| behavior-snapshot.md | :x: | :x: |
+| branch-completion.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| browser-compatibility-standards.md | :x: | :warning: 0.0.0 (major) |
+| capability-declaration.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| cd-deployment-strategies.md | :x: | :x: |
+| change-batching-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| changelog-standards.md | :white_check_mark: 1.0.2 | :white_check_mark: 1.0.2 |
+| chaos-engineering-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| chaos-injection-tests.md | :x: | :x: |
+| checkin-standards.md | :white_check_mark: 1.6.0 | :white_check_mark: 1.6.0 |
+| circuit-breaker.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| code-review-checklist.md | :white_check_mark: 1.3.0 | :white_check_mark: 1.3.0 |
+| commit-message-guide.md | :white_check_mark: 1.3.0 | :white_check_mark: 1.3.0 |
+| container-security.md | :x: | :x: |
+| containerization-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| context-aware-loading.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| contract-testing-standards.md | :x: | :warning: 0.0.0 (major) |
+| cost-budget-test.md | :x: | :x: |
+| cross-flow-regression.md | :x: | :warning: 0.0.0 (major) |
+| data-migration-testing.md | :x: | :x: |
+| database-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| deployment-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| deprecation-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| design-document-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| developer-memory.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| disaster-recovery-drill.md | :x: | :x: |
+| documentation-lifecycle.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| documentation-structure.md | :white_check_mark: 1.5.0 | :white_check_mark: 1.5.0 |
+| documentation-writing-standards.md | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| dual-phase-output.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| environment-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| error-code-standards.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.2.0 |
+| estimation-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| execution-history.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| failure-source-taxonomy.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| feature-flag-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| feature-manifest-standard.md | :x: | :x: |
+| flaky-test-management.md | :x: | :x: |
+| flow-based-testing.md | :x: | :x: |
+| forward-derivation-standards.md | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| frontend-design-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| full-coverage-testing.md | :x: | :x: |
+| git-workflow.md | :white_check_mark: 1.4.0 | :white_check_mark: 1.4.0 |
+| git-worktree.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| governance-layer.md | :x: | :white_check_mark: 1.0.0 |
+| health-check-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| immutability-first.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| knowledge-transfer-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| license-compliance.md | :x: | :x: |
+| llm-output-validation.md | :x: | :x: |
+| logging-standards.md | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| mock-boundary.md | :x: | :x: |
+| model-selection.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| mutation-testing.md | :x: | :x: |
+| no-cicd-deployment.md | :x: | :x: |
+| observability-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| packaging-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| performance-standards.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| pipeline-integration-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| pipeline-security-gates.md | :x: | :x: |
+| policy-as-code-testing.md | :x: | :x: |
+| postmortem-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| privacy-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| project-context-memory.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| project-structure.md | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| prompt-regression.md | :x: | :x: |
+| property-based-testing.md | :x: | :x: |
+| recovery-recipe-registry.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| refactoring-standards.md | :white_check_mark: 2.1.0 | :white_check_mark: 2.1.0 |
+| release-quality-manifest.md | :x: | :x: |
+| release-readiness-gate.md | :x: | :warning: 0.0.0 (major) |
+| replay-test.md | :x: | :x: |
+| requirement-engineering.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| retrospective-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| retry-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| reverse-engineering-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| rollback-standards.md | :x: | :x: |
+| runbook-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| sast-advanced.md | :x: | :x: |
+| secure-op.md | :x: | :x: |
+| security-decision.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| security-standards.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| security-testing.md | :x: | :x: |
+| self-review-protocol.md | :x: | :white_check_mark: ? |
+| server-ops-security.md | :x: | :x: |
+| skill-standard-alignment-check.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| slo-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| smoke-test.md | :x: | :x: |
+| spec-driven-development.md | :white_check_mark: 2.2.0 | :white_check_mark: 2.2.0 |
+| standard-admission-criteria.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| standard-lifecycle-management.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| structured-task-definition.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| supply-chain-attestation.md | :x: | :x: |
+| supply-chain-security-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| systematic-debugging.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| tech-debt-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| test-completeness-dimensions.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| test-data-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| test-driven-development.md | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| test-governance.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| testing-standards.md | :white_check_mark: 3.2.0 | :white_check_mark: 3.2.0 |
+| timeout-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| token-budget.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| translation-lifecycle-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| verification-evidence.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| versioning.md | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| virtual-organization-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| workflow-enforcement.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| workflow-state-protocol.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+
+**zh-CN core coverage**: 90/127 (71%)
+**zh-TW core coverage**: 96/127 (76%)
+
+## Drift Warnings
+
+Locale variants whose `translation_version` lags `source_version` by more than 2 minor versions, or by any major version. (Per XSPEC-239 Chimera Prevention — `translation-drift-warn`.)
+
+### zh-TW
+
+- **skill/orchestrate**: translation `1.0.0` vs source `2.0.0` (major-version gap)
+- **skill/plan**: translation `1.0.0` vs source `2.0.0` (major-version gap)
+- **skill/push**: translation `1.0.0` vs source `2.0.0` (major-version gap)
+- **core/browser-compatibility-standards.md**: translation `0.0.0` vs source `1.0.0` (major-version gap)
+- **core/contract-testing-standards.md**: translation `0.0.0` vs source `1.0.0` (major-version gap)
+- **core/cross-flow-regression.md**: translation `0.0.0` vs source `1.0.0` (major-version gap)
+- **core/release-readiness-gate.md**: translation `0.0.0` vs source `1.0.0` (major-version gap)
+
+## Legend
+
+| Symbol | Meaning |
+|--------|---------|
+| :white_check_mark: `x.y.z` | Translated; `translation_version` shown |
+| :warning: `x.y.z` (drift) | Translation lags source by > 2 minor versions |
+| :warning: `x.y.z` (major) | Translation lags source by a major version |
+| :x: | Not translated for this locale |

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

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 5.13.3
-translation_version: 5.13.3
-last_synced: 2026-05-26
+source_version: 5.15.1
+translation_version: 5.15.1
+last_synced: 2026-05-31
 status: current
 ---
 
@@ -17,6 +17,46 @@ status: current
 
 ## [Unreleased]
 
+## [5.15.0] - 2026-05-28
+
+### 新增 — i18n 分层语言策略（XSPEC-239）
+
+- **`core/ai-instruction-standards.md` v1.0.0 → v1.1.0**：新增 `## 国际化（i18n）` 章节，定义 SKILL.md 与 root 级 AI 指令档的 L1/L2/L3/L4 分层语言策略。**范围延伸**自原本只规范 root 级（`CLAUDE.md`、`.cursorrules` 等）扩张至涵盖 skill 级档案（`SKILL.md`）。定义 canonical/locale 档案结构、责任边界、chimera 防范规则、采用者安装模式。
+- **`ai/standards/ai-instruction-standards.ai.yaml` v1.0.0 → v1.1.0**：对应的 `i18n:` 区块 + 4 条新规则。
+- **10 个缺漏 zh-TW locale skill 变体**：`ac-coverage`、`deploy-assistant`、`dev-methodology`、`journey-test-assistant`、`orchestrate`、`plan`、`push`、`skill-builder`、`spec-derivation`、`sweep`。zh-TW skill 覆盖率达 54/54（100%）。
+- **`cli/src/lint/i18n.js` + `uds check --i18n` 命令**：强制执行 5 条 chimera 防范规则。Error 退出码 1。`--json` 模式给 CI 用。
+- **`scripts/generate-locale-coverage.mjs` + 自动产生的 `locales/COVERAGE.md`**：依 skill/standard × locale 的覆盖率矩阵 + drift 警告。npm script `docs:locale-coverage`。
+- **`UDS_LOCALE` 环境变数支援**。
+- **`.uds/install.yaml` `locale:` 栏位支援**：让采用者宣告偏好 locale 一次，免去每次 `--locale`。
+- **Locale fallback WARN**：取代原本的 silent fallback。
+- **i18n 讯息**：新增 `localeFallbackTitle` / `localeFallbackHint` 键（en/zh-tw/zh-cn）。
+
+### 变更
+
+- **CLI locale 解析优先顺序**：6 阶层 — `--locale` > `.uds/install.yaml` > `UDS_LOCALE` env > manifest > `.standards/` 侦测 > `'en'`。
+- **`core/ai-instruction-standards.md` 译本**：zh-TW 与 zh-CN locale 同步至 v1.1.0 含完整在地化 i18n 章节。（zh-CN 章节标记 pending-review，依 XSPEC-239 O-2 — 简中翻译质量策略未定。）
+
+### 修正
+
+- **29 个 canonical SKILL.md 描述 chimera 修正**（XSPEC-239 Phase 1B）：从下列 skill 的 `description:` frontmatter 移除 CJK 内容：`adr-assistant`、`ai-collaboration-standards`、`ai-friendly-architecture`、`ai-instruction-standards`、`api-design-assistant`、`audit-assistant`、`ci-cd-assistant`、`contract-test-assistant`、`database-assistant`、`deploy-assistant`、`documentation-guide`、`error-code-guide`、`git-workflow-guide`、`incident-response-assistant`、`journey-test-assistant`、`logging-guide`、`observability-assistant`、`orchestrate`、`plan`、`pr-automation-assistant`、`project-structure-guide`、`push`、`retrospective-assistant`、`runbook-assistant`、`security-assistant`、`security-scan-assistant`、`slo-assistant`、`sweep`、`testing-guide`。
+- **`skills/reverse-engineer/SKILL.md` description em dash** 改为 ASCII hyphen。
+- **`locales/zh-TW/core/self-review-protocol.md` 缺 YAML frontmatter** 已补。
+
+### 采用者升级注意
+
+对于以 `--locale zh-TW` 或 `--locale zh-CN` 安装 UDS 的项目，请执行 `uds update`。手动编辑过 canonical 档案的采用者，请将客制化内容调整至 locale 变体或 overlay。新的 `uds check --i18n` lint 可验证项目干净。
+
+## [5.14.0] - 2026-05-27
+
+### 新增
+- **`.github/RELEASE-FLOW-TODOS.md`**：发版流程改善项目的持久追踪文件，记录 dogfood 过程中发现的问题。包含 TODO-001 ~ TODO-005（bump-version.mjs 自动执行 docs:generate-index、FB/Threads prompt 捕捉习惯、下次 bootstrap 验证 `_template/`、Phase 1.5 social-assets 硬闸、Phase 2 Meta API 自动发布 workflow）。维护者可直接编辑此文件新增或关闭项目。
+
+### 变更
+- **`.github/workflows/release-reminder.yml`**：现在读取 `.github/RELEASE-FLOW-TODOS.md` 并将 open TODO 显示在每周一 09:00 UTC reminder issue 内文中。改善项目在每个发布周期持续累积，不再遗失在 commit history 里。
+
+### 修复
+- **`cli/src/commands/check.js` — AI 工具集成 check 误报 missing 标准**：`uds check` 错误地将 `error-code-standards` 和 `logging-standards` 报告为 missing，即使实际 `.ai.yaml` 文件（`error-codes.ai.yaml`、`logging.ai.yaml`）已正确写入 `CLAUDE.md`。根因：`migrateStandardsPathsToIds()` 将 manifest 路径转为 registry ID（如 `ai/standards/error-codes.ai.yaml` → `error-code-standards`），但集成文件是以实际文件名生成的。check 现在从 registry 建立 `id → aiFilename` 查找表，在 ID 未直接出现于集成文件时以实际文件名进行第二次比对。
+
 ## [5.13.3] - 2026-05-26
 
 ### 修复

package/bundled/locales/zh-CN/README.md

@@ -14,7 +14,7 @@ status: current
 
 > **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
 
-**版本**: 5.13.3 | **发布日期**: 2026-05-26 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 5.15.1 | **发布日期**: 2026-05-28 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
 
 语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流，确保不同技术栈之间的一致性、质量和可维护性。
 

package/bundled/locales/zh-CN/SECURITY.md

@@ -13,7 +13,7 @@ status: current
 <!-- UDS_SUPPORTED_VERSIONS_START -->
 | 版本 | 支持状态 |
 |------|--------|
-| 5.13.2 | ✅ 最新正式版 |
+| 5.15.0 | ✅ 最新正式版 |
 | < 5.0.0 | ❌ 已终止支持 |
 <!-- UDS_SUPPORTED_VERSIONS_END -->
 

package/bundled/locales/zh-CN/core/ai-instruction-standards.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../core/ai-instruction-standards.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-14
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-05-28
 status: current
 ---
 
@@ -10,8 +10,8 @@ status: current
 
 > **语言**: [English](../../../core/ai-instruction-standards.md) | [简体中文](../../zh-TW/core/ai-instruction-standards.md) | 简体中文
 
-**版本**: 1.0.0
-**最后更新**: 2026-01-14
+**版本**: 1.1.0
+**最后更新**: 2026-05-28
 **适用范围**: 所有使用 AI 编码助手的项目
 
 ---
@@ -151,6 +151,111 @@ AI 指令文件通常混合两种类型的内容：
 
 ---
 
+## 国际化（i18n）
+
+AI 指令档常需提供多语言版本——既为了国际采用者，也为了非英语母语维护者主导的项目。本章节定义多语言指令档的组织、验证与安装规则。
+
+### AI 指令档的范围
+
+本标准涵盖两个层级的 AI 指令档：
+
+| 层级 | 范例 | i18n 模式 |
+|------|------|----------|
+| **Root 层** | `CLAUDE.md`、`.cursorrules`、`.windsurfrules`、`.opencode/instructions.md` | 单档内以 inline 段落分语言（例：`## 中文` / `## English`）|
+| **Skill 层** | Claude Code `.claude/skills/{name}/SKILL.md`、OpenCode plugin instructions | Canonical（英文）+ `locales/{lang}/` 变体 |
+
+> 注意：skill 层的多档结构主要对 Claude Code 适用。其他工具是 root 单档；对它们只有下方「分层语言策略」与「Chimera 防范」规则适用。
+
+### 分层语言策略
+
+每份 AI 指令档概念上有 **4 层**，各层语言责任不同：
+
+| 层 | 内容 | Canonical (en) | Locale ({lang}) | 为何分这层 |
+|----|------|---------------|----------------|-----------|
+| **L1 — Metadata** | YAML frontmatter `description`、`argument-hint`、`allowed-tools` | **必须英文** | **必须对应 locale 语言** | AI 触发讯号；英文 token 效率最高 + 训练语料密度高 |
+| **L2 — 指令（Instructions）** | 对 AI 的命令式规则 | **必须英文** | 对应 locale 语言（可选；可保留英文）| AI 读英文指令最精准 |
+| **L3 — 输出范本（Output Templates）** | 范例输出、回应格式、情境范本 | 英文（canonical 锁定英文）| **强制对应 locale**（mandatory）| **唯一直接影响 AI 输出语言的层** |
+| **L4 — 人类文件** | 维护者注解、贡献者说明 | 英文 | 对应 locale 语言（强烈建议）| 给人类维护者读，AI 不读 |
+
+**关键 insight**：L1（description）是 AI 用来决定「**是否调用**」此 skill 的触发讯号——它**不**影响 AI 之后说什么。L3（output template）才是控制 AI 输出语言的唯一开关。**i18n 强制检查应该聚焦在 L3——加强 L1 的强制是常见错误。**
+
+### Canonical / Locale 档案结构
+
+UDS 标准与 skill 的 locale 变体结构：
+
+```text
+core/{name}.md
+core/{name}.ai.yaml
+locales/{lang}/core/{name}.md
+locales/{lang}/ai/standards/{name}.ai.yaml
+skills/{name}/SKILL.md
+locales/{lang}/skills/{name}/SKILL.md
+```
+
+**命名惯例**：使用 BCP 47 语言标签——`zh-TW`、`zh-CN`、`ja`、`ko`、`en-US` 等。
+
+### Locale 变体 Frontmatter 必填栏位
+
+```yaml
+---
+name: {与 canonical 同名}
+source: {指回 canonical 的相对路径}
+source_version: {翻译时 canonical 的版本}
+translation_version: {本翻译的版本}
+---
+```
+
+`source_version` 落后超过 2 个 minor 版本会触发 drift 警告。
+
+### 责任边界
+
+| 角色 | 拥有 | 必须做 |
+|------|------|--------|
+| **Canonical 拥有者** | `core/{name}.md` 等 | 维持 L1/L2/L3/L4 为英文；breaking change 时 bump `source_version` |
+| **Locale 维护者** | `locales/{lang}/...` | `translation_version` 对齐 `source_version`；翻译 L1（必）、L2（选）、L3（必）、L4（建议）|
+| **采用者** | 自己的 `.claude/skills/`、`CLAUDE.md` | 用 `uds install --locale {lang}` 安装；**绝不**手动修改 canonical |
+
+### Chimera 防范
+
+| 模式 | 严重度 | 侦测方式 |
+|------|--------|----------|
+| Canonical 的 `description` 含 CJK | ❌ Error | Lint |
+| Locale 变体的 `description` 是纯 ASCII | ❌ Error | Lint |
+| Locale 变体缺 `source:` frontmatter | ❌ Error | Lint |
+| Canonical L3 含非英文范例 | ⚠️ Warn | Lint |
+| 采用者档案与 canonical/locale 都不同 | ⚠️ Warn | Sync check |
+| `translation_version` 落后过多 | ⚠️ Warn | Drift check |
+
+### 采用者安装
+
+```bash
+uds install --locale zh-CN   # 以简体中文安装 skills 与 standards
+```
+
+**Locale 解析优先顺序**：`--locale` flag > `.uds/install.yaml` > `UDS_LOCALE` env > fallback `en`
+
+Locale 不存在时 fallback 到 canonical + WARN，**不**阻断安装。
+
+### 迁移：已有 chimera 的采用者
+
+1. **辨识 chimera**：比对采用者档案与 UDS canonical / locale 变体
+2. **安装正确变体**：`uds install --locale {lang}`
+3. **保留专案级客制**：抽出为 overlay
+4. **丢弃纯翻译**：locale 变体取代之
+
+### 快速参考
+
+| 动作 | 何时 | 工具 / 档案 |
+|------|------|------------|
+| 新增语言支援 | 想支援新 locale | `locales/{lang}/...` |
+| 更新 canonical | 改进英文 source | Bump `source_version` |
+| 翻译 / 同步 locale | 新增或更新 locale 内容 | Bump `translation_version` |
+| 检查覆盖率 | 定期 review | `locales/COVERAGE.md` |
+| 带 locale 安装 | 采用者初设 | `uds install --locale {lang}` |
+| 跑 i18n lint | Commit 前 / CI | `uds lint --i18n` |
+
+---
+
 ## 维护检查清单
 
 在提交 AI 指令文件的变更之前：
@@ -205,6 +310,7 @@ grep -n "npm\|yarn\|pip\|cargo" CLAUDE.md | head -20
 | 版本 | 日期 | 变更 |
 |------|------|------|
 | 1.0.0 | 2026-01-14 | 初始发布 |
+| 1.1.0 | 2026-05-28 | 新增 i18n 章节；范围延伸至 skill 层级文件 |
 
 ---
 

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

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 5.13.3
-translation_version: 5.13.3
-last_synced: 2026-05-26
+source_version: 5.15.1
+translation_version: 5.15.1
+last_synced: 2026-05-31
 status: current
 ---
 
@@ -17,6 +17,50 @@ status: current
 
 ## [Unreleased]
 
+## [5.15.0] - 2026-05-28
+
+### 新增 — i18n 分層語言策略（XSPEC-239）
+
+- **`core/ai-instruction-standards.md` v1.0.0 → v1.1.0**：新增 `## 國際化（i18n）` 章節，定義 SKILL.md 與 root 級 AI 指令檔的 L1/L2/L3/L4 分層語言策略。**範圍延伸**自原本只規範 root 級（`CLAUDE.md`、`.cursorrules` 等）擴張至涵蓋 skill 級檔案（`SKILL.md`）。定義 canonical/locale 檔案結構、責任邊界、chimera 防範規則、採用者安裝模式。
+- **`ai/standards/ai-instruction-standards.ai.yaml` v1.0.0 → v1.1.0**：對應的 `i18n:` 區塊 + 4 條新規則（`i18n-canonical-english-only`、`i18n-locale-must-match-language`、`i18n-l3-template-language-controls-output`、`i18n-no-manual-canonical-edits-by-adopters`）。
+- **10 個缺漏 zh-TW locale skill 變體**：`ac-coverage`、`deploy-assistant`、`dev-methodology`、`journey-test-assistant`、`orchestrate`、`plan`、`push`、`skill-builder`、`spec-derivation`、`sweep`。zh-TW skill 覆蓋率達 54/54（100%）。
+- **`cli/src/lint/i18n.js` + `uds check --i18n` 命令**：強制執行 5 條 chimera 防範規則（`canonical:description-must-be-ascii` 錯誤、`locale:description-must-match-language` 錯誤、`locale:must-have-source-frontmatter` 錯誤、`canonical:l3-language-consistency` 警告、`translation-drift-warn` 警告）。Error 退出碼 1。`--json` 模式給 CI 用。
+- **`scripts/generate-locale-coverage.mjs` + 自動產生的 `locales/COVERAGE.md`**：依 skill/standard × locale 的覆蓋率矩陣 + drift 警告。npm script `docs:locale-coverage`。
+- **`UDS_LOCALE` 環境變數支援**：在 `cli/src/i18n/messages.js detectLanguage()` 與 `cli/src/commands/update.js resolveLocale()` 讀取。接受 `zh-tw`、`zh_tw`、`zh-cn`、`zh_cn`、`en`（不分大小寫）。
+- **`.uds/install.yaml` `locale:` 欄位支援**：`cli/src/utils/config-manager.js readInstallYaml()` 讀取可選 `locale:`，讓採用者宣告偏好 locale 一次，免去每次 `--locale`。
+- **Locale fallback WARN**：當 `installSingleSkill` 從缺漏的 locale 變體 fallback 到英文時，安裝結束時統一以黃色 WARN 區塊列出受影響 skill。取代原本的 silent fallback。
+- **i18n 訊息**：在 en/zh-tw/zh-cn locale 中新增 `localeFallbackTitle` / `localeFallbackHint` 鍵。
+
+### 變更
+
+- **CLI locale 解析優先順序**（`cli/src/commands/update.js resolveLocale()`）：現為 6 階層 — `--locale` CLI 旗標 > `.uds/install.yaml` `locale:` > `UDS_LOCALE` env > manifest > `.standards/` 偵測 > `'en'`。`init` 與 `update` 一致。
+- **`core/ai-instruction-standards.md` 譯本**：zh-TW 與 zh-CN locale 同步至 v1.1.0 含完整在地化 i18n 章節。（zh-CN 章節標記 pending-review，依 XSPEC-239 O-2 — 簡中翻譯品質策略未定。）
+
+### 修正
+
+- **29 個 canonical SKILL.md 描述 chimera 修正**（XSPEC-239 Phase 1B）：自下列 skill 的 `description:` frontmatter 移除 CJK 內容：`adr-assistant`、`ai-collaboration-standards`、`ai-friendly-architecture`、`ai-instruction-standards`、`api-design-assistant`、`audit-assistant`、`ci-cd-assistant`、`contract-test-assistant`、`database-assistant`、`deploy-assistant`、`documentation-guide`、`error-code-guide`、`git-workflow-guide`、`incident-response-assistant`、`journey-test-assistant`、`logging-guide`、`observability-assistant`、`orchestrate`、`plan`、`pr-automation-assistant`、`project-structure-guide`、`push`、`retrospective-assistant`、`runbook-assistant`、`security-assistant`、`security-scan-assistant`、`slo-assistant`、`sweep`、`testing-guide`。譯本改放於 `locales/{lang}/skills/`。原本依賴 `.claude/skills/` 中繁中描述的採用者應重跑 `uds update --locale zh-TW`（或 `--locale zh-CN`）。
+- **`skills/reverse-engineer/SKILL.md` description em dash（U+2014）** 改為 ASCII hyphen — canonical 描述必須純 ASCII（依新 lint 規則）。
+- **`locales/zh-TW/core/self-review-protocol.md` 缺 YAML frontmatter** 已補（`source:`、`source_version:`、`translation_version:`、`last_synced:`、`status:`），與其他 zh-TW core 變體一致。
+
+### 採用者升級注意
+
+對於以 `--locale zh-TW` 或 `--locale zh-CN` 安裝 UDS（或被 `LANG=zh_*` 偵測）的專案，本次 release 可能造成使用者可見的變化：
+
+- **升級後請執行 `uds update`**。原本描述含中文的 skill，canonical 中的 `description:` 會變英文，繁中 `description:` + body 在 locale 變體中。`.claude/skills/{name}/SKILL.md` 會從 locale 變體自動重新安裝。
+- **手動編輯過 canonical** 檔案（在 `.claude/skills/` 加繁中描述）的採用者，請將客製化內容調整至 locale 變體或 overlay — 詳見 `core/ai-instruction-standards.md` 的 `XSPEC-239` 遷移章節。
+- 新的 `uds check --i18n` lint 可驗證專案乾淨：errors 阻擋，warnings（例如 `translation-drift-warn`）只進 dashboard 不預設 fail CI。
+
+## [5.14.0] - 2026-05-27
+
+### 新增
+- **`.github/RELEASE-FLOW-TODOS.md`**：發版流程改善項目的持久追蹤檔案，記錄 dogfood 過程中發現的問題。包含 TODO-001 ~ TODO-005（bump-version.mjs 自動執行 docs:generate-index、FB/Threads prompt 捕捉習慣、下次 bootstrap 驗證 `_template/`、Phase 1.5 social-assets 硬閘、Phase 2 Meta API 自動發布 workflow）。維護者可直接編輯此檔案新增或關閉項目。
+
+### 變更
+- **`.github/workflows/release-reminder.yml`**：現在讀取 `.github/RELEASE-FLOW-TODOS.md` 並將 open TODO 顯示在每週一 09:00 UTC reminder issue 內文中。改善項目在每個發布週期持續累積，不再遺失在 commit history 裡。
+
+### 修復
+- **`cli/src/commands/check.js` — AI 工具整合 check 誤報 missing 標準**：`uds check` 錯誤地將 `error-code-standards` 和 `logging-standards` 報告為 missing，即使實際 `.ai.yaml` 檔案（`error-codes.ai.yaml`、`logging.ai.yaml`）已正確寫入 `CLAUDE.md`。根因：`migrateStandardsPathsToIds()` 將 manifest 路徑轉為 registry ID（如 `ai/standards/error-codes.ai.yaml` → `error-code-standards`），但整合檔案是以實際檔名生成的。check 現在從 registry 建立 `id → aiFilename` 查找表，在 ID 未直接出現於整合檔案時以實際檔名進行第二次比對。
+
 ## [5.13.3] - 2026-05-26
 
 ### 修復

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

@@ -14,7 +14,7 @@ status: current
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 5.13.3 | **發布日期**: 2026-05-26 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 5.15.1 | **發布日期**: 2026-05-28 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
 
 語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流，確保不同技術堆疊之間的一致性、品質和可維護性。
 

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

@@ -13,7 +13,7 @@ status: current
 <!-- UDS_SUPPORTED_VERSIONS_START -->
 | 版本 | 支援狀態 |
 |------|--------|
-| 5.13.2 | ✅ 最新正式版 |
+| 5.15.0 | ✅ 最新正式版 |
 | < 5.0.0 | ❌ 已終止支援 |
 <!-- UDS_SUPPORTED_VERSIONS_END -->