universal-dev-standards 6.7.4 → 6.8.0

package/bin/uds.js

@@ -5,6 +5,7 @@ import { program } from 'commander';
 import { listCommand } from '../src/commands/list.js';
 import { initCommand } from '../src/commands/init.js';
 import { checkCommand } from '../src/commands/check.js';
+import { lintCommand } from '../src/commands/lint.js';
 import { simulateCommand } from '../src/commands/simulate.js';
 import { fixCommand } from '../src/commands/fix.js';
 import { updateCommand } from '../src/commands/update.js';
@@ -186,6 +187,12 @@ program
   .option('--i18n', 'Run i18n lint rules (XSPEC-239) across canonical + locale variants')
   .action(checkCommand);
 
+program
+  .command('lint')
+  .description('Check spec dependency validity and size against installed specs (specs/*.md)')
+  .option('--json', 'Output result in JSON format')
+  .action(lintCommand);
+
 program
   .command('simulate')
   .description('Simulate a standard check with input (Predictive Validation)')

package/bundled/ai/standards/ai-instruction-standards.ai.yaml

@@ -3,7 +3,7 @@
 
 id: ai-instruction-standards
 meta:
-  version: "2.1.0"
+  version: "2.1.1"
   updated: "2026-08-12"
   source: core/ai-instruction-standards.md
   description: Best practices for creating AI instruction files (root and skill level) with universal/project-specific separation, i18n strategy, and a detailed cross-tool support matrix
@@ -309,7 +309,7 @@ rules:
 
   - id: i18n-no-manual-canonical-edits-by-adopters
     trigger: adopter wants to customize an installed instruction file
-    instruction: Use uds install --locale or overlays; do not modify canonical files in-place
+    instruction: Use uds init --locale (first install) or uds update --locale (re-sync), or overlays; do not modify canonical files in-place
     priority: required
 
 maintenance_checklist:
@@ -434,7 +434,7 @@ i18n:
       owns:
         - their own .claude/skills/, CLAUDE.md
       duties:
-        - Install via uds install --locale {lang}
+        - Install via uds init --locale {lang}; re-sync with uds update --locale {lang}
         - Never manually modify canonical files
         - Use overlays or locale variants for customization
 
@@ -459,14 +459,14 @@ i18n:
       - id: adopter-must-match-installed-locale
         trigger: adopter file in .claude/skills/ differs from both canonical and any locale variant
         severity: warn
-        instruction: Use uds install --locale or overlays instead of manual canonical edits
+        instruction: Use uds init --locale / uds update --locale or overlays instead of manual canonical edits
       - id: translation-drift-warn
         trigger: translation_version lag > 2 minor versions behind source_version
         severity: warn
         instruction: Re-sync translation from current canonical version
 
   installation_model:
-    cli: uds install --locale {lang}
+    cli: uds init --locale {lang}
     locale_resolution_priority:
       - --locale CLI flag
       - .uds/install.yaml locale field
@@ -483,7 +483,7 @@ i18n:
       - id: identify
         description: Compare adopter files against UDS canonical and locale variants
       - id: install_proper_variants
-        description: Run uds install --locale {lang} to replace chimera
+        description: Run uds update --locale {lang} to replace chimera
       - id: preserve_legitimate_customization
         description: Extract project-specific (non-translation) customization into overlay or UDS-CUSTOMIZATION.md
       - id: discard_pure_translations

package/bundled/core/ai-instruction-standards.md

@@ -2,8 +2,8 @@
 
 > **Language**: English | [繁體中文](../locales/zh-TW/core/ai-instruction-standards.md) | [简体中文](../locales/zh-CN/core/ai-instruction-standards.md)
 
-**Version**: 1.1.0
-**Last Updated**: 2026-05-28
+**Version**: 1.1.1
+**Last Updated**: 2026-08-19
 **Applicability**: All projects using AI coding assistants
 **Scope**: partial
 **Industry Standards**: None (Emerging AI tool practice)
