universal-dev-standards 5.0.0-rc.8 → 5.0.0

package/bundled/locales/zh-CN/skills/commands/config.md

@@ -0,0 +1,207 @@
+---
+source: ../../../../skills/commands/config.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Configure project development standards
+allowed-tools: Read, Bash(uds config:*), Bash(uds configure:*), Bash(uds check:*)
+argument-hint: "[type] [--ai-tool <tool>]"
+---
+
+# 配置标准
+
+配置当前专案的 Universal Development Standards 设定。
+
+## 互动模式（默认）
+
+当不指定类型时，使用 AskUserQuestion 询问要配置什么。
+
+### 步骤 0：显示当前状态
+
+首先，执行 `uds check --summary` 显示当前安装状态。
+
+```bash
+uds check --summary
+```
+
+这帮助用户在修改前了解当前的配置。
+
+### 步骤 1：询问配置类型
+
+使用 AskUserQuestion 提供以下选项：
+
+| 类别 | 选项 |
+|------|------|
+| **基本选项** | Format, Git Workflow, Merge Strategy, Commit Language, Test Levels |
+| **AI 工具** | 添加或移除 AI 工具集成 |
+| **Skills** | 管理 Skills 安装（安装/更新/重新安装已拒绝的） |
+| **Commands** | 管理 Commands 安装 |
+| **进阶** | Adoption Level, Content Mode |
+| **全部** | 配置所有选项 |
+
+### 步骤 2：根据选择执行
+
+**如果选择 AI 工具：**
+```bash
+uds configure --type ai_tools
+```
+
+**如果选择 Skills：**
+```bash
+uds configure --type skills
+```
+
+**如果选择 Commands：**
+```bash
+uds configure --type commands
+```
+
+**如果选择 Adoption Level：**
+```bash
+uds configure --type level
+```
+
+**如果选择 Content Mode：**
+```bash
+uds configure --type content_mode
+```
+
+## 快速模式
+
+指定类型时，跳过互动式问题：
+
+```bash
+/config ai_tools      # Directly configure AI tools
+/config skills        # Directly manage Skills
+/config commands      # Directly manage Commands
+/config level         # Directly configure adoption level
+/config content_mode  # Directly configure content mode
+```
+
+### 非互动式安装
+
+使用 `--ai-tool` 选项为特定工具安装 Skills/Commands，无需提示：
+
+```bash
+# Install Skills for specific tool (project level, default)
+uds configure --type skills --ai-tool opencode
+
+# Install Skills for specific tool (user level)
+uds configure --type skills --ai-tool opencode --skills-location user
+
+# Install Skills for specific tool (project level, explicit)
+uds configure --type skills --ai-tool claude-code --skills-location project
+
+# Install Commands for specific tool
+uds configure --type commands --ai-tool copilot
+```
+
+**Skills 位置选项：**
+
+| 选项 | 路径 | 说明 |
+|------|------|------|
+| `project` | `.claude/skills/`, `.opencode/skill/` | 专案级别（默认） |
+| `user` | `~/.claude/skills/`, `~/.opencode/skill/` | 跨所有专案共享 |
+
+## 配置类型
+
+| 类型 | 说明 |
+|------|------|
+| `ai_tools` | AI 工具集成 |
+| `skills` | Skills 安装管理 |
+| `commands` | Commands 安装管理 |
+| `level` | 采用等级 (1/2/3) |
+| `content_mode` | 集成文件内容模式 |
+| `format` | AI/人类文档格式 |
+| `workflow` | Git 工作流程策略 |
+| `merge_strategy` | 合并策略 |
+| `commit_language` | 提交消息语言 |
+| `test_levels` | 测试层级 |
+| `methodology` | 开发方法论（实验性，需要 -E） |
+| `all` | 配置所有选项 |
+
+## Skills 配置
+
+选择 `skills` 类型时，CLI 显示：
+
+1. **当前状态** - 显示每个 AI 工具已安装的 Skills
+2. **已拒绝状态** - 显示用户之前拒绝 Skills 的工具
+3. **操作菜单**：
+   - 安装/更新 Skills
+   - 重新安装已拒绝的 Skills
+   - 仅查看状态
+
+```
+Current Skills status:
+  ✓ Claude Code:
+    - User: v3.5.1
+  ○ OpenCode: Not installed
+  ⊘ Copilot: Previously declined
+
+? What would you like to do?
+❯ Install/Update Skills
+  Reinstall declined Skills
+  View status only
+  Cancel
+```
+
+## Commands 配置
+
+选择 `commands` 类型时，CLI 显示：
+
+1. **当前状态** - 显示每个支持工具已安装的 Commands
+2. **已拒绝状态** - 显示用户之前拒绝 Commands 的工具
+3. **操作菜单** 类似 Skills
+
+支持 Commands 的工具：
+- OpenCode (`.opencode/commands/`)
+- GitHub Copilot (`.github/commands/`)
+- Gemini CLI (`.gemini/commands/`)
+- Roo Code (`.roo-code/commands/`)
+
+## 内容模式选项
+
+| 模式 | 说明 |
+|------|------|
+| `standard` | 摘要 + 任务映射，AI 知道何时读取哪个标准（推荐） |
+| `full` | 在集成文件中完整嵌入所有标准 |
+| `minimal` | 仅嵌入核心规则 |
+
+## 配置变更的影响
+
+| 配置 | 影响 |
+|------|------|
+| AI 工具（添加） | 生成新的集成文件 |
+| AI 工具（移除） | 删除集成文件 |
+| Skills | 安装/更新 Skills 到配置路径 |
+| Commands | 安装/更新 Commands 到配置路径 |
+| 等级 | 更新标准，重新生成集成 |
+| 内容模式 | 重新生成所有集成文件 |
+
+## 已拒绝的功能
+
+CLI 在 `manifest.declinedFeatures` 中追踪已拒绝的 Skills/Commands：
+
+- 之前拒绝的工具不会在 `/update` 提示中出现
+- 使用 `/config skills` 或 `/config commands` 重新安装已拒绝的功能
+- 从菜单中选择"重新安装已拒绝的 Skills/Commands"
+
+## 选项参考
+
+| 选项 | 说明 |
+|------|------|
+| `--type <type>` | 配置类型 |
+| `--ai-tool <tool>` | 特定 AI 工具（非互动式） |
+| `--skills-location <loc>` | Skills 安装位置: project, user |
+| `--yes`, `-y` | 跳过确认提示 |
+| `-E`, `--experimental` | 启用实验性功能 |
+
+## 参考
+
+- CLI 文档: `uds configure --help`
+- 初始化命令: [/init](./init.md)
+- 检查命令: [/check](./check.md)
+- 更新命令: [/update](./update.md)

