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

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

@@ -0,0 +1,272 @@
+---
+source: ../../../../skills/commands/init.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+status: current
+---
+
+---
+description: [UDS] Initialize development standards in current project
+allowed-tools: Read, Bash(uds init:*), Bash(npx:*)
+argument-hint: "[--level N | --yes]"
+---
+
+# 初始化标准
+
+在当前专案初始化 Universal Development Standards。
+
+## 互动模式（默认）
+
+当不带 `--yes` 执行时，使用 AskUserQuestion 询问用户偏好后再执行。
+
+### 步骤 1：检测专案
+
+首先，CLI 会自动检测专案特性：
+- 语言（JavaScript、TypeScript、Python、Go 等）
+- 框架（React、Vue、Express 等）
+- AI 工具（Claude Code、Cursor、Copilot 等）
+
+### 步骤 2：询问 AI 工具选择
+
+使用 AskUserQuestion（多选）询问要配置哪些 AI 工具：
+
+| AI Tool | Integration File | Skills Support | Commands Support |
+|---------|-----------------|----------------|------------------|
+| **Claude Code** | `CLAUDE.md` | ✅ | ❌ |
+| **Cursor** | `.cursorrules` | ✅ | ❌ |
+| **Windsurf** | `.windsurfrules` | ✅ | ❌ |
+| **Cline** | `.clinerules` | ✅ | ❌ |
+| **GitHub Copilot** | `.github/copilot-instructions.md` | ✅ | ✅ |
+| **OpenCode** | `AGENTS.md` | ✅ | ✅ |
+| **Gemini CLI** | `GEMINI.md` | ✅ | ✅ |
+| **Codex** | `AGENTS.md` | ✅ | ❌ |
+| **Antigravity** | `INSTRUCTIONS.md` | ✅ | ❌ |
+
+预选环境中检测到的工具。注意：Codex 和 OpenCode 共用 `AGENTS.md`。
+
+### 步骤 3：询问 Skills 安装
+
+对于支持 Skills 的工具，根据工具数量使用**智能分组**策略。
+
+**重要：AskUserQuestion 最多只能有 4 个选项。** 使用智能分组来处理。
+
+#### 策略 A：1-2 个工具 → 合并询问
+
+**范例（仅 Claude Code）：**
+```
+Question: "Skills 要安装到哪里？"
+Options:
+1. Plugin Marketplace（建议）- 自动更新，易于管理
+2. User Level (~/.claude/skills/) - 所有专案共用
+3. Project Level (.claude/skills/) - 仅此专案
+4. 跳过 - 不安装 Skills
+```
+
+**范例（Claude Code + OpenCode）：**
+```
+Question: "Skills 要安装到哪里？"
+Options:
+1. Plugin Marketplace + OpenCode Project Level（建议）
+2. 全部 User Level - 所有专案共用
+3. 全部 Project Level - 仅此专案
+4. 跳过 - 不安装 Skills
+```
+
+#### 策略 B：3+ 个工具 → 两阶段询问
+
+**阶段 1：询问统一或个别**
+```
+Question: "您选择了 3 个以上的 AI 工具，Skills 安装层级要如何设定？"
+Options:
+1. 统一层级（建议）- 所有工具使用相同层级
+2. 个别设定 - 为每个工具分别选择层级
+3. 跳过 - 不安装 Skills
+```
+
+**阶段 2a：如果统一 → 询问一次层级**
+```
+Question: "所有 Skills 要安装到哪个层级？"
+Options:
+1. User Level - 所有专案共用
+2. Project Level（建议）- 仅此专案
+```
+注意：Claude Code 默认使用 Plugin Marketplace；仅其他工具使用所选层级。
+
+**阶段 2b：如果个别 → 逐工具询问**
+为每个工具分别询问（参见策略 A 范例）。
+
+### 步骤 4：询问 Commands 安装
+
+对于支持 Commands 的工具（OpenCode、Copilot、Gemini CLI），使用**智能分组**策略。
+
+**重要：AskUserQuestion 最多只能有 4 个选项。** 使用智能分组来处理。
+
+#### 策略 A：1-2 个工具 → 合并询问
+
+**范例（仅 OpenCode）：**
+```
+Question: "Commands 要安装到哪里？"
+Options:
+1. User Level (~/.config/opencode/command/) - 所有专案共用
+2. Project Level (.opencode/command/) - 仅此专案（建议）
+3. 跳过 - 使用 Skills 即可
+```
+
+**范例（OpenCode + Copilot）：**
+```
+Question: "Commands 要安装到哪里？"
+Options:
+1. 全部 User Level - 所有专案共用
+2. 全部 Project Level（建议）- 仅此专案
+3. 跳过 - 使用 Skills 即可
+```
+
+#### 策略 B：3+ 个工具 → 两阶段询问
+
+**阶段 1：询问统一或个别**
+```
+Question: "您选择了多个支持 Commands 的 AI 工具，安装层级要如何设定？"
+Options:
+1. 统一层级（建议）- 所有工具使用相同层级
+2. 个别设定 - 为每个工具分别选择层级
+3. 跳过 - 不安装 Commands
+```
+
+**阶段 2a：如果统一 → 询问一次层级**
+```
+Question: "所有 Commands 要安装到哪个层级？"
+Options:
+1. User Level - 所有专案共用
+2. Project Level（建议）- 仅此专案
+```
+
+**阶段 2b：如果个别 → 逐工具询问**
+为每个工具分别询问（参见策略 A 范例）。
+
+### 步骤 5：询问标准范围
+
+使用 AskUserQuestion（仅在安装 Skills 时显示）：
+
+| 选项 | 说明 |
+|------|------|
+| **精简（建议）** | 仅参考文档，Skills 提供实时任务指导 |
+| **完整** | 安装所有标准文件，独立于 Skills |
+
+### 步骤 6：询问采用层级
+
+使用 AskUserQuestion：
+
+| 选项 | 说明 |
+|------|------|
+| **Level 1：入门** | 6 个核心标准：commit、反幻觉、checkin 等 |
+| **Level 2：专业（建议）** | 增加测试、Git 工作流、错误处理 — 共 12 个 |
+| **Level 3：完整** | 包含版本管理、日志、SDD — 全部 16 个标准 |
+
+### 步骤 7：询问标准格式
+
+使用 AskUserQuestion：
+
+| 选项 | 说明 |
+|------|------|
+| **AI（精简）** | 为 AI 消费优化（建议） |
+| **人类（详细）** | 人类可读格式 |
+| **两者** | 同时生成两种格式 |
+
+### 步骤 8：询问标准选项
+
+根据采用层级，询问：
+- **Git 工作流**: github-flow、gitflow、trunk-based
+- **合并策略**: squash、merge、rebase
+- **提交语言**: english、traditional-chinese、bilingual
+- **测试层级**: unit-testing、integration-testing、e2e-testing
+
+### 步骤 9：询问语言扩展
+
+如果检测到语言，询问是否包含特定语言标准：
+- C# Style Guide
+- PHP Style Guide
+- 等
+
+### 步骤 10：询问框架扩展
+
+如果检测到框架，询问是否包含特定框架模式：
+- Fat-Free Patterns
+- 等
+
+### 步骤 11：询问地区设定
+
+使用 AskUserQuestion：
+
+| 选项 | 说明 |
+|------|------|
+| **English（默认）** | 英文文档 |
+| **Traditional Chinese** | 繁体中文文档 |
+
+### 步骤 12：询问内容模式
+
+使用 AskUserQuestion 设定整合文件内容：
+
+| 选项 | 说明 |
+|------|------|
+| **标准（建议）** | 摘要 + 任务映射，AI 知道何时读取哪个标准 |
+| **完整嵌入** | 嵌入所有规则，AI 可立即使用但文件较大 |
+| **最简** | 仅文件引用，搭配 Skills 使用最佳 |
+
+### 步骤 13：确认并执行
+
+显示配置摘要并在执行前确认。
+
+确认后，CLI 一次性执行所有安装：
+- 将标准复制到 `.standards/`
+- 生成整合文件
+- 安装 Skills（如果已选择）
+- 安装 Commands（如果已选择）
+- 创建 `manifest.json`
+
+## 快速模式
+
+当带有 `--yes` 或特定选项执行时，跳过互动询问：
+
+```bash
+/init --yes                    # 使用所有默认值
+/init --level 2 --yes          # 指定层级并使用默认值
+/init --skills-location none   # 不安装 Skills
+/init --content-mode standard  # 指定内容模式
+```
+
+## 选项参考
+
+| Option | Description | 说明 |
+|--------|-------------|------|
+| `--yes`, `-y` | Non-interactive mode | 非互动模式 |
+| `--level N` | Adoption level (1, 2, or 3) | 采用层级 |
+| `--skills-location` | marketplace, user, project, or none | Skills 位置 |
+| `--content-mode` | standard, full, or minimal | 内容模式 |
+| `--format` | ai, human, or both | 格式 |
+| `-E`, `--experimental` | Enable experimental features (methodology) | 启用实验性功能 |
+
+详见 `uds init --help` 获取所有选项。
+
+## 采用层级
+
+| Level | Name | Standards Count | Description | 说明 |
+|-------|------|-----------------|-------------|------|
+| 1 | Starter | 6 | Core standards for small projects | 核心标准（小型专案） |
+| 2 | Professional | 12 | Adds testing, Git workflow, error handling | 团队专业质量标准 |
+| 3 | Complete | 16 | All 16 standards including SDD | 完整的 16 项标准 |
+
+## 安装内容
+
+- `.standards/` 目录包含核心标准
+- 整合文件（`CLAUDE.md`、`.cursorrules` 等）
+- Skills（通过 Plugin Marketplace 或本地安装）
+- Commands（针对支持的 AI 工具）
+- `manifest.json` 用于追踪安装
+
+## 参考
+
+- CLI 文档: `uds init --help`
+- 采用指南: [ADOPTION-GUIDE.md](../../adoption/ADOPTION-GUIDE.md)
+- 检查命令: [/check](./check.md)
+- 更新命令: [/update](./update.md)

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