@@ -209,7 +209,7 @@ When canonical is updated (bumping `source_version`), locale maintainers should
 |------|------|---------|
 | **Canonical owner** | `core/{name}.md`, `core/{name}.ai.yaml`, `skills/{name}/SKILL.md` | Keep L1/L2/L3/L4 in English; bump `source_version` on every breaking change |
 | **Locale maintainer** | `locales/{lang}/...` files | Keep `translation_version` aligned with `source_version`; translate L1 (required) / L2 (optional) / L3 (required) / L4 (recommended) |
-| **Adopter (downstream project)** | Their own `.claude/skills/`, `CLAUDE.md`, etc. | Install via `uds install --locale {lang}`; **never** manually modify canonical files (always edit locale variants or use overlays) |
+| **Adopter (downstream project)** | Their own `.claude/skills/`, `CLAUDE.md`, etc. | Install via `uds init --locale {lang}` (first time) or `uds update --locale {lang}` (re-sync); **never** manually modify canonical files (always edit locale variants or use overlays) |
 
 ### Chimera Prevention
 
@@ -231,7 +231,8 @@ Pre-commit / CI lint should enforce error-level rules; warn-level rules surface
 Adopters install instruction files via the UDS CLI:
 
 ```bash
-uds install --locale zh-TW   # install skills + standards in Traditional Chinese
+uds init --locale zh-tw     # first-time install of skills + standards in Traditional Chinese
+uds update --locale zh-tw   # re-sync an existing adoption
 ```
 
 **Locale resolution order**:
@@ -252,7 +253,7 @@ This keeps installation usable for adopters even when locale coverage is incompl
 If an adopter has already manually modified canonical files in their project (e.g. translated descriptions in `.claude/skills/`):
 
 1. **Identify the chimera**: compare adopter files against UDS canonical and canonical's locale variants.
-2. **Install proper variants**: run `uds install --locale {lang}` to replace chimera files with locale variants.
+2. **Install proper variants**: run `uds update --locale {lang}` to replace chimera files with locale variants.
 3. **Preserve project-specific customization**: if the chimera contained legitimate project-specific customization (not just translation), extract it into an overlay or document it in the adopter's customization log (e.g. `UDS-CUSTOMIZATION.md`).
 4. **Discard pure translations**: chimera changes that were only translations should be discarded — the proper locale variant supersedes them.
 
