universal-dev-standards 6.7.5 → 6.9.0

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

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

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

@@ -1,7 +1,7 @@
 # UDS 功能参考手册
 
 > Universal Development Standards - 完整功能文档
-> Auto-generated | Last updated: 2026-08-17
+> Auto-generated | Last updated: 2026-09-14
 
 **Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | [繁體中文](../../zh-TW/docs/FEATURE-REFERENCE.md) | 简体中文
 
@@ -9,15 +9,15 @@
 
 ## 目录
 
-1. [CLI 指令](#cli-commands) (9)
+1. [CLI 指令](#cli-commands) (23)
 2. [斜线命令](#slash-commands) (51)
 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: 329**
+**Total Features: 350**
 
 ---
 
@@ -49,18 +49,31 @@
 | `--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) |
 | `--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
@@ -110,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 |
 
@@ -117,9 +161,102 @@
 
 **说明**: 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) |
+| `--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`
+
+**说明**: 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 +266,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
 
 ---
 
@@ -287,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 |
@@ -298,7 +439,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 |
@@ -318,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` | - |  |
@@ -331,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 |  |
@@ -345,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` | - |  |
@@ -355,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` | - |  |
@@ -394,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 |  |
@@ -413,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 |  |
@@ -429,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 |
@@ -452,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 |
@@ -461,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 |
@@ -474,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 |
@@ -485,7 +631,9 @@
 | `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
 | `fix-manifest-paths.ps1` | Fix Manifest Paths |
 | `fix-manifest-paths.sh` | Manifest Path Fixer |
+| `generate-adoption-skills.mjs` | Self-Adoption Skill Copy Generator and Drift Gate — XSPEC-385 |
 | `generate-docs.mjs` | Look up the release date for `version` from CHANGELOG.md's own |
+| `generate-llms-txt.mjs` | llms.txt Generator and Drift Gate — XSPEC-385 |
 | `generate-locale-coverage.mjs` | Locale Coverage Generator |
 | `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9, AC-14) |
 | `install-hooks.mjs` | Install Hooks |

package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md

@@ -58,7 +58,6 @@ status: current
 
 **配置方式**：
 - 安裝时选择 `standardsScope: full` + Skills 安裝
-- 或透過 `contentMode: full` 獲得完整规范
 
 **包含内容**：
 - 16 个 Claude Code Skills
@@ -212,7 +211,7 @@ uds init -y --skills-location marketplace --content-mode index
 
 **配置方式**：
 ```bash
-uds init -y --skills-location none --content-mode full
+uds init -y --skills-location none --content-mode index
 ```
 
 ### 場景 4：学习 UDS 标准体系

package/bundled/locales/zh-CN/integrations/google-antigravity/{INSTRUCTIONS.md → AGENTS.md}

@@ -1,5 +1,5 @@
 ---
-source: ../../../../integrations/google-antigravity/INSTRUCTIONS.md
+source: ../../../../integrations/google-antigravity/AGENTS.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-13

package/bundled/locales/zh-CN/integrations/google-antigravity/README.md

@@ -19,7 +19,7 @@ Google Antigravity 是一个先进的代理程序代码开发助理。此集成
 - **[.antigravity/rules.md](../../../../integrations/google-antigravity/.antigravity/rules.md)**（推荐）：
   项目级规则文件，Antigravity 会自动加载。
 
-- **[INSTRUCTIONS.md](./INSTRUCTIONS.md)**：
+- **[AGENTS.md](./AGENTS.md)**：
   用于手动配置的系统提示词片段。
 
 ## 规则配置
@@ -53,7 +53,7 @@ curl -o .antigravity/rules.md https://raw.githubusercontent.com/AsiaOstrich/univ
    确保 `core/` 规范已复制到您的项目（例如 `.standards/`）。
 
 2. **配置代理**：
-   将 `INSTRUCTIONS.md` 的内容复制到您的 Antigravity「用户规则」或特定任务指令中。
+   将 `AGENTS.md` 的内容复制到您的 Antigravity「用户规则」或特定任务指令中。
 
 ### 验证合规性
 
@@ -65,7 +65,7 @@ curl -o .antigravity/rules.md https://raw.githubusercontent.com/AsiaOstrich/univ
 
 - [防幻觉规范](../../../../core/anti-hallucination.md)
 - [Commit 消息指南](../../../../core/commit-message-guide.md)
-- [INSTRUCTIONS.md](./INSTRUCTIONS.md)
+- [AGENTS.md](./AGENTS.md)
 
 ---
 

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

@@ -77,5 +77,7 @@ So that [benefit].
 
 ## 参考
 
+- [验收标准撰写指南](./acceptance-criteria-guide.md) — 要撰写或审查验收标准时读它。
+- [ATDD 工作流程指南](./atdd-workflow.md) — 要完整跑一轮 ATDD 循环时读它。
 - 详细指南：[guide.md](./guide.md)
 - 核心规范：[acceptance-test-driven-development.md](../../../../core/acceptance-test-driven-development.md)

package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md

@@ -74,5 +74,7 @@ Feature: User Login
 
 ## 参考
 
+- [BDD 工作流程指南](./bdd-workflow.md) — 要把探索、制定、自动化当一个循环跑时读它。
+- [Gherkin 快速参考指南](./gherkin-guide.md) — 要写 Given／When／Then 而需要确切语法时读它。
 - 详细指南：[guide.md](./guide.md)
 - 核心规范：[behavior-driven-development.md](../../../../core/behavior-driven-development.md)