@@ -7,7 +7,7 @@ status: experimental
 ---
 
 ---
-description: 管理开发方法論工作流 | Manage development methodology workflow
+description: [UDS] Manage development methodology workflow
 allowed-tools: Read, Write, Glob, Grep, Bash(git:*)
 argument-hint: "[action] [argument]"
 status: experimental

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

@@ -0,0 +1,73 @@
+---
+source: ../../../../skills/commands/metrics.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Track development metrics, code quality indicators and project health"
+allowed-tools: Read, Grep, Glob, Bash(npm:*, git log:*)
+argument-hint: "[metric type or module | 指标类型或模块]"
+---
+
+# Metrics Dashboard Assistant | 指标仪表板助手
+
+Track development metrics, code quality indicators and project health.
+
+追踪开发指标、代码质量指示器与项目健康状态。
+
+## Workflow | 工作流程
+
+```
+COLLECT ──► ANALYZE ──► REPORT ──► TREND
+```
+
+## Usage | 使用方式
+
+- `/metrics` - 执行全面指标分析
+- `/metrics --quality` - 仅代码质量指标
+- `/metrics --debt` - 技术债分析
+- `/metrics --test` - 仅测试指标
+- `/metrics src/` - 分析特定模块
+
+## AI Agent Behavior | AI 代理行为
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 进入路由
+
+| 输入 | AI 动作 |
+|------|---------|
+| `/metrics` | 执行全面指标分析 |
+| `/metrics --quality` | 仅分析代码质量指标 |
+| `/metrics --debt` | 仅分析技术债 |
+| `/metrics --test` | 仅分析测试指标 |
+| `/metrics <path>` | 分析指定模块 |
+
+### Interaction Script | 交互脚本
+
+1. 检测项目结构和可用工具
+2. 收集指标数据（git log、测试覆盖率、代码复杂度）
+3. 分析趋势和异常
+4. 生成报告
+
+**STOP**: 报告展示后等待用户决定是否采取行动
+
+### Stop Points | 停止点
+
+| 停止点 | 等待内容 |
+|--------|---------|
+| 报告展示后 | 用户决定后续行动 |
+
+### Error Handling | 错误处理
+
+| 错误条件 | AI 动作 |
+|----------|---------|
+| 无法执行覆盖率工具 | 跳过该指标，报告可用的其他指标 |
+| git 历史不足以分析趋势 | 仅报告当前快照，标记趋势为 N/A |
+
+## Reference | 参考
+
+- Full standard: [metrics-dashboard-assistant](../metrics-dashboard-assistant/SKILL.md)

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

