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

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

@@ -0,0 +1,87 @@
+---
+source: ../../../../skills/commands/brainstorm.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+name: brainstorm
+description: "[UDS] Structured AI-assisted brainstorming before spec creation"
+argument-hint: "[问题或功能构想 | problem or feature idea]"
+---
+
+# 脑力激荡助手
+
+在撰写规格前进行结构化发想。通过引导式脑力激荡，将模糊构想转化为可执行的功能提案。
+
+## 用法
+
+```bash
+/brainstorm [problem or feature idea]
+```
+
+## 工作流程
+
+```
+FRAME ──► DIVERGE ──► CONVERGE ──► OUTPUT
+定义问题     发散思考       收敛评估       输出提案
+```
+
+| 阶段 | 目标 | 关键技法 |
+|------|------|----------|
+| **FRAME** | 清楚定义问题 | 5 Whys, HMW, Stakeholder Map |
+| **DIVERGE** | 生成大量想法 | HMW, SCAMPER, Six Thinking Hats |
+| **CONVERGE** | 评估与排序 | Evaluation Matrix, Dot Voting |
+| **OUTPUT** | 可执行的报告 | Brainstorm Report template |
+
+## 技法
+
+| 技法 | 适用场景 |
+|------|----------|
+| **5 Whys** | 找到根本原因 |
+| **HMW** | 将问题重构为机会 |
+| **SCAMPER** | 改善现有功能 |
+| **Six Thinking Hats** | 多角度分析 |
+| **Dot Voting** | 快速排序 |
+
+## 范例
+
+```bash
+/brainstorm                           # Start interactive session
+/brainstorm "user retention"          # Brainstorm around a topic
+/brainstorm --technique scamper       # Use a specific technique
+```
+
+## 输出格式
+
+```markdown
+# Brainstorm Report: [Topic]
+
+## Problem Statement
+[Refined problem from FRAME phase]
+
+## Top 3 Recommendations
+1. **[Idea]** — Score: X.X — [Why recommended]
+2. **[Idea]** — Score: X.X — [Why recommended]
+3. **[Idea]** — Score: X.X — [Why recommended]
+
+## Next Steps
+- [ ] Proceed to `/requirement` with top idea
+- [ ] Proceed to `/sdd` if requirements are clear
+```
+
+## 后续步骤
+
+脑力激荡后，典型的工作流程是：
+
+1. `/brainstorm` - 结构化发想（本命令）
+2. `/requirement` - 撰写用户故事和需求
+3. `/sdd` - 创建规格文档
+4. `/derive-all` 或 `/tdd` - 以测试保护进行实现
+
+## 参考
+
+* [Brainstorm Assistant Skill](../brainstorm-assistant/SKILL.md)
+* [Requirement Assistant](../requirement-assistant/SKILL.md)
+* [Spec-Driven Development](../spec-driven-dev/SKILL.md)

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

@@ -0,0 +1,63 @@
+---
+source: ../../../../skills/commands/changelog.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+name: changelog
+description: "[UDS] Generate and maintain CHANGELOG.md entries"
+---
+
+# 变更日志助手
+
+根据 Keep a Changelog 格式生成和维护 CHANGELOG.md 条目。
+
+## 用法
+
+```bash
+/changelog
+```
+
+## 工作流程
+
+1. **分析 git 日志** - 使用 `git log` 读取上次发布以来的提交历史
+2. **分类变更** - 将提交映射到变更日志分类
+3. **生成条目** - 为每个变更撰写面向用户的描述
+4. **更新 CHANGELOG.md** - 将条目插入 [Unreleased] 或版本化区段
+
+## 变更分类
+
+| 分类 | 使用时机 | Commit 类型 |
+|------|----------|-------------|
+| **Added** | 新功能 | `feat` |
+| **Changed** | 修改既有功能 | `perf`, `BREAKING CHANGE` |
+| **Deprecated** | 即将移除的功能 | -- |
+| **Removed** | 已移除的功能 | `BREAKING CHANGE` |
+| **Fixed** | 错误修复 | `fix` |
+| **Security** | 安全性修补 | `security` |
+
+## 条目格式
+
+```markdown
+## [Unreleased]
+
+### Added
+- Add user dashboard with customizable widgets (#123)
+
+### Fixed
+- Fix memory leak when processing large files (#456)
+```
+
+### 撰写指南
+
+- 为**用户**而非开发者撰写
+- 聚焦**影响**而非实现
+- 附上 issue/PR 编号
+- 用 **BREAKING** 标记破坏性变更
+
+## 参考
+
+*   [Changelog Guide Skill](../changelog-guide/SKILL.md)
+*   [Core Standard](../../core/changelog-standards.md)

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

