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

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

@@ -0,0 +1,119 @@
+---
+source: ../../../../skills/brainstorm-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-23
+status: current
+description: |
+  在撰写规格前进行结构化 AI 辅助脑力激荡。
+  使用时机：功能规划、创意发想、问题定义。
+  关键字：brainstorm, ideas, HMW, SCAMPER, 脑力激荡, 发想。
+---
+
+# 脑力激荡助手
+
+> **语言**: [English](../../../../skills/brainstorm-assistant/SKILL.md) | 简体中文
+
+在撰写规格前进行结构化发想。通过引导式脑力激荡，将模糊构想转化为可执行的功能提案。
+
+## 工作流程
+
+```
+FRAME ──► DIVERGE ──► CONVERGE ──► OUTPUT
+定义问题     发散思考       收敛评估       输出提案
+```
+
+### 阶段 1：FRAME | 定义问题
+
+在产生想法之前，先清楚定义问题空间。
+
+| 步骤 | 动作 |
+|------|------|
+| 1 | 用 5 Whys 厘清问题根因 |
+| 2 | 重构为「How Might We」(HMW) 问题 |
+| 3 | 识别利害关系人与限制条件 |
+| 4 | 从代码库搜集脉络（如适用） |
+
+### 阶段 2：DIVERGE | 发散思考
+
+不加评判地尽可能产生多个想法。
+
+| 技法 | 使用时机 |
+|------|----------|
+| **HMW 问题** | 默认起点 |
+| **SCAMPER** | 改善现有功能 |
+| **六顶思考帽** | 需要多角度思考 |
+
+### 阶段 3：CONVERGE | 收敛评估
+
+使用结构化标准评估与排序想法。
+
+| 评估标准 | 权重 |
+|----------|------|
+| 技术可行性 | 30% |
+| 用户影响力 | 30% |
+| 实现成本 | 20% |
+| 目标一致性 | 20% |
+
+### 阶段 4：OUTPUT | 输出提案
+
+产生可直接对接 `/requirement` 或 `/sdd` 的脑力激荡报告。
+
+## 技法速览
+
+| 技法 | 用途 | 步骤 |
+|------|------|------|
+| **5 Whys** | 根因分析 | 连问 5 次「为什么？」 |
+| **HMW** | 问题重构 | 「我们如何能 [动词] [成果]？」 |
+| **SCAMPER** | 创意改造 | 7 步骤：替代、结合、调适、修改、另作他用、删除、反转 |
+| **六顶思考帽** | 多角度思考 | 6 种模式：事实、情感、风险、好处、创意、流程 |
+| **点数投票** | 快速排序 | 每人 3 票，投给最看好的想法 |
+
+## 输出格式
+
+```markdown
+# 脑力激荡报告：[主题]
+
+## 问题陈述
+[FRAME 阶段精炼的问题]
+
+## HMW 问题
+1. 我们如何能...？
+2. 我们如何能...？
+3. 我们如何能...？
+
+## 产生的想法
+| # | 想法 | 来源技法 | 可行性 | 影响力 | 分数 |
+|---|------|----------|--------|--------|------|
+| 1 | ...  | SCAMPER   | 4/5    | 5/5    | 4.3  |
+| 2 | ...  | HMW       | 3/5    | 4/5    | 3.5  |
+
+## 前 3 名推荐
+1. **[想法名称]** — [推荐原因]
+2. **[想法名称]** — [推荐原因]
+3. **[想法名称]** — [推荐原因]
+
+## 后续步骤
+- [ ] 以首选想法进入 `/requirement`
+- [ ] 若需求已明确，直接进入 `/sdd`
+- [ ] 需进一步探索想法 #N
+```
+
+## 使用方式
+
+- `/brainstorm` — 启动互动式脑力激荡
+- `/brainstorm "用户留存"` — 针对特定主题进行脑力激荡
+- `/brainstorm --technique scamper` — 使用特定技法
+
+## 下一步引导
+
+`/brainstorm` 完成后，AI 助手应建议：
+
+> **脑力激荡完成。建议下一步：**
+> - 执行 `/requirement` 将最佳构想转为用户故事
+> - 执行 `/sdd` 直接建立规格（若需求已明确）
+> - 针对特定构想进行更深入探索
+
+## 参考
+
+- 详细指南：[guide.md](./guide.md)

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