package/bundled/locales/zh-CN/skills/commands/coverage.md

@@ -0,0 +1,74 @@
+---
+source: ../../../../skills/commands/coverage.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Analyze test coverage and provide recommendations
+allowed-tools: Read, Grep, Glob, Bash(npm run test:coverage:*), Bash(npx:*)
+argument-hint: "[要分析的文件或模组 | file or module to analyze]"
+---
+
+# 测试覆盖率助手
+
+多维度分析测试覆盖率并提供可执行的建议。
+
+## 覆盖率维度
+
+| 维度 | 测量内容 |
+|------|----------|
+| **Line** | 执行的行数 |
+| **Branch** | 决策路径 |
+| **Function** | 调用的函数 |
+| **Statement** | 执行的语句 |
+
+## 八维度框架
+
+1. **代码覆盖率** - 行、分支、函数
+2. **需求覆盖率** - 所有需求已测试
+3. **风险覆盖率** - 高风险区域已测试
+4. **集成覆盖率** - 组件间交互
+5. **边界情况覆盖率** - 边界条件
+6. **错误覆盖率** - 错误处理路径
+7. **权限覆盖率** - 访问控制场景
+8. **AI 生成品质** - AI 生成测试的有效性
+
+## 工作流程
+
+1. **运行覆盖率工具** - 生成覆盖率报告
+2. **分析缺口** - 识别未测试区域
+3. **优先排序** - 按风险和重要性排序
+4. **建议测试** - 建议需要添加的具体测试
+5. **追踪进度** - 随时间监控覆盖率
+
+## 覆盖率目标
+
+| 等级 | 覆盖率 | 使用场景 |
+|------|--------|----------|
+| 最低 | 60% | 遗留代码 |
+| 标准 | 80% | 大多数专案 |
+| 高 | 90% | 关键系统 |
+| 关键 | 95%+ | 安全关键 |
+
+## 使用方式
+
+- `/coverage` - 运行完整覆盖率分析
+- `/coverage src/auth` - 分析特定模组
+- `/coverage --recommend` - 获取测试建议
+
+## AC 覆盖率（需求层级）
+
+本命令（`/coverage`）分析**代码层级**覆盖率（行/分支/函数）。若需**需求层级**覆盖率 — 追踪哪些 AC 有对应测试 — 请使用 [`/ac-coverage`](./ac-coverage.md)。
+
+| | `/coverage` | `/ac-coverage` |
+|-|-------------|----------------|
+| **层级** | 代码（行/分支/函数） | 需求（AC 到测试） |
+| **问题** | "有多少代码被测试了？" | "哪些 AC 有测试？" |
+
+## 参考
+
+- 完整规范: [test-coverage-assistant](../test-coverage-assistant/SKILL.md)
+- 核心指南: [testing-standards](../../core/testing-standards.md)
+- AC 覆盖率: [/ac-coverage](./ac-coverage.md) — 需求层级追踪