@@ -0,0 +1,219 @@
+---
+source: ../../../../skills/commands/check.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Verify standards adoption status
+allowed-tools: Read, Bash(uds check:*), Bash(npx:*), Bash(ls:*)
+argument-hint: "[--offline | --restore | --summary]"
+---
+
+# 检查标准
+
+验证当前专案的 Universal Development Standards 采用状态。
+
+## 快速开始
+
+```bash
+# Basic check (with interactive mode for issues)
+uds check
+
+# Compact summary for quick status
+uds check --summary
+
+# Check without network access
+uds check --offline
+
+# Restore missing or modified files
+uds check --restore
+```
+
+## 输出模式
+
+### 摘要模式 (--summary)
+
+显示精简状态供快速浏览：
+
+```
+UDS Status Summary
+──────────────────────────────────────────────────
+  Version: 3.5.1-beta.16 → 3.5.1-beta.18 ⚠
+  Level: 2 - Professional (专业)
+  Files: 12 ✓
+  Skills: Claude Code ✓ | OpenCode ○
+  Commands: OpenCode ✓
+──────────────────────────────────────────────────
+```
+
+### 完整模式（默认）
+
+显示详细信息，包括：
+- 采用状态（等级、版本、安装日期）
+- 文件完整性（未变更/已修改/遗失数量）
+- Skills 完整性（如果在 manifest 中追踪）
+- Commands 完整性（如果在 manifest 中追踪）
+- 集成区块完整性
+- 引用同步状态
+- AI 工具集成文件覆盖率
+- 覆盖率报告
+
+## 互动模式
+
+当检测到问题时（已修改/遗失的文件），CLI 自动进入互动模式：
+
+```
+──────────────────────────────────────────────────
+⚠ Modified: .standards/commit-message.ai.yaml
+
+? What would you like to do?
+❯ View diff
+  Restore original
+  Keep current (update hash)
+  Skip
+```
+
+**可用操作：**
+
+| 操作 | 说明 |
+|------|------|
+| **View diff** | 显示当前版本与原始版本的差异 |
+| **Restore original** | 用上游版本替换 |
+| **Keep current** | 接受修改并更新 hash |
+| **Skip** | 对此文件不做任何操作 |
+
+对于遗失的文件：
+
+| 操作 | 说明 |
+|------|------|
+| **Restore** | 从上游下载并恢复 |
+| **Remove from tracking** | 从 manifest 移除 |
+| **Skip** | 对此文件不做任何操作 |
+
+## 选项
+
+| 选项 | 说明 |
+|------|------|
+| `--summary` | 显示精简状态摘要 |
+| `--offline` | 跳过 npm registry 检查 |
+| `--diff` | 显示修改文件的差异 |
+| `--restore` | 还原所有修改和遗失的文件 |
+| `--restore-missing` | 仅还原遗失的文件 |
+| `--migrate` | 迁移旧版 manifest 到 hash 追踪 |
+
+## 输出区段
+
+### 采用状态
+
+- 采用等级 (1-3)
+- 安装日期
+- 已安装版本
+- 更新可用性
+
+### 文件完整性
+
+显示每个追踪文件的状态：
+
+| 符号 | 含义 |
+|------|------|
+| ✓ (绿色) | 未变更 |
+| ⚠ (黄色) | 已修改 |
+| ✗ (红色) | 遗失 |
+| ? (灰色) | 存在但无 hash |
+
+摘要格式：`{unchanged} unchanged, {modified} modified, {missing} missing`
+
+### Skills 完整性 (v3.3.0+)
+
+如果 manifest 中存在 `skillHashes`，检查：
+- 文件是否存在于预期路径
+- hash 比对以检测修改
+
+### Commands 完整性 (v3.3.0+)
+
+如果 manifest 中存在 `commandHashes`，检查：
+- 文件是否存在于预期路径
+- hash 比对以检测修改
+
+### 集成区块完整性 (v3.3.0+)
+
+如果 manifest 中存在 `integrationBlockHashes`，检查：
+- UDS 标记区块是否存在
+- 区块内容 hash（用户在区块外的自定义内容会被保留）
+
+### Skills 状态
+
+显示每个已配置 AI 工具的安装状态：
+
+```
+Skills Status
+  Claude Code:
+    ✓ Skills installed:
+      - User level: ~/.claude/skills/
+        Version: 3.5.1
+    ✓ Commands: 7 installed
+      Path: .opencode/commands/
+```
+
+状态指示器：
+- ✓ installed (绿色) - Skills/Commands 已安装
+- ○ not installed (灰色) - 未安装
+
+### 覆盖率摘要
+
+显示标准覆盖率：
+- 当前等级所需的标准
+- Skills 覆盖的标准
+- 参考文档覆盖的标准
+
+## 状态指示
+
+| 符号 | 含义 |
+|------|------|
+| ✓ (绿色) | 一切正常 |
+| ⚠ (黄色) | 警告，建议采取行动 |
+| ✗ (红色) | 错误，需要采取行动 |
+| ○ (灰色) | 未安装/配置 |
+
+## 常见问题
+
+**"Standards not initialized"**
+- 执行 `/init` 初始化标准
+
+**"Update available"**
+- 执行 `/update` 获取最新版本
+
+**"Missing files"**
+- 执行 `/check --restore` 或 `/update` 恢复
+
+**"Modified files detected"**
+- 执行 `/check --diff` 查看变更
+- 执行 `/check --restore` 重置为原始版本
+- 或使用互动模式逐个处理文件
+
+**"Skills not installed"**
+- 执行 `/update` 安装缺失的 Skills
+- 或执行 `/config skills` 管理 Skills
+
+**"Legacy manifest detected"**
+- 执行 `uds check --migrate` 升级到 hash 追踪
+
+## 使用方式
+
+```bash
+/check                  # Full check with interactive mode
+/check --summary        # Quick status overview
+/check --offline        # Check without network access
+/check --restore        # Restore modified/missing files
+/check --diff           # Show file differences
+/check --migrate        # Upgrade manifest format
+```
+
+## 参考
+
+- CLI 文档: `uds check --help`
+- 初始化命令: [/init](./init.md)
+- 更新命令: [/update](./update.md)
+- 配置命令: [/config](./config.md)

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