@@ -0,0 +1,82 @@
+---
+source: ../../../../skills/ci-cd-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-24
+status: current
+description: |
+  引导 CI/CD 管线设计、配置和优化。
+  使用时机：设置管线、优化构建时间、配置部署阶段。
+  关键字：CI/CD, pipeline, GitHub Actions, deployment, build, 持续集成, 持续部署。
+---
+
+# CI/CD 管线助手
+
+> **语言**: [English](../../../../skills/ci-cd-assistant/SKILL.md) | 简体中文
+
+引导 CI/CD 管线设计，遵循业界最佳实践与 DORA 指标。
+
+## 管线阶段参考
+
+```
+BUILD ──► TEST ──► ANALYZE ──► DEPLOY ──► VERIFY
+构建       测试      分析         部署       验证
+```
+
+| 阶段 | 用途 | 关键活动 |
+|------|------|----------|
+| **Build** | 编译与打包 | 安装依赖、编译、产出制品 |
+| **Test** | 质量验证 | 单元、集成、端到端测试 |
+| **Analyze** | 代码质量 | 代码检查、安全扫描、覆盖率 |
+| **Deploy** | 发布到环境 | 预备环境 → 生产环境部署 |
+| **Verify** | 部署后验证 | 冒烟测试、健康检查、监控 |
+
+## DORA 指标快速参考
+
+| 指标 | 精英 | 高 | 中 | 低 |
+|------|------|-----|-----|-----|
+| **部署频率** | 按需（每日多次） | 每周至每月 | 每月至半年 | > 6 个月 |
+| **变更前置时间** | < 1 小时 | 1 天至 1 周 | 1 至 6 个月 | > 6 个月 |
+| **MTTR** | < 1 小时 | < 1 天 | 1 天至 1 周 | > 6 个月 |
+| **变更失败率** | 0–15% | 16–30% | 16–30% | > 30% |
+
+## 最佳实践检查清单
+
+- [ ] **快速失败** — 先执行最快的检查（lint → 单元 → 集成 → E2E）
+- [ ] **缓存依赖** — 在运行之间缓存 `node_modules`、`.m2`、pip cache
+- [ ] **并行作业** — 将测试套件分散到并行执行器
+- [ ] **不可变制品** — 构建一次，将相同制品部署到所有环境
+- [ ] **环境一致** — 保持预备环境与生产环境一致
+- [ ] **密钥管理** — 绝不硬编码密钥；使用 vault/环境变量
+- [ ] **分支保护** — 要求 CI 通过才能合并
+- [ ] **回滚策略** — 部署失败时自动回滚
+
+## 平台专属提示
+
+| 平台 | 缓存 | 并行化 | 密钥 | 备注 |
+|------|------|--------|------|------|
+| **GitHub Actions** | `actions/cache` | `matrix` 策略 | `secrets.*` | 使用 reusable workflows |
+| **GitLab CI** | `cache:` 关键字 | `parallel:` 关键字 | CI/CD Variables | 使用 `include:` 模块化 |
+| **Jenkins** | Stash/unstash | `parallel {}` 块 | Credentials plugin | 使用 shared libraries |
+
+## 使用方式
+
+- `/ci-cd` - 显示完整管线指引
+- `/ci-cd github-actions` - GitHub Actions 专属提示
+- `/ci-cd --optimize` - 管线优化建议
+- `/ci-cd build` - 构建阶段最佳实践
+
+## 下一步引导
+
+`/ci-cd` 完成后，AI 助手应建议：
+
+> **管线指引已提供。建议下一步：**
+> - 执行 `/deploy` 设定部署策略
+> - 执行 `/security` 检查管线安全
+> - 执行 `/testing` 设计测试策略
+> - 执行 `/commit` 创建规范化提交
+
+## 参考
+
+- 核心规范：[pipeline-integration-standards.md](../../../../core/pipeline-integration-standards.md)
+- 核心规范：[deployment-standards.md](../../../../core/deployment-standards.md)

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