@@ -0,0 +1,92 @@
+---
+source: ../../../../skills/commands/migrate.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide code migration, framework upgrades and technology modernization"
+allowed-tools: Read, Grep, Glob, Bash(npm:*, git:*)
+argument-hint: "[migration target or framework | 迁移目标或框架]"
+---
+
+# Migration Assistant | 迁移助手
+
+Guide code migration, framework upgrades and technology modernization.
+
+引导代码迁移、框架升级与技术现代化。
+
+## Workflow | 工作流程
+
+```
+ASSESS ──► PLAN ──► PREPARE ──► MIGRATE ──► VERIFY ──► CLEANUP
+```
+
+## Usage | 使用方式
+
+- `/migrate` - 启动交互式迁移指南
+- `/migrate --assess` - 评估迁移范围和风险
+- `/migrate "Vue 2 to 3"` - 迁移特定框架
+- `/migrate --deps` - 依赖升级分析
+- `/migrate --rollback` - 回滚策略规划
+
+## AI Agent Behavior | AI 代理行为
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 进入路由
+
+| 输入 | AI 动作 |
+|------|---------|
+| `/migrate` | 询问迁移目标，进入 ASSESS |
+| `/migrate --assess` | 直接执行范围和风险评估 |
+| `/migrate "target"` | 以指定目标进入 ASSESS |
+| `/migrate --deps` | 仅分析依赖包升级 |
+| `/migrate --rollback` | 规划回滚策略 |
+
+### Interaction Script | 交互脚本
+
+#### ASSESS Phase
+1. 分析现有代码和依赖性
+2. 评估风险矩阵（breaking changes、数据迁移、API 变更）
+3. 展示评估报告
+
+**STOP**: 评估报告后等待用户决定是否继续
+
+#### PLAN Phase
+1. 制定迁移计划（分阶段步骤）
+2. 定义回滚策略
+
+**STOP**: 计划确认后等待用户确认
+
+#### MIGRATE Phase
+1. 逐步执行迁移
+2. 每个步骤后验证
+
+**STOP**: 每个主要步骤完成后等待确认
+
+#### VERIFY Phase
+1. 执行测试确认迁移成功
+2. 生成验证报告
+
+### Stop Points | 停止点
+
+| 阶段 | 停止点 | 等待内容 |
+|------|--------|---------|
+| ASSESS | 评估报告后 | 决定是否继续 |
+| PLAN | 计划制定后 | 确认计划 |
+| MIGRATE | 每个主要步骤后 | 确认继续 |
+
+### Error Handling | 错误处理
+
+| 错误条件 | AI 动作 |
+|----------|---------|
+| 迁移步骤失败 | 建议回滚到上一个检查点 |
+| 依赖冲突 | 列出冲突，建议解决方案 |
+| 测试失败 | 报告失败，建议修复后重试 |
+
+## Reference | 参考
+
+- Full standard: [migration-assistant](../migration-assistant/SKILL.md)

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