@@ -264,8 +265,9 @@ If an adopter has already manually modified canonical files in their project (e.
 | Update canonical | Improving English source | Bump `source_version`; notify locale maintainers |
 | Translate / sync locale | Adding or updating locale content | Bump `translation_version`; reference current `source_version` |
 | Check coverage | Periodic review | View auto-generated `locales/COVERAGE.md` |
-| Install with locale | Adopter setup or re-sync | `uds install --locale {lang}` |
-| Lint i18n rules | Before commit / in CI | `uds lint --i18n` |
+| Install with locale | Adopter setup | `uds init --locale {lang}` |
+| Re-sync with locale | Existing adoption | `uds update --locale {lang}` |
+| Lint i18n rules | Before commit / in CI | `uds check --i18n` |
 
 ---
 

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

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 6.7.4
-translation_version: 6.7.4
-last_synced: 2026-08-18
+source_version: 6.8.0
+translation_version: 6.8.0
+last_synced: 2026-08-19
 status: current
 ---
 
@@ -17,6 +17,35 @@ status: current
 
 ## [Unreleased]
 
+## [6.8.0] - 2026-08-20
+
+### 新增
+
+- **一道去问「这条 `uds <cmd>` 指示真的跑得动吗」的闸门（XSPEC-383 R4）。** 2026-08-19 查到三个顶层命令（`uds install`、`uds lint`、`uds sync`）与两个旗标（`uds check --spec-size`、`uds spec create --boost`）出现在出货的指引里而**它们都不存在**——落点包括 `quickstart.js`（它的整个工作就是「快速找到对的命令」）与 `integration-generator.js`（它把命令**写进每一个采用者的 `CLAUDE.md`／`AGENTS.md`**）。两处早已修掉（`465335e4`），而**没有任何东西在确认那个修正会维持**。`check-command-existence.mjs` 走访 `core/`、`locales/`、`ai/standards/`、`cli/src/`、`skills/`、`docs/` 与 repo 根目录的 `*.md`，抽出每一个 `uds <cmd>` 样式，用 `uds <path> --definitely-not-a-real-flag` 对本次 commit 自己的 CLI 探测——**不是 `--help`**：commander 对**未知**命令会回答通用命令表而不是报错，而那正是 `uds lint`／`uds sync` 在第一轮检查中存活的原因。
+- **同一支探针对现况再跑一次，翻出第一次事故的修正从未碰到的漂移。** `uds workflow`（v6.0.0 移除）在 `docs/user/CHEATSHEET.md`、`docs/reference/FEATURE-REFERENCE.md`、`skills/workflows/README.md`（及 zh-TW／zh-CN 镜像）**被当成现行命令展示了五个月**，而 `docs/MIGRATION-v6.md` 自己就给了能抓到它的那条 grep。`uds config --lang`／`--mode` 从未存在（root `README.md`、两份 locale、`docs/reference/INTEGRATION-VERIFICATION.md`）。`uds agent install --all` 把位置参数写成旗标。`uds reverse-tdd` 是为了一段 GitHub Actions 范例**虚构出来的 CLI**。`uds check --interactive` 不存在，因为交互模式本来就是默认。**29 个发现，29 个修好，0 个残留。**
+- **一道去问「有没有人到得了这段代码」的闸门（XSPEC-383 R3）。** 单元测试证明函数是对的，对「有没有使用者叫得到」一个字都没说。2026-04-07 有一次 commit 加了 `spec-linter.js`（172 行、14 个测试全过）与 `sync.js`（133 行）——**两者都从未被注册**，而同一天有下游产品把自己接上 `npx uds lint --json`，一个因此永远不会存在的命令。四个半月，两边全绿，中间没有一条通的路。`check-module-reachability.mjs` 从 package.json 的 `bin` 与 `main` 出发做 BFS，**手查找到 2 个，走访找到 24 个**，含整个九模块的 `src/flow/` 子系统。
+- **`uds lint`（XSPEC-383 R5）。** 注册那个 linter 自 2026-04-07 起就在等的命令，带着两项禁得起真实 spec 考验的检查：依赖有效性与篇幅。
+
+### 变更
+
+- **哈希前先规范化行尾（#155）。** `uds check` 比对的是磁盘上的原始 bytes，于是 Windows 在 `core.autocrlf=true` 下的 checkout 把每个 LF 换成 CRLF，**每一个哈希都不再吻合**——而「N 个文件已修改」这句话，无论是有人改了 N 个文件还是平台改写了每一个换行，读起来完全一样。走访另外找到两套从不经过 `hasher.js` 的哈希实现，四处全修。新增 21 个测试，含负向对照：真实内容差异与尾随空白差异，在 CRLF checkout 上仍须检测得到。`uds check --force` 的输出前后逐字节相同，既有 manifest 不需要重新盖章。
+- **使用说明生成器改为问 CLI，而不是背诵一份清单。** `scanCliCommands` 把 `cli/bin/uds.js` 读进一个变量然后忽略它，改用一份注记着「based on uds.js analysis」的手写数组。于是**每一次重新生成都把已移除的 `uds workflow` 写回文档**，也从来不会加入 `uds lint`。现在它解析 `uds --help`——CLI 对自己有哪些命令的权威回答，涵盖任何单文件解析看不到的注册写法（`mcp` 完全由另一个模块注册）。涵盖率从 19/24 变成 **23/23**。
+
+### 移除
+
+- **`uds sync` 与 AC 覆盖检查（XSPEC-383 R5，选项 E）。** `sync.js` 零消费者。AC 覆盖检查对 93 份真实 spec 测量，报告 98 条验收条件中 0 条被覆盖——**不是因为它们没有测试**，而是因为它用**位置**生成 AC 标识符（`AC-1`、`AC-2`）而不是读规格声明的那些，再用写死的 `@` 前缀去找。一个写 `AC-045-001` 并且标注不带 `@` 的项目，无论追溯做得多完整都会得到零覆盖。**它报的不是「这个项目没有追溯」，而是「我用我自己的惯例去找，找不到」，而这两句话打印出来一模一样。** 它是移除而不是留着不接：它是一个正确实现了一个唯一已知消费者并不使用的惯例的东西，躺在树上等着被人重新接上。跨 repo 的 AC 标识符惯例调解是协商，不是补丁，另案处理。
+
+## [6.7.5] - 2026-08-18
+
+### 变更
+
+- **八个 skill 重新可以被模型选中。** `audit-assistant`、`changelog-guide`、`commit-standards`、`docs-generator`、`project-discovery`、`release-standards`、`reverse-engineer` 与 `spec-derivation` 都带着 `disable-model-invocation: true`，那是 `d415937e` 在改写描述时一并加上的，**没有遵循任何说得出口的规则**。2026-08-17 刻意没有动它们，而那个理由在当时是对的：当时定下的规则是「reference 是可以被模型调用的」，而这些**一个都没有 `status` 字段**，解除它们等于用一个没有规则的动作，换掉一个没有规则的状态。此后测量：**八个全都有完整的 `Use when:` 触发条件与 `Not for:` 排除条件、八个描述的都是动作而非参考资料、八个都已经有对应的斜线命令**——这正是 `code-review-assistant` 的形状，而它的 `/code-review` 已被裁定不构成保留该标志的理由。`journey-test-assistant` 是现成的先例：同样的「Generate X」形状、`status: stable`、从未被禁用。每一份现在都记上 `status: stable` 并在文件内写明理由。用 `stable` 而非新值，因为 `skills/` 只用 reference、stable、experimental 三个值，**发明第四个等于换了件衣服的同一个无规则动作**。
+- **模型实际选得到的 skill 数,现在是 55/55。** 此前是 45。
+
+### 修正
+
+- **英文来源移除标志后，locale 版仍然照样出货带着它。** `spec-derivation` 是唯一在 locale 包里自带 `disable-model-invocation` 的 skill，而 frontmatter 合并**只复制英文来源「有」的字段**——所以一个英文已经不再声明的字段，会在 locale 文件里原封不动地留下并照样出货。zh-TW 与 zh-CN 均已更正。以解析 **60 个 skill × 3 个 locale ＝ 165 份安装结果**验证：零个仍被禁用。
+
 ## [6.7.4] - 2026-08-18
 
 ### 修正

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

@@ -2,8 +2,8 @@
 source: ../../README.md
 source_version: 6.0.0
 translation_version: 6.0.0
-last_synced: 2026-07-08
-source_hash: add024721b5a
+last_synced: 2026-08-19
+source_hash: d978c5775a25
 status: current
 ---
 
@@ -15,7 +15,7 @@ status: current
 
 > **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
 
-**版本**: 6.7.4 | **发布日期**: 2026-08-18 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 6.8.0 | **发布日期**: 2026-08-20 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
 
 语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流，确保不同技术栈之间的一致性、质量和可维护性。
 
@@ -79,7 +79,7 @@ npx universal-dev-standards init
 | **核心标准** | 150 | 通用开发准则 |
 | **AI Skills** | 55 | 互动式技能 |
 | **斜线命令** | 51 | 快速操作 |
-| **CLI 命令** | 22 | 项目设置与维护 |
+| **CLI 命令** | 23 | 项目设置与维护 |
 <!-- UDS_STATS_TABLE_END -->
 
 > **5.0 新功能？** 请参阅[预发布说明](../../docs/PRE-RELEASE.md)了解新功能详情。
@@ -198,9 +198,9 @@ uds uninstall   # 从项目移除标准
 
 | 参数 | 命令 | 说明 |
 | :--- | :--- | :--- |
-| **提交语言** | `uds config --lang zh-CN` | 设置 AI 提交消息的偏好语言 |
+| **提交语言** | `uds config set output_language simplified-chinese` | 设置 AI 提交消息的偏好语言 |
 | **标准** | `uds init` | 安装所有可用标准 |
-| **工具模式** | `uds config --mode skills` | 在 Skills、Standards 或两者之间切换 |
+| **工具模式** | `uds config --type content_mode` | 在 Skills、Standards 或两者之间切换 |
 
 ---
 

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

@@ -13,7 +13,7 @@ status: current
 <!-- UDS_SUPPORTED_VERSIONS_START -->
 | 版本 | 支持状态 |
 |------|--------|
-| 6.7.4 | ✅ 最新正式版 |
+| 6.8.0 | ✅ 最新正式版 |
 | < 6.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.1.0
-translation_version: 1.1.0
-last_synced: 2026-05-28
+source_version: 1.1.1
+translation_version: 1.1.1
+last_synced: 2026-08-19
 status: current
 ---
 
@@ -213,7 +213,7 @@ translation_version: {本翻译的版本}
 |------|------|--------|
 | **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 |
+| **采用者** | 自己的 `.claude/skills/`、`CLAUDE.md` | 用 `uds init --locale {lang}`（首次）或 `uds update --locale {lang}`（重新同步）安装；**绝不**手动修改 canonical |
 
 ### Chimera 防范
 
@@ -229,7 +229,8 @@ translation_version: {本翻译的版本}
 ### 采用者安装
 
 ```bash
-uds install --locale zh-CN   # 以简体中文安装 skills 与 standards
+uds init --locale zh-cn     # 首次以简体中文安装 skills 与 standards
+uds update --locale zh-cn   # 对既有采用重新同步
 ```
 
 **Locale 解析优先顺序**：`--locale` flag > `.uds/install.yaml` > `UDS_LOCALE` env > fallback `en`
@@ -239,7 +240,7 @@ Locale 不存在时 fallback 到 canonical + WARN，**不**阻断安装。
 ### 迁移：已有 chimera 的采用者
 
 1. **辨识 chimera**：比对采用者档案与 UDS canonical / locale 变体
-2. **安装正确变体**：`uds install --locale {lang}`
+2. **安装正确变体**：`uds update --locale {lang}`
 3. **保留专案级客制**：抽出为 overlay
 4. **丢弃纯翻译**：locale 变体取代之
 
@@ -251,8 +252,9 @@ Locale 不存在时 fallback 到 canonical + WARN，**不**阻断安装。
 | 更新 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` |
+| 带 locale 安装 | 采用者初设 | `uds init --locale {lang}` |
+| 带 locale 重新同步 | 既有采用 | `uds update --locale {lang}` |
+| 跑 i18n lint | Commit 前 / CI | `uds check --i18n` |
 
 ---
 

package/bundled/locales/zh-CN/docs/CHEATSHEET.md

@@ -1,6 +1,6 @@
 # UDS 速查表
 
-> Quick reference for all UDS features | Last updated: 2026-08-17
+> Quick reference for all UDS features | Last updated: 2026-08-19
 
 **Language**: [English](../../../docs/user/CHEATSHEET.md) | [繁體中文](../../zh-TW/docs/CHEATSHEET.md) | 简体中文
 
@@ -12,13 +12,27 @@
 |---------|-------------|
 | `uds list` | List available standards |
 | `uds init` | Initialize standards in current project |
-| `uds configure` | Modify options for initialized project |
-| `uds check` | Check adoption status of current project |
+| `uds config` | Manage UDS configuration and project settings |
+| `uds hitl` | Human-in-the-Loop controls |
+| `uds configure` | Alias for "uds config" — Modify project settings |
+| `uds check` | Check file integrity and adoption status (quick validation). For deep health diagnosis, use "uds audit" |
+| `uds lint` | Check spec dependency validity and size against installed specs (specs/*.md) |
+| `uds simulate` | Simulate a standard check with input (Predictive Validation) |
+| `uds fix` | Auto-fix standard violations (Self-Healing) |
 | `uds update` | Update standards to latest version |
 | `uds skills` | List installed Claude Code skills |
-| `uds agent` | Manage UDS agents (list, install, info) |
-| `uds workflow` | Manage UDS workflows (list, install, info, execute, status) |
-| `uds ai-context` | Manage AI context configuration (init, validate, graph) |
+| `uds audit` | Deep health diagnosis with pattern detection and feedback (strategic). For quick file check, use "uds check" |
+| `uds deps` | Compare the versions you test against the versions your declared ranges resolve to |
+| `uds uninstall` | Remove UDS standards, integrations, skills, and hooks |
+| `uds compile` | Compile enforcement standards into hook configurations |
+| `uds report` | Analyze hook telemetry and show adoption report |
+| `uds release` | Manage release process (promote, deploy, manifest, verify) |
+| `uds spec` | Manage lightweight micro-specs for vibe coding. For full spec lifecycle with review, use "/sdd" |
+| `uds quickstart` | Interactive workflow guide — find the right commands quickly |
+| `uds agent` | Manage UDS agents for AI tools |
+| `uds ai-context` | Manage .ai-context.yaml configuration for AI-friendly architecture |
+| `uds mcp` | MCP server commands for AI tool integration |
+| `uds run` | Run a project command by intent (test/lint/build/security) via uds.project.yaml |
 
 ## 💬 斜线命令
 

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

@@ -1,7 +1,7 @@
 # UDS 功能参考手册
 
 > Universal Development Standards - 完整功能文档
-> Auto-generated | Last updated: 2026-08-17
+> Auto-generated | Last updated: 2026-08-19
 
 **Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | [繁體中文](../../zh-TW/docs/FEATURE-REFERENCE.md) | 简体中文
 
@@ -9,7 +9,7 @@
 
 ## 目录
 
-1. [CLI 指令](#cli-commands) (9)
+1. [CLI 指令](#cli-commands) (23)
 2. [斜线命令](#slash-commands) (51)
 3. [技能](#skills) (55)
 4. [代理](#agents) (5)
@@ -17,7 +17,7 @@
 6. [核心规范](#core-standards) (150)
 7. [脚本](#scripts) (54)
 
-**Total Features: 329**
+**Total Features: 343**
 
 ---
 
@@ -58,9 +58,22 @@
 | `-E, --experimental` | Enable experimental features (methodology) |
 | `--force` | Bypass UDS source-repo self-adoption guard (DEC-044 / XSPEC-071) |
 
+### `uds config`
+
+**说明**: Manage UDS configuration and project settings
+
+### `uds hitl`
+
+**说明**: Human-in-the-Loop controls
+
+**选项**:
+| Option | 说明 |
+|--------|-------------|
+| `--op` | Operation description |
+
 ### `uds configure`
 
-**说明**: Modify options for initialized project
+**说明**: Alias for "uds config" — Modify project settings
 
 **选项**:
 | Option | 说明 |
@@ -73,7 +86,7 @@
 
 ### `uds check`
 
-**说明**: Check adoption status of current project
+**说明**: Check file integrity and adoption status (quick validation). For deep health diagnosis, use "uds audit"
 
 **选项**:
 | Option | 说明 |
@@ -91,6 +104,36 @@
 | `--force` | Bypass UDS source-repo self-adoption guard (DEC-044 / XSPEC-071) |
 | `--i18n` | Run i18n lint rules (XSPEC-239) across canonical + locale variants |
 
+### `uds lint`
+
+**说明**: Check spec dependency validity and size against installed specs (specs/*.md)
+
+**选项**:
+| Option | 说明 |
+|--------|-------------|
+| `--json` | Output result in JSON format |
+
+### `uds simulate`
+
+**说明**: Simulate a standard check with input (Predictive Validation)
+
+**选项**:
+| Option | 说明 |
+|--------|-------------|
+| `-s, --standard` | Standard to simulate against |
+| `-i, --input` | Input string to test |
+| `--json` | Output result in JSON format |
+
+### `uds fix`
+
+**说明**: Auto-fix standard violations (Self-Healing)
+
+**选项**:
+| Option | 说明 |
+|--------|-------------|
+| `-s, --standard` | Standard to fix |
+| `--json` | Output result in JSON format |
+
 ### `uds update`
 
 **说明**: Update standards to latest version
@@ -117,9 +160,100 @@
 
 **说明**: List installed Claude Code skills
 
+### `uds audit`
+
+**说明**: Deep health diagnosis with pattern detection and feedback (strategic). For quick file check, use "uds check"
+
+**选项**:
+| Option | 说明 |
+|--------|-------------|
+| `--health` | Health check only |
+| `--patterns` | Pattern detection only |
+| `--friction` | Friction detection only |
+| `--report` | Interactive feedback submission |
+| `--yes` | Submit all findings without interactive selection (CI / non-TTY) |
+| `--dry-run` | Preview report without submitting |
+| `--gh` | Force gh CLI for submission |
+| `--format` | Output format (json) |
+| `--quiet` | Summary only |
+| `--score` | Run multi-dimensional health score analysis |
+| `--self` | Self mode: analyze UDS repo itself (use with --score) |
+| `--save` | Save score snapshot for trend tracking (use with --score) |
+| `--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) |
+
+### `uds deps`
+
+**说明**: Compare the versions you test against the versions your declared ranges resolve to
+
+**选项**:
+| Option | 说明 |
+|--------|-------------|
+| `--path` | Directory containing package.json (default: cwd) |
+| `--json` | Output raw JSON |
+| `--concurrency` | Parallel registry lookups (default: 8) |
+
+### `uds uninstall`
+
+**说明**: Remove UDS standards, integrations, skills, and hooks
+
+**选项**:
+| Option | 说明 |
+|--------|-------------|
+| `--all` | Remove everything including user-level installations |
+| `--standards-only` | Remove only .standards/ directory |
+| `--skills-only` | Remove only skills and commands |
+| `--integrations-only` | Remove only UDS blocks from integration files |
+| `--dry-run` | Preview mode, no files modified |
+| `-y, --yes` | Skip confirmation prompts |
+
+### `uds compile`
+
+**说明**: Compile enforcement standards into hook configurations
+
+**选项**:
+| Option | 说明 |
+|--------|-------------|
+| `--target` | Target platform (claude-code) |
+| `--dry-run` | Preview output without writing files |
+
+### `uds report`
+
+**说明**: Analyze hook telemetry and show adoption report
+
+### `uds release`
+
+**说明**: Manage release process (promote, deploy, manifest, verify)
+
+### `uds spec`
+
+**说明**: Manage lightweight micro-specs for vibe coding. For full spec lifecycle with review, use "/sdd"
+
+**选项**:
+| Option | 说明 |
+|--------|-------------|
+| `-s, --scope` | Scope (frontend, backend, fullstack) |
+| `-o, --output` | Output directory (default: specs/) |
+| `-y, --yes` | Auto-confirm without prompting |
+| `--status` | Filter by status (draft, confirmed, archived) |
+| `-o, --output` | Specs directory (default: specs/) |
+| `-o, --output` | Specs directory (default: specs/) |
+| `-o, --output` | Specs directory (default: specs/) |
+| `-o, --output` | Specs directory (default: specs/) |
+| `-y, --yes` | Skip confirmation |
+| `-o, --output` | Specs directory (default: specs/) |
+| `--archived` | Search only archived specs |
+| `-o, --output` | Specs directory |
+| `-o, --output` | Specs directory |
+
+### `uds quickstart`
+
+**说明**: Interactive workflow guide — find the right commands quickly
+
 ### `uds agent`
 