@@ -0,0 +1,97 @@
+---
+source: ../../../../skills/commands/ac-coverage.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: "[UDS] Generate AC-to-test traceability matrix and coverage report"
+allowed-tools: Read, Grep, Glob
+argument-hint: "[spec file path | 规格文件路径]"
+---
+
+# AC 覆盖率
+
+从规格文件生成验收条件（AC）与测试的追踪矩阵及覆盖率报告。
+
+## 用法
+
+```bash
+/ac-coverage specs/SPEC-001.md            # Analyze specific SPEC
+/ac-coverage specs/SPEC-001.md --threshold 90   # Custom threshold
+/ac-coverage specs/SPEC-001.md --test-dir tests/ # Specify test directory
+```
+
+## 工作流程
+
+1. **解析 SPEC** — 读取规格文件并提取所有 AC 定义（AC-1, AC-2, ...）
+2. **扫描测试** — 搜索测试文件中的 `@AC` 和 `@SPEC` 注解
+3. **构建矩阵** — 将每个 AC 映射到对应的测试引用
+4. **分类状态** — ✅ 已覆盖 | ⚠️ 部分覆盖 | ❌ 未覆盖
+5. **计算覆盖率** — `Coverage % = (covered + partial × 0.5) / total × 100`
+6. **生成报告** — 输出标准化 Markdown 报告
+
+## 与 `/coverage` 的区别
+
+| | `/coverage` | `/ac-coverage` |
+|-|-------------|----------------|
+| **层级** | 代码（行/分支/函数） | 需求（AC 到测试） |
+| **问题** | "有多少代码被测试了？" | "哪些 AC 有测试？" |
+| **输入** | 源代码 + 测试运行器 | SPEC 文件 + 测试注解 |
+
+两者互补 — 使用 `/coverage` 确保代码品质，使用 `/ac-coverage` 确保需求验证。
+
+## 品质门槛
+
+| 情境 | 默认门槛 | 可配置 |
+|------|----------|--------|
+| **签入** | 80% | `--threshold N` |
+| **发布** | 100% | `--threshold N` |
+| **警告** | 60% | `--threshold N` |
+
+## 输出格式
+
+```markdown
+# AC Coverage Report
+
+**Specification**: SPEC-001 — Feature Name
+**Generated**: 2026-03-18
+**Coverage**: 75% (6/8 AC)
+
+## Summary
+
+| Status | Count | Percentage |
+|--------|-------|------------|
+| ✅ Covered | 5 | 62.5% |
+| ⚠️ Partial | 2 | 25.0% |
+| ❌ Uncovered | 1 | 12.5% |
+
+## Traceability Matrix
+
+| AC-ID | Description | Status | Test Reference |
+|-------|-------------|--------|----------------|
+| AC-1 | ... | ✅ | test-file.ts:15 |
+
+## Gaps
+- **AC-8**: Blocked by external dependency
+
+## Action Items
+1. [ ] AC-8: Resolve blocker
+```
+
+## 下一步引导
+
+`/ac-coverage` 完成后，AI 助手应建议：
+
+> **AC 覆盖率分析完成。建议下一步：**
+> - 覆盖率达标 → 执行 `/checkin` 品质关卡
+> - 有未覆盖 AC → 执行 `/derive-tdd` 补齐测试
+> - 有部分覆盖 AC → 检查缺少的边界情况
+
+## 参考
+
+- [AC Coverage Assistant Skill](../ac-coverage-assistant/SKILL.md)
+- [Core Standard: Acceptance Criteria Traceability](../../core/acceptance-criteria-traceability.md)
+- 相关: [/coverage](./coverage.md) (代码层级覆盖率)
+- 相关: [/checkin](./checkin.md) (品质关卡)

package/bundled/locales/zh-CN/skills/commands/api-design.md

@@ -0,0 +1,94 @@
+---
+source: ../../../../skills/commands/api-design.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide API design following REST, GraphQL and gRPC best practices"
+allowed-tools: Read, Grep, Glob
+argument-hint: "[API endpoint or module | API 端点或模块]"
+---
+
+# API Design Assistant | API 设计助手
+
+Guide API design following REST, GraphQL and gRPC best practices.
+
+引导 API 设计，遵循 REST、GraphQL 和 gRPC 最佳实践。
+
+## Workflow | 工作流程
+
+```
+DEFINE ──► DESIGN ──► VALIDATE ──► DOCUMENT
+```
+
+1. **Define** — 收集需求，识别资源和操作
+2. **Design** — 设计端点、请求/响应 schema、错误码
+3. **Validate** — 检查一致性、命名规范、版本控制
+4. **Document** — 生成 API 文档
+
+## Usage | 使用方式
+
+- `/api-design` - 启动交互式 API 设计会话
+- `/api-design /users` - 为特定资源设计 API
+- `/api-design --graphql` - 使用 GraphQL 方法设计
+
+## AI Agent Behavior | AI 代理行为
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 进入路由
+
+| 输入 | AI 动作 |
+|------|---------|
+| `/api-design` | 询问 API 需求和目标资源，进入 DEFINE 阶段 |
+| `/api-design <resource>` | 以指定资源为目标，进入 DEFINE |
+| `/api-design --graphql` | 使用 GraphQL 方法设计 |
+
+### Interaction Script | 交互脚本
+
+#### DEFINE Phase
+1. 收集 API 需求（目标用户、资源、操作）
+2. 确认 API 风格（REST / GraphQL / gRPC）
+
+**STOP**: 需求确认后等待用户确认进入 DESIGN
+
+#### DESIGN Phase
+1. 设计端点/schema
+2. 定义 request/response 格式
+3. 设计错误码和状态码
+4. 展示设计结果
+
+**STOP**: 设计展示后等待用户确认
+
+#### VALIDATE Phase
+1. 检查命名一致性、RESTful 惯例
+2. 验证版本策略
+3. 展示验证报告
+
+#### DOCUMENT Phase
+1. 生成 API 文档（OpenAPI / GraphQL Schema）
+
+**STOP**: 文档生成后等待用户确认写入
+
+### Stop Points | 停止点
+
+| 阶段 | 停止点 | 等待内容 |
+|------|--------|---------|
+| DEFINE | 需求确认后 | 确认进入 DESIGN |
+| DESIGN | 设计展示后 | 确认设计方案 |
+| DOCUMENT | 文档生成后 | 确认写入 |
+
+### Error Handling | 错误处理
+
+| 错误条件 | AI 动作 |
+|----------|---------|
+| 无法判断 API 风格 | 列出选项（REST/GraphQL/gRPC），请用户选择 |
+| 资源命名不符惯例 | 建议修正，展示命名规则 |
+
+## Reference | 参考
+
+- Full standard: [api-design-assistant](../api-design-assistant/SKILL.md)
+- Core guide: [api-design-standards](../../core/api-design-standards.md)

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