@@ -0,0 +1,80 @@
+---
+source: ../../../../skills/commands/pr.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide Pull Request creation, review automation and merge strategies"
+allowed-tools: Read, Grep, Glob, Bash(git:*, gh:*)
+argument-hint: "[branch name or PR number | 分支名称或 PR 编号]"
+---
+
+# PR Automation Assistant | PR 自动化助手
+
+Guide Pull Request creation, review automation and merge strategies.
+
+引导 Pull Request 创建、审查自动化和合并策略。
+
+## Workflow | 工作流程
+
+```
+CREATE ──► REVIEW ──► APPROVE ──► MERGE ──► CLEANUP
+```
+
+## Usage | 使用方式
+
+- `/pr` - 启动交互式 PR 创建
+- `/pr create` - 从当前分支创建 PR
+- `/pr --template` - 使用 PR 模板
+- `/pr review 123` - 审查特定 PR
+
+## AI Agent Behavior | AI 代理行为
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 进入路由
+
+| 输入 | AI 动作 |
+|------|---------|
+| `/pr` | 检查当前分支状态，询问创建或审查 PR |
+| `/pr create` | 分析当前分支差异，创建 PR |
+| `/pr --template` | 使用 PR 模板创建 |
+| `/pr review <number>` | 审查指定 PR |
+
+### Interaction Script | 交互脚本
+
+#### CREATE
+1. 确认当前分支和目标分支
+2. 分析 commits，生成 PR title 和 description
+3. 展示 PR 内容预览
+
+**STOP**: PR 内容确认后等待用户确认创建
+
+#### REVIEW
+1. 获取 PR 差异
+2. 执行代码审查（套用 `/review` 标准）
+3. 展示审查结果
+
+**STOP**: 审查结果展示后等待用户决定
+
+### Stop Points | 停止点
+
+| 阶段 | 停止点 | 等待内容 |
+|------|--------|---------|
+| CREATE | PR 内容预览后 | 确认创建 |
+| REVIEW | 审查结果后 | 决定后续行动 |
+
+### Error Handling | 错误处理
+
+| 错误条件 | AI 动作 |
+|----------|---------|
+| 无远程分支 | 建议先 push |
+| PR 已存在 | 展示现有 PR，询问是否更新 |
+| CI 检查失败 | 列出失败项目，建议修复 |
+
+## Reference | 参考
+
+- Full standard: [pr-automation-assistant](../pr-automation-assistant/SKILL.md)

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