package/bundled/locales/zh-CN/skills/commands/database.md

@@ -0,0 +1,78 @@
+---
+source: ../../../../skills/commands/database.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide database design, migration planning and query optimization"
+allowed-tools: Read, Grep, Glob
+argument-hint: "[schema or migration to review | 要审查的 schema 或迁移]"
+---
+
+# Database Assistant | 数据库助手
+
+Guide database design, migration planning and query optimization.
+
+引导数据库设计、迁移规划和查询优化。
+
+## Workflow | 工作流程
+
+```
+PLAN ──► WRITE ──► TEST ──► DEPLOY ──► VERIFY
+```
+
+## Usage | 使用方式
+
+- `/database` - 启动交互式数据库设计
+- `/database schema` - 审查或设计 schema
+- `/database --migration` - 规划迁移
+
+## AI Agent Behavior | AI 代理行为
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 进入路由
+
+| 输入 | AI 动作 |
+|------|---------|
+| `/database` | 询问任务类型（schema 设计 / 迁移规划 / 查询优化） |
+| `/database schema` | 进入 schema 设计/审查模式 |
+| `/database --migration` | 进入迁移规划模式 |
+
+### Interaction Script | 交互脚本
+
+1. 确认任务类型和目标
+2. 分析现有 schema 或迁移文件
+
+**Decision: 任务类型**
+- IF schema 设计 → 引导规范化、索引设计、关联定义
+- IF 迁移规划 → 评估风险、生成迁移脚本、规划回滚
+- IF 查询优化 → 分析慢查询、建议索引
+
+3. 展示设计/计划结果
+
+**STOP**: 结果展示后等待用户确认
+
+**STOP**: 迁移脚本写入前等待用户确认
+
+### Stop Points | 停止点
+
+| 停止点 | 等待内容 |
+|--------|---------|
+| 设计/计划展示后 | 确认方案 |
+| 迁移脚本生成后 | 确认写入 |
+
+### Error Handling | 错误处理
+
+| 错误条件 | AI 动作 |
+|----------|---------|
+| 无法检测数据库类型 | 询问用户（PostgreSQL/MySQL/MongoDB 等） |
+| 迁移存在数据丢失风险 | 明确警告，要求用户确认 |
+
+## Reference | 参考
+
+- Full standard: [database-assistant](../database-assistant/SKILL.md)
+- Core guide: [database-standards](../../core/database-standards.md)

package/bundled/locales/zh-CN/skills/commands/derive-all.md

@@ -0,0 +1,58 @@
+---
+source: ../../../../skills/commands/derive-all.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Derive all test structures (BDD, TDD, ATDD) from SDD specification
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[规格文件路径 | spec file path]"
+---
+
+# /derive-all — 完整正向推演
+
+从已核准的 SDD 规格推演所有测试结构（BDD + TDD + 可选 ATDD）。
+
+## 工作流程
+
+```
+SPEC-XXX.md ──► /derive-bdd ──► /derive-tdd ──► [/derive-atdd] ──► Report
+```
+
+1. **解析** SDD 规格并验证其已核准
+2. **运行** `/derive-bdd` 生成 Gherkin 场景
+3. **运行** `/derive-tdd` 生成测试骨架
+4. **可选** 运行 `/derive-atdd` 生成验收测试表格
+5. **生成** `DERIVATION-REPORT.md` 汇总所有输出
+
+## 输出文件
+
+| 文件 | 内容 |
+|------|------|
+| `features/SPEC-XXX.feature` | BDD Gherkin 场景 |
+| `tests/SPEC-XXX.test.ts` | TDD 测试骨架 |
+| `DERIVATION-REPORT.md` | 摘要与统计 |
+
+## 使用方式
+
+| 命令 | 用途 |
+|------|------|
+| `/derive-all specs/SPEC-001.md` | 从规格完整推演 |
+| `/derive-all` | 互动式 — 询问规格文件 |
+
+## 典型 SDD 工作流程
+
+```bash
+/sdd user-authentication          # Step 1: Create spec
+/sdd review specs/SPEC-001.md     # Step 2: Review
+/derive-all specs/SPEC-001.md     # Step 3: Derive tests
+# Step 4: Implement — fill [TODO] markers
+```
+
+## 参考
+
+- 父命令: [/derive](../forward-derivation/SKILL.md)
+- 核心规范: [forward-derivation-standards.md](../../core/forward-derivation-standards.md)
+- 子命令: [/derive-bdd](./derive-bdd.md), [/derive-tdd](./derive-tdd.md), [/derive-atdd](./derive-atdd.md)