@@ -0,0 +1,163 @@
+---
+source: ../../../../skills/commands/atdd.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+status: experimental
+---
+
+---
+description: [UDS] Guide through Acceptance Test-Driven Development workflow
+allowed-tools: Read, Write, Grep, Glob, Bash(npm test:*), Bash(npx:*)
+argument-hint: "[要定义的用户故事或功能 | user story or feature to define]"
+status: experimental
+---
+
+# ATDD 助手
+
+> [!WARNING]
+> **实验性功能 / Experimental Feature**
+>
+> 此功能正在积极开发中，可能在 v4.0 中有重大变更。
+> This feature is under active development and may change significantly in v4.0.
+
+引导验收测试驱动开发（ATDD）流程，用于定义和实现用户故事。
+
+## 方法论集成
+
+当调用 `/atdd` 时：
+1. **自动启用 ATDD 方法论**（如果尚未启用）
+2. **将当前阶段设为规格工作坊**（定义验收条件）
+3. **追踪阶段转换**随着工作进展
+4. **在响应中显示阶段指示器**（🤝 工作坊、🧪 提炼、💻 开发、🎬 展示、✅ 完成）
+
+详见 [methodology-system](../methodology-system/SKILL.md) 了解完整方法论追踪。
+
+## ATDD 循环
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                                                                 │
+│  ┌──────────┐  ┌───────────┐  ┌───────────┐  ┌──────┐  ┌──────┐│
+│  │ WORKSHOP │► │ DISTILL   │► │ DEVELOP   │► │ DEMO │► │ DONE ││
+│  └──────────┘  └───────────┘  └───────────┘  └──────┘  └──────┘│
+│       ▲                              │              │           │
+│       │                              │              │           │
+│       └──────────────────────────────┴──────────────┘           │
+│                  (Refinement needed)                            │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## 工作流程
+
+### 1. 规格工作坊 - 定义验收条件
+- PO 提出用户故事
+- 团队提出澄清问题
+- 共同定义验收条件
+- 记录超出范围的项目
+
+### 2. 提炼 - 转换为测试
+- 将 AC 转换为可执行的测试格式
+- 消除歧义
+- 获得 PO 签核
+
+### 3. 开发 - 实现
+- 运行验收测试（应该先失败）
+- 使用 BDD/TDD 进行实现
+- 迭代直到所有测试通过
+
+### 4. 展示 - 向利害关系人展示
+- 展示通过的验收测试
+- 演示工作中的功能
+- 获得 PO 正式验收
+
+### 5. 完成
+- PO 已验收
+- 代码已合并
+- 故事已关闭
+
+## 用户故事模板
+
+```markdown
+## User Story: [Title]
+
+**As a** [role]
+**I want** [feature]
+**So that** [benefit]
+
+## Acceptance Criteria
+
+### AC-1: [Happy path]
+**Given** [precondition]
+**When** [action]
+**Then** [expected result]
+
+### AC-2: [Error scenario]
+**Given** [precondition]
+**When** [invalid action]
+**Then** [error handling]
+
+## Out of Scope
+- [Things explicitly not included]
+
+## Technical Notes
+- [Implementation hints]
+```
+
+## INVEST 准则
+
+| 准则 | 描述 |
+|------|------|
+| **I**ndependent | 可独立开发 |
+| **N**egotiable | 细节可协商 |
+| **V**aluable | 提供商业价值 |
+| **E**stimable | 可估算 |
+| **S**mall | 一个 Sprint 可完成 |
+| **T**estable | 有明确验收条件 |
+
+## 与 BDD/TDD 集成
+
+```
+ATDD Level (Business Acceptance)
+  │
+  └─▶ BDD Level (Behavior Specification)
+         │
+         └─▶ TDD Level (Unit Implementation)
+```
+
+## 使用方式
+
+- `/atdd` - 启动互动式 ATDD 会话
+- `/atdd "user can reset password"` - 针对特定功能的 ATDD
+- `/atdd US-123` - 针对现有用户故事的 ATDD
+
+## 阶段检查清单
+
+### 工作坊阶段
+- [ ] PO 在场
+- [ ] 用户故事已说明
+- [ ] AC 使用 Given-When-Then 格式
+- [ ] 超出范围已记录
+
+### 提炼阶段
+- [ ] AC 已转换为可执行测试
+- [ ] 测试无歧义
+- [ ] PO 已签核
+
+### 开发阶段
+- [ ] 验收测试最初失败
+- [ ] 使用 BDD/TDD 进行实现
+- [ ] 所有验收测试通过
+
+### 展示阶段
+- [ ] 展示环境就绪
+- [ ] 测试显示通过
+- [ ] PO 正式验收
+
+## 参考
+
+- 核心规范: [acceptance-test-driven-development.md](../../core/acceptance-test-driven-development.md)
+- 技能: [atdd-assistant](../atdd-assistant/SKILL.md)
+- 方法论: [atdd.methodology.yaml](../../methodologies/atdd.methodology.yaml)
+- 方法论系统: [methodology-system](../methodology-system/SKILL.md)

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