@@ -4,7 +4,7 @@ source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-21
 status: current
-description: 引导重构决策与策略选择
+description: [UDS] Guide refactoring decisions and strategy selection
 allowed-tools: Read, Write, Grep, Glob, Bash(npm test:*), Bash(npx:*)
 argument-hint: "[scope: tactical | strategic | legacy | decide | debt]"
 status: stable

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

@@ -0,0 +1,62 @@
+---
+source: ../../../../skills/commands/release.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+status: current
+---
+
+---
+name: release
+description: [UDS] Manage release process and changelogs.
+argument-hint: "[start|finish|changelog] <version>"
+---
+
+# /release 命令
+
+根据语义化版本管理发布流程和变更日志。
+
+## 用法
+
+```bash
+/release [subcommand] [version]
+```
+
+### 子命令
+
+| Subcommand | Description |
+|------------|-------------|
+| `start` | 启动发布分支/流程 |
+| `finish` | 完成发布（标签、合并） |
+| `changelog` | 生成或更新 CHANGELOG.md |
+| `check` | 运行预发布检查 |
+
+## Changelog 管理
+
+```bash
+/release changelog [version]
+```
+
+通过以下方式更新 `CHANGELOG.md`：
+1.  将「Unreleased」变更移动到新的 `[version]` 区段。
+2.  创建新的「Unreleased」区段。
+3.  更新底部的比较链接。
+
+## 范例
+
+```bash
+# 启动发布 v1.2.0
+/release start 1.2.0
+
+# 更新 v1.2.0 的 changelog
+/release changelog 1.2.0
+
+# 完成发布
+/release finish 1.2.0
+```
+
+## 参考
+
+*   [发布规范技能](../release-standards/SKILL.md)
+*   [Changelog 指南](../changelog-guide/SKILL.md)
+*   [核心规范](../../core/versioning.md)

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