-**说明**: Manage UDS agents (list, install, info)
+**说明**: Manage UDS agents for AI tools
 
 **选项**:
 | Option | 说明 |
@@ -129,13 +263,17 @@
 | `-g, --global` | Install to user level instead of project level |
 | `-y, --yes` | Skip confirmation prompts |
 
-### `uds workflow`
+### `uds ai-context`
 
-**说明**: Manage UDS workflows (list, install, info, execute, status)
+**说明**: Manage .ai-context.yaml configuration for AI-friendly architecture
 
-### `uds ai-context`
+### `uds mcp`
+
+**说明**: MCP server commands for AI tool integration
+
+### `uds run`
 
-**说明**: Manage AI context configuration (init, validate, graph)
+**说明**: Run a project command by intent (test/lint/build/security) via uds.project.yaml
 
 ---
 
@@ -298,7 +436,7 @@
 | `ai-agreement-standards` | 1.0.0 | This standard formalizes the interaction between Human (Acquirer) and AI (Suppli |
 | `ai-command-behavior` | 1.0.0 | This standard defines a structure for specifying AI Agent runtime behavior in co |
 | `ai-friendly-architecture` | 1.0.0 | This standard defines architecture and documentation practices that maximize the |
-| `ai-instruction-standards` | 1.1.0 | This standard defines best practices for creating and maintaining AI instruction |
+| `ai-instruction-standards` | 1.1.1 | This standard defines best practices for creating and maintaining AI instruction |
 | `ai-response-navigation` | 1.3.0 | This standard defines navigation behavior for AI responses: every substantive AI |
 | `alerting-standards` | 1.0.0 |  |
 | `anti-hallucination` | 1.5.1 | This standard defines strict guidelines for AI assistants to prevent hallucinati |

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

@@ -153,7 +153,7 @@ uds agent list
 uds agent install code-architect
 
 # 安装所有代理
-uds agent install --all
+uds agent install all
 
 # 安装到用户目录（全局）
 uds agent install code-architect --global

package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md

@@ -605,9 +605,19 @@ test.each([
 
 ## CI/CD 整合
 
-### GitHub Actions 范例
+### GitHub Actions —— 目前无法脚本化
+
+`uds reverse-tdd` 这个 CLI 指令不存在。覆盖率缺口分析是以 **`reverse-tdd`
+AI agent**（`uds agent install reverse-tdd`）提供——由你的 AI 工具交互式执行，
+不是会吐出 `coverage.json` 的确定性脚本。本文件先前版本示范了一个调用不存在
+CLI 指令的 GitHub Actions 步骤（XSPEC-383 R4，2026-08-19）。
+
+下方仅为**示意**——展示若未来真的做出可脚本化的分析器，CI 整合可能长什么样，
+不是现在就能贴进 workflow 使用的东西：
 
 ```yaml
+# 示意用途——目前没有可脚本化的等价物。
+# 现况：改用 reverse-tdd agent 从你的 AI 工具交互式执行。
 name: BDD Coverage Check
 
 on: [pull_request]
@@ -618,29 +628,9 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Run BDD Coverage Analysis
-        run: |
-          uds reverse-tdd features/ --output coverage.json
-
-      - name: Check Coverage Threshold
+      - name: Run BDD Coverage Analysis (尚未实现)
         run: |
-          COVERAGE=$(jq '.summary.effectiveCoverage' coverage.json)
-          if (( $(echo "$COVERAGE < 0.80" | bc -l) )); then
-            echo "Coverage $COVERAGE below 80% threshold"
-            exit 1
-          fi
-
-      - name: Comment on PR
-        uses: actions/github-script@v6
-        with:
-          script: |
-            const coverage = require('./coverage.json');
-            github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: `## BDD 覆盖率报告\n\n覆盖率: ${(coverage.summary.effectiveCoverage * 100).toFixed(1)}%`
-            });
+          echo "目前没有 CLI 等价物——交互式用法请见 reverse-tdd agent"
 ```
 
 ---

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

@@ -15,7 +15,11 @@ description: |
 allowed-tools: Read, Write, Grep, Glob
 argument-hint: "[all|bdd|tdd|it|e2e|atdd] <spec-file>"
 prerequisites: ["spec-approved"]
-disable-model-invocation: true
+# 2026-08-18: `disable-model-invocation: true` 已移除,與英文來源同步。
+# 這一份是唯一在 locale 包裡自帶該旗標的 skill。
+# 英文來源移除它並不會讓這裡消失——frontmatter 合併只併入「英文有的欄位」,
+# 所以一個英文已經沒有的欄位,在 locale 檔裡會原封不動地留下來並照樣出貨。
+# (XSPEC-378 R5)
 ---
 
 # 正向推演

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

@@ -164,18 +164,9 @@ steps:
 
 ## 用法
 
-### CLI 安装
+### 获取 Workflows
 
-```bash
-# List available workflows
-uds workflow list
-
-# Install specific workflow
-uds workflow install integrated-flow
-
-# Install all workflows
-uds workflow install --all
-```
+`uds workflow` 已于 v6.0.0 移除（流程编排职责移至采用层——DEC-049；见 [MIGRATION-v6.md §3](../../../../docs/MIGRATION-v6.md#3-removed-4-deprecated-cli-commands)）。没有 CLI 安装步骤：workflow 定义直接存放在本 repo 的 `skills/workflows/*.workflow.yaml`（见上方表格），请直接引用路径或复制到项目的 `.claude/workflows/`。
 
 ### 执行