package/bundled/locales/zh-CN/skills/commands/derive-atdd.md

@@ -0,0 +1,54 @@
+---
+source: ../../../../skills/commands/derive-atdd.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Derive ATDD acceptance tests from SDD specification
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[规格文件路径 | spec file path]"
+---
+
+# /derive-atdd — 推演 ATDD 验收测试
+
+从已核准的 SDD 规格文档推演 ATDD 验收测试表格。
+
+## 工作流程
+
+```
+SPEC-XXX.md ──► Parse AC ──► Generate acceptance.md ──► Review
+```
+
+1. **读取** SDD 规格并提取验收条件
+2. **映射** 每个 AC 到验收测试表格（Given-When-Then 列）
+3. **生成** `acceptance.md`，包含测试数据和预期结果
+4. **输出** 推演摘要
+
+## 输出格式
+
+```markdown
+# Acceptance Tests: SPEC-001
+
+## AC-1: [Description]
+
+| # | Given | When | Then | Status |
+|---|-------|------|------|--------|
+| 1 | [precondition] | [action] | [expected] | ⬜ |
+| 2 | [precondition] | [action] | [expected] | ⬜ |
+```
+
+## 使用方式
+
+| 命令 | 用途 |
+|------|------|
+| `/derive-atdd specs/SPEC-001.md` | 从特定规格推演 ATDD |
+| `/derive-atdd` | 互动式 — 询问规格文件 |
+
+> **注意**: BDD 场景已经作为可执行的验收测试。`/derive-atdd` 适用于专门的手动测试工作流程。
+
+## 参考
+
+- 父命令: [/derive](../forward-derivation/SKILL.md)
+- 核心规范: [forward-derivation-standards.md](../../core/forward-derivation-standards.md)

package/bundled/locales/zh-CN/skills/commands/derive-bdd.md

@@ -0,0 +1,53 @@
+---
+source: ../../../../skills/commands/derive-bdd.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+status: current
+---
+
+---
+description: [UDS] Derive BDD Gherkin scenarios from SDD specification
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[spec file path | 规格文件路径]"
+---
+
+# /derive-bdd — 推演 BDD 场景
+
+从已核准的 SDD 规格文件推演 Gherkin `.feature` 文件。
+
+## 工作流程
+
+```
+SPEC-XXX.md ──► Parse AC ──► Generate .feature ──► Review
+```
+
+1. **读取** SDD 规格并提取验收标准
+2. **映射** 每个 AC 到一个 Gherkin Scenario（1:1）
+3. **生成** `.feature` 文件，包含 `@SPEC-XXX` 和 `@AC-N` 标签
+4. **输出** 推演摘要
+
+## 输出格式
+
+```gherkin
+@SPEC-001
+Feature: [Feature Name]
+
+  @AC-1
+  Scenario: [AC-1 description]
+    Given [context]
+    When [action]
+    Then [expected result]
+```
+
+## 使用方式
+
+| Command | Purpose | 用途 |
+|---------|---------|------|
+| `/derive-bdd specs/SPEC-001.md` | Derive BDD from specific spec | 从特定规格推演 BDD |
+| `/derive-bdd` | Interactive — ask for spec file | 互动式 — 询问规格文件 |
+
+## 参考
+
+- 父命令: [/derive](../forward-derivation/SKILL.md)
+- 核心规范: [forward-derivation-standards.md](../../core/forward-derivation-standards.md)

package/bundled/locales/zh-CN/skills/commands/derive-tdd.md