@@ -0,0 +1,77 @@
+---
+source: ../../../../skills/commands/audit.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] UDS health check and feedback system, diagnose installation integrity and detect development patterns"
+allowed-tools: Read, Grep, Glob, Bash(git log:*, uds audit:*)
+argument-hint: "[--health | --patterns | --friction | --report]"
+---
+
+# Audit Assistant | 审计助手
+
+UDS health check and feedback system — diagnose installation integrity and detect development patterns.
+
+UDS 健康检查与反馈系统——诊断安装完整性与检测开发模式。
+
+## Workflow | 工作流程
+
+```
+DIAGNOSE ──► ANALYZE ──► REPORT
+```
+
+## Usage | 使用方式
+
+- `/audit` - 执行完整审计
+- `/audit --health` - 安装健康检查
+- `/audit --patterns` - 检测开发模式
+- `/audit --friction` - 识别摩擦点
+- `/audit --report` - 生成综合报告
+
+## AI Agent Behavior | AI 代理行为
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 进入路由
+
+| 输入 | AI 动作 |
+|------|---------|
+| `/audit` | 执行完整审计（health + patterns + friction） |
+| `/audit --health` | 仅检查 UDS 安装完整性 |
+| `/audit --patterns` | 仅检测开发模式 |
+| `/audit --friction` | 仅识别摩擦点 |
+| `/audit --report` | 生成完整报告（含建议） |
+
+### Interaction Script | 交互脚本
+
+1. 依模式执行对应的诊断
+2. 收集分析结果
+3. 生成报告
+
+**Decision: 健康状态**
+- IF ERROR 级问题 → 建议执行 `uds init` 或 `uds check --restore`
+- IF WARNING 级问题 → 列出建议，用户自行决定
+- IF 全部 OK → 展示健康摘要
+
+**STOP**: 报告展示后等待用户决定
+
+### Stop Points | 停止点
+
+| 停止点 | 等待内容 |
+|--------|---------|
+| 报告展示后 | 用户决定采取行动 |
+
+### Error Handling | 错误处理
+
+| 错误条件 | AI 动作 |
+|----------|---------|
+| UDS 未安装 | 建议执行 `uds init` |
+| `.standards/` 目录不存在 | 告知 UDS 标准未安装 |
+
+## Reference | 参考
+
+- Full standard: [audit-assistant](../audit-assistant/SKILL.md)

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

@@ -7,7 +7,7 @@ status: experimental
 ---
 
 ---
-description: 引導行为驅动开发流程 | Guide through Behavior-Driven Development workflow
+description: [UDS] Guide through Behavior-Driven Development workflow
 allowed-tools: Read, Write, Grep, Glob, Bash(npm test:*), Bash(npx:*)
 argument-hint: "[要实作的行为或場景 | behavior or scenario to implement]"
 status: experimental