@@ -0,0 +1,61 @@
+---
+source: ../../../../skills/commands/checkin.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+name: checkin
+description: "[UDS] Pre-commit quality gates verification"
+---
+
+# 签入助手
+
+在提交代码前验证品质关卡，确保代码库的稳定性。
+
+## 用法
+
+```bash
+/checkin
+```
+
+## 工作流程
+
+1. **检查 git 状态** - 执行 `git status` 和 `git diff` 了解待处理的变更
+2. **运行测试** - 执行 `npm test`（或专案测试命令）验证所有测试通过
+3. **运行代码检查** - 执行 `npm run lint` 检查代码风格合规性
+4. **验证品质关卡** - 根据以下检查清单检查每个关卡
+5. **报告结果** - 呈现通过/失败摘要并建议下一步
+
+## 品质关卡
+
+| 关卡 | 检查项目 |
+|------|----------|
+| **构建** | 编译零错误 |
+| **测试** | 所有测试通过（100%） |
+| **覆盖率** | 覆盖率未下降 |
+| **AC 覆盖率** | AC 到测试覆盖率 ≥ 80%（[`/ac-coverage`](./ac-coverage.md)） |
+| **代码品质** | 符合编码规范，无代码异味 |
+| **安全性** | 无硬编码密钥或漏洞 |
+| **文档** | API 文档和 CHANGELOG 已按需更新 |
+| **工作流** | 分支命名和提交消息格式正确 |
+
+## 禁止提交的情况
+
+- 构建有错误
+- 测试失败
+- 功能不完整会破坏现有功能
+- 包含调试代码（console.log, print）
+- 包含被注释的代码区块
+
+## 后续步骤
+
+验证通过后，执行 `/commit` 创建提交消息。
+
+## 参考
+
+*   [Check-in Assistant Skill](../checkin-assistant/SKILL.md)
+*   [Core Standard](../../core/checkin-standards.md)
+*   [AC Coverage Command](./ac-coverage.md) — AC 到测试追踪分析
+*   [AC Traceability Standard](../../core/acceptance-criteria-traceability.md)

package/bundled/locales/zh-CN/skills/commands/ci-cd.md