@@ -0,0 +1,54 @@
+---
+description: [UDS] Write user stories and requirements following INVEST criteria
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[feature name or description | 功能名称或描述]"
+---
+
+# Requirement Assistant | 需求助手
+
+Write well-structured user stories and requirements following INVEST criteria.
+
+撰写结构良好的用户故事和需求文件，遵循 INVEST 标准。
+
+## Workflow | 工作流程
+
+1. **理解上下文** - 收集功能相关信息
+2. **识别利益相关者** - 谁从此功能中受益？
+3. **撰写用户故事** - 遵循标准格式
+4. **定义验收标准** - 具体、可测试的条件
+5. **以 INVEST 验证** - 检查质量标准
+
+## User Story Format | 用户故事格式
+
+```markdown
+As a [role],
+I want [feature],
+So that [benefit].
+
+### Acceptance Criteria
+
+- [ ] Given [context], when [action], then [result]
+- [ ] Given [context], when [action], then [result]
+```
+
+## INVEST Criteria | INVEST 标准
+
+| Criterion | Description | 说明 |
+|-----------|-------------|------|
+| **I**ndependent | Can be developed separately | 可独立开发 |
+| **N**egotiable | Details can be discussed | 可协商细节 |
+| **V**aluable | Delivers value to user | 提供用户价值 |
+| **E**stimable | Can estimate effort | 可估算工作量 |
+| **S**mall | Fits in one sprint | 适合单一迭代 |
+| **T**estable | Has clear test criteria | 有明确测试标准 |
+
+## Usage | 使用方式
+
+- `/requirement` - 交互式需求撰写向导
+- `/requirement user login` - 为特定功能撰写需求
+- `/requirement "users can export data"` - 基于描述撰写
+
+## Reference | 参考
+
+- Full standard: [requirement-assistant](../requirement-assistant/SKILL.md)
+- Core guide: [requirements-standards](../../core/requirement-engineering.md)

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

@@ -0,0 +1,47 @@
+---
+description: [UDS] Transform SDD acceptance criteria to BDD scenarios
+allowed-tools: Read, Grep, Glob, Write
+argument-hint: "[spec file or source directory | 规格文件或源代码目录]"
+---
+
+# /reverse-bdd — Extract BDD Scenarios | 提取 BDD 场景
+
+Transform existing code or SDD acceptance criteria into BDD Gherkin scenarios.
+
+将现有代码或 SDD 验收条件转换为 BDD Gherkin 场景。
+
+## Workflow | 工作流程
+
+```
+Source/Spec ──► Analyze Behaviors ──► Generate .feature ──► Review
+```
+
+1. **分析**源代码或规格中的行为模式
+2. **提取**隐含的 Given-When-Then 流程
+3. **生成** Gherkin `.feature` 文件
+4. **标记**确定性标签：`[Confirmed]`、`[Inferred]`
+
+## Output Format | 输出格式
+
+```gherkin
+# [Source: src/auth/login.js:45]
+Feature: User Login [Inferred]
+
+  # [Confirmed] from test/auth.test.js:12
+  Scenario: Successful login
+    Given a registered user exists
+    When they submit valid credentials
+    Then they receive an auth token
+```
+
+## Usage | 使用方式
+
+| Command | Purpose | 用途 |
+|---------|---------|------|
+| `/reverse-bdd src/auth/` | Extract BDD from auth module | 从 auth 模块提取 BDD |
+| `/reverse-bdd specs/SPEC-001.md` | Convert spec AC to BDD | 将规格 AC 转为 BDD |
+
+## Reference | 参考
+
+- Parent command: [/reverse](../reverse-engineer/SKILL.md)
+- Core standard: [reverse-engineering-standards.md](../../core/reverse-engineering-standards.md)