@@ -0,0 +1,54 @@
+---
+source: ../../../../skills/commands/derive-tdd.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+status: current
+---
+
+---
+description: [UDS] Derive TDD test skeletons from SDD specification
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[spec file path | 规格文件路径]"
+---
+
+# /derive-tdd — 推演 TDD 测试骨架
+
+从已核准的 SDD 规格文件推演测试骨架文件。
+
+## 工作流程
+
+```
+SPEC-XXX.md ──► Parse AC ──► Generate .test.ts ──► Review
+```
+
+1. **读取** SDD 规格并提取验收标准
+2. **映射** 每个 AC 到一个 `describe`/`it` 区块，采用 AAA 模式
+3. **生成** 测试文件，包含 `[TODO]` 标记供实作填入
+4. **输出** 推演摘要
+
+## 输出格式
+
+```typescript
+describe('SPEC-001: [Feature Name]', () => {
+  describe('AC-1: [AC description]', () => {
+    it('should [expected behavior]', () => {
+      // Arrange — [TODO]
+      // Act — [TODO]
+      // Assert — [TODO]
+    });
+  });
+});
+```
+
+## 使用方式
+
+| Command | Purpose | 用途 |
+|---------|---------|------|
+| `/derive-tdd specs/SPEC-001.md` | Derive TDD from specific spec | 从特定规格推演 TDD |
+| `/derive-tdd` | Interactive — ask for spec file | 互动式 — 询问规格文件 |
+
+## 参考
+
+- 父命令: [/derive](../forward-derivation/SKILL.md)
+- 核心规范: [forward-derivation-standards.md](../../core/forward-derivation-standards.md)

package/bundled/locales/zh-CN/skills/commands/derive.md

@@ -0,0 +1,78 @@
+---
+source: ../../../../skills/commands/derive.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+status: current
+---
+
+---
+name: derive
+description: [UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables from specifications.
+argument-hint: "[all|bdd|tdd|atdd] <spec-file> [--lang <lang>] [--framework <fw>] [--output-dir <dir>]"
+---
+
+# 推演测试结构
+
+从已批准的 SDD 规格生成衍生产物（BDD 场景、TDD 骨架、ATDD 表格）。
+
+## 用法
+
+```bash
+/derive [subcommand] <spec-file> [options]
+```
+
+### 子命令
+
+| Subcommand | Description | Output |
+|------------|-------------|--------|
+| `all` | 生成 BDD + TDD（默认） | `.feature` + `.test.*` |
+| `bdd` | 仅生成 BDD 场景 | `.feature` |
+| `tdd` | 仅生成 TDD 骨架 | `.test.*` |
+| `atdd` | 生成 ATDD 测试表格 | `.md`（Markdown 表格） |
+
+### 选项
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--lang` | 目标语言（ts, python 等） | 自动检测或 `ts` |
+| `--framework` | 测试框架（vitest, pytest 等） | 自动检测或 `vitest` |
+| `--output-dir` | 输出目录 | `./generated` |
+| `--dry-run` | 预览输出而不写入文件 | `false` |
+
+## 工作流程
+
+1.  **读取规格**: 分析输入的 `SPEC-XXX.md` 文件。
+2.  **提取 AC**: 解析所有验收标准。
+3.  **生成产物**:
+    *   **BDD**: 将 AC 转换为 Gherkin `Scenario` 格式。
+    *   **TDD**: 创建包含 `describe`/`it` 区块的测试文件骨架，与 AC 对应。
+    *   **ATDD**: 创建包含输入/输出/通过-失败列的 Markdown 表格。
+4.  **验证**: 确保 AC 与生成项目之间为 1:1 映射。
+
+## 防幻觉
+
+*   **1:1 映射**: 每个 AC 必须恰好对应一个测试/场景。
+*   **可追溯性**: 所有生成的产物必须引用来源规格 ID 和 AC ID。
+*   **禁止捏造**: 不得添加规格中不存在的场景。
+
+## 范例
+
+```bash
+# 推演所有产物（BDD + TDD）
+/derive all specs/SPEC-001.md
+
+# 仅推演 BDD 场景
+/derive bdd specs/SPEC-001.md
+
+# 为 Python 推演 TDD
+/derive tdd specs/SPEC-001.md --lang python --framework pytest
+
+# 推演 ATDD 表格供手动测试
+/derive atdd specs/SPEC-001.md
+```
+
+## 参考
+
+*   [正向推演规范](../forward-derivation/SKILL.md)
+*   [核心规范](../../core/forward-derivation-standards.md)