@@ -0,0 +1,77 @@
+---
+source: ../../../../skills/commands/ci-cd.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide CI/CD pipeline design, configuration and optimization"
+allowed-tools: Read, Grep, Glob
+argument-hint: "[pipeline config or stage | Pipeline 配置或阶段]"
+---
+
+# CI/CD Assistant | CI/CD 助手
+
+Guide CI/CD pipeline design, configuration and optimization.
+
+引导 CI/CD 管线设计、配置和优化。
+
+## Workflow | 工作流程
+
+```
+BUILD ──► TEST ──► ANALYZE ──► DEPLOY ──► VERIFY
+```
+
+## Usage | 使用方式
+
+- `/ci-cd` - 启动交互式管线设计
+- `/ci-cd github-actions` - 为特定平台设计
+- `/ci-cd --optimize` - 优化现有管线
+- `/ci-cd build` - 聚焦构建阶段
+
+## AI Agent Behavior | AI 代理行为
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 进入路由
+
+| 输入 | AI 动作 |
+|------|---------|
+| `/ci-cd` | 检测现有 CI 配置（`.github/workflows/`、`.gitlab-ci.yml` 等），展示状态或开始设计 |
+| `/ci-cd <platform>` | 为指定平台设计管线 |
+| `/ci-cd --optimize` | 分析现有管线，提出优化建议 |
+| `/ci-cd <stage>` | 聚焦特定阶段（build/test/deploy） |
+
+### Interaction Script | 交互脚本
+
+1. 检测项目技术栈和现有 CI 配置
+2. 依据需求设计或优化管线
+
+**Decision: 现有配置**
+- IF 已有 CI 配置 → 分析现状，建议优化
+- IF 无 CI 配置 → 引导从头设计
+- IF `--optimize` → 直接进入优化分析
+
+3. 逐阶段设计（BUILD→TEST→ANALYZE→DEPLOY→VERIFY）
+4. 展示完整管线配置
+
+**STOP**: 配置展示后等待用户确认写入
+
+### Stop Points | 停止点
+
+| 停止点 | 等待内容 |
+|--------|---------|
+| 管线设计完成后 | 确认配置正确并写入 |
+
+### Error Handling | 错误处理
+
+| 错误条件 | AI 动作 |
+|----------|---------|
+| 无法检测 CI 平台 | 列出支持的平台供选择 |
+| 现有配置语法错误 | 报告错误位置，建议修正 |
+
+## Reference | 参考
+
+- Full standard: [ci-cd-assistant](../ci-cd-assistant/SKILL.md)

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

@@ -0,0 +1,81 @@
+---
+source: ../../../../skills/commands/commit.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Generate commit messages following Conventional Commits standard
+allowed-tools: Read, Grep, Bash(git status:*), Bash(git diff:*), Bash(git log:*), Bash(git add:*), Bash(git commit:*)
+argument-hint: "[变更描述 | description of changes]"
+---
+
+# Commit Message 助手
+
+根据 staged 的变更，生成符合 Conventional Commits 格式的 commit message。
+
+## 前置检查
+
+在生成 commit 前，AI 助手必须执行以下检查：
+
+| 检查 | 命令 | 失败时 |
+|------|------|--------|
+| Staged 变更存在 | `git diff --cached --stat` | → 引导用户执行 `git add` |
+| 无合并冲突 | `grep -r "<<<<<<< " --include="*.{js,ts,md,yaml}" .` | → 先解决冲突 |
+| 测试通过 (feat/fix) | `cd cli && npm run test:unit`（或专案测试命令） | → 提交前先修复测试 |
+| Spec 引用 (feat/fix) | 检查 `docs/specs/SPEC-*.md` 是否有活跃规格 | → 建议在 footer 加入 `Refs: SPEC-XXX` |
+
+### Spec 追踪闸门
+
+对于 `feat` 和 `fix` 类型的提交：
+1. **检查**：`ls docs/specs/SPEC-*.md 2>/dev/null` — 是否有活跃的规格？
+2. **如果有规格**：建议在 footer 加入 `Refs: SPEC-XXX`
+3. **如果没有规格且变更显著**（>3 个文件或新 API）：建议通过 `/sdd` 创建规格
+4. **模式**：这是建议性的（非阻断）— 用户可以不引用规格
+
+---
+
+## 工作流程
+
+1. **检查状态** - 执行 `git status` 和 `git diff --staged` 了解变更
+2. **分析变更** - 确定类型（feat, fix, refactor 等）和范围
+3. **Spec 追踪评估** - 评估此变更是否需要规格（见下文）
+4. **生成消息** - 创建遵循以下格式的提交消息：
+   ```
+   <type>(<scope>): <subject>
+
+   <body>
+
+   <footer>
+   ```
+5. **确认并提交** - 执行 `git commit` 前先请用户确认
+
+## Spec 追踪评估
+
+对于 `feat`/`fix` 提交，评估是否应创建或链接规格。当以下情况时建议创建规格：变更文件较多（>3）、修改了公共 API 签名、或有显著的新功能。对于 `docs`/`style`/`chore`/`test` 类型则跳过。
+
+如果链接了规格，在提交 footer 中加入 `Refs: SPEC-XXX`。这是建议性的 — 用户可以随时忽略。
+
+## 提交类型
+
+| 类型 | 使用时机 |
+|------|----------|
+| `feat` | 新功能 |
+| `fix` | 修复错误 |
+| `refactor` | 重构 |
+| `docs` | 文档更新 |
+| `style` | 格式调整 |
+| `test` | 测试相关 |
+| `perf` | 性能优化 |
+| `chore` | 维护任务 |
+
+## 使用方式
+
+- `/commit` - 自动分析变更并建议提交消息
+- `/commit fix login bug` - 根据提供的描述生成消息
+
+## 参考
+
+- 完整规范: [commit-standards](../commit-standards/SKILL.md)
+- 核心指南: [commit-message-guide](../../core/commit-message-guide.md)