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

package/bundled/locales/zh-CN/skills/commands/dev-workflow.md

@@ -0,0 +1,119 @@
+---
+source: ../../../../skills/commands/dev-workflow.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+status: current
+---
+
+---
+name: dev-workflow
+description: "[UDS] Guide for mapping software development phases to UDS commands and features"
+argument-hint: "[phase name | scenario | 阶段名称 | 场景]"
+---
+
+# 开发工作流程指南
+
+将你目前的开发阶段对应到 UDS 命令。了解在每个阶段应该使用哪些工具。
+
+## 情境感知启动
+
+当调用 `/dev-workflow` 时，AI 助手必须先检查专案的工作流程状态：
+
+### 步骤 1：检查进行中的工作流程
+
+```bash
+ls .workflow-state/*.yaml .workflow-state/*.json 2>/dev/null
+```
+
+**如果有进行中的工作流程：**
+
+1. 显示进行中的工作流程摘要（名称、阶段、进度）
+2. 建议恢复："您有一个进行中的 **{workflow}**，在阶段 **{phase}**。使用 `/{command}` 继续？"
+3. 根据当前阶段显示适当的下一步命令
+
+**阶段 → 下一步命令对应：**
+
+| Workflow | Current Phase | Suggested Next Command |
+|----------|--------------|----------------------|
+| SDD | discuss | `/sdd create` |
+| SDD | create | `/sdd review` |
+| SDD | review | `/sdd approve` |
+| SDD | approve | `/sdd implement` |
+| SDD | implement | `/sdd verify` |
+| TDD | red | 编写失败测试，然后运行测试 |
+| TDD | green | 编写最小代码以通过 |
+| TDD | refactor | 清理后使用 `/tdd` 进入下一个循环 |
+| BDD | discovery | `/bdd` 以制定场景 |
+| BDD | formulation | 编写 `.feature` 文件 |
+| BDD | automation | 实作步骤定义 |
+
+**如果没有进行中的工作流程：**
+
+继续显示下方的标准阶段概览。
+
+### 步骤 2：检查活跃规格
+
+```bash
+ls docs/specs/SPEC-*.md 2>/dev/null
+```
+
+如果存在活跃规格，突出显示并建议适当的工作流程阶段。
+
+---
+
+## 用法
+
+```bash
+/dev-workflow                    # 显示完整阶段概览
+/dev-workflow planning           # 阶段 I：规划与设计
+/dev-workflow testing            # 阶段 II：测试驱动开发
+/dev-workflow implementation     # 阶段 III：实作
+/dev-workflow quality            # 阶段 IV：质量关卡
+/dev-workflow release            # 阶段 V：发布与提交
+/dev-workflow docs               # 阶段 VI：文档
+/dev-workflow standards          # 阶段 VII：工具与标准
+/dev-workflow advanced           # 阶段 VIII：进阶分析
+/dev-workflow new-feature        # 场景：新功能工作流程
+/dev-workflow bug-fix            # 场景：修复错误工作流程
+/dev-workflow refactoring        # 场景：重构工作流程
+```
+
+## 快速对照表
+
+| Phase | UDS Commands | 用途 |
+|-------|-------------|------|
+| **I. 规划** | `/brainstorm` `/requirement` `/sdd` `/reverse` | 需求、规格、逆向工程 |
+| **II. 测试** | `/bdd` `/atdd` `/tdd` `/coverage` `/derive` | 先写测试再写代码 |
+| **III. 实作** | `/refactor` `/reverse` | 编写与改善代码 |
+| **IV. 质量** | `/checkin` `/review` | 提交前检查与审查 |
+| **V. 发布** | `/commit` `/changelog` `/release` | 版本、提交、发布 |
+| **VI. 文档** | `/docs` `/docgen` `/struct` | 文档与专案结构 |
+| **VII. 标准** | `/discover` `/guide` | 参考指南 |
+| **VIII. 进阶** | `/methodology` | 跨方法论工作流程 |
+
+## 常见场景
+
+### 新功能
+
+```
+/brainstorm → /requirement → /sdd → /derive → /tdd → /checkin → /commit
+```
+
+### 修复错误
+
+```
+/discover → /reverse → /tdd → /checkin → /commit
+```
+
+### 重构
+
+```
+/discover → /reverse → /coverage → /refactor → /checkin → /commit
+```
+
+## 参考
+
+- [开发工作流程技能](../dev-workflow-guide/SKILL.md)
+- [详细阶段指南](../dev-workflow-guide/workflow-phases.md)
+- [日常工作流程指南](../../adoption/DAILY-WORKFLOW-GUIDE.md)

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

@@ -0,0 +1,86 @@
+---
+source: ../../../../skills/commands/discover.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+status: current
+---
+
+---
+name: discover
+description: "[UDS] Assess project health, architecture, and risks before adding features"
+argument-hint: "[feature area | 功能范围]"
+---
+
+# 专案现况评估
+
+在既有代码库新增功能前的 Phase 0 评估。评估专案健康度、架构与风险。
+
+## 用法
+
+```bash
+/discover [feature area]
+```
+
+## 评估维度
+
+| 维度 | 检查项目 |
+|------|----------|
+| **架构** | 模组结构、依赖图、入口点 |
+| **依赖** | 过时套件、已知漏洞、授权风险 |
+| **测试覆盖率** | 现有测试、覆盖率缺口、测试质量 |
+| **安全** | `npm audit` 发现、硬编码密钥、暴露端点 |
+| **技术债** | TODO 标记、代码重复、复杂度热点 |
+
+## 工作流程
+
+1. **扫描专案** - 读取 package.json、目录结构、配置文件
+2. **分析架构** - 映射模组、依赖关系和数据流
+3. **检查依赖** - 运行 `npm outdated`、`npm audit` 获取健康信号
+4. **评估风险** - 识别复杂度热点、缺失测试、安全问题
+5. **生成报告** - 输出健康评分与可执行建议
+6. **决定下一步** - 根据发现结果判断 GO / NO-GO / CONDITIONAL
+
+## 范例
+
+```bash
+/discover                # 完整专案健康评估
+/discover auth           # 针对认证相关模组的集中评估
+/discover payments       # 评估新增支付功能前的风险
+```
+
+## 输出格式
+
+```
+Project Health Report
+=====================
+Overall Score: 7.2 / 10
+
+| Dimension       | Score | Status  | Key Finding            |
+|-----------------|-------|---------|------------------------|
+| Architecture    | 8/10  | Good    | Clean module boundaries |
+| Dependencies    | 6/10  | Warning | 5 outdated, 1 critical |
+| Test Coverage   | 7/10  | Fair    | 72% line coverage      |
+| Security        | 8/10  | Good    | No critical vulns      |
+| Technical Debt  | 6/10  | Warning | 23 TODOs, 3 hotspots   |
+
+Verdict: CONDITIONAL
+Recommendations:
+1. [HIGH] Update lodash to fix CVE-2024-XXXX
+2. [MED]  Add tests for src/payments/ (0% coverage)
+3. [LOW]  Resolve TODO backlog in src/utils/
+```
+
+## 后续步骤
+
+发现评估后，典型的棕地（brownfield）工作流程为：
+
+1. `/discover` - 评估专案健康度（本命令）
+2. `/reverse spec` - 逆向工程现有代码为规格
+3. `/sdd` - 为新功能编写规格
+4. `/tdd` 或 `/bdd` - 在测试保护下实作
+
+## 参考
+
+*   [专案探索技能](../project-discovery/SKILL.md)
+*   [逆向工程规范](../../core/reverse-engineering-standards.md)

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

@@ -0,0 +1,67 @@
+---
+source: ../../../../skills/commands/docgen.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+status: current
+---
+
+---
+name: docgen
+description: "[UDS] Generate usage documentation from project sources"
+argument-hint: "[config file | 配置文件]"
+---
+
+# 文档生成器
+
+从专案原始文件生成使用文档（速查表、参考手册、使用指南）。
+
+## 用法
+
+```bash
+/docgen [config file]
+```
+
+## 工作流程
+
+1. **读取配置** - 加载 `.usage-docs.yaml`（或指定的配置文件）
+2. **扫描来源** - 读取原始文件、命令和技能定义
+3. **提取内容** - 从来源中解析描述、选项、范例
+4. **生成文档** - 以配置的格式产生输出
+5. **写入输出** - 将生成的文件保存到配置的输出目录
+
+## 输出类型
+
+| 类型 | 说明 |
+|------|------|
+| **cheatsheet** | 速查表，列出命令与快捷方式 |
+| **reference** | 完整功能参考手册含所有选项 |
+| **usage-guide** | 新手入门的逐步使用指南 |
+
+## 范例
+
+```bash
+/docgen                          # 使用默认 .usage-docs.yaml 生成文档
+/docgen .usage-docs.yaml         # 从指定配置文件生成文档
+/docgen --format cheatsheet      # 仅生成速查表
+```
+
+## 配置文件格式
+
+```yaml
+# .usage-docs.yaml
+output_dir: docs/generated/
+formats:
+  - cheatsheet
+  - reference
+sources:
+  - path: skills/commands/
+    type: commands
+  - path: cli/src/commands/
+    type: cli
+language: [en, zh-TW]
+```
+
+## 参考
+
+*   [文档生成器技能](../docs-generator/SKILL.md)

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

@@ -0,0 +1,65 @@
+---
+source: ../../../../skills/commands/docs.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+status: current
+---
+
+---
+name: docs
+description: [UDS] Manage, guide, and generate documentation.
+argument-hint: "[generate|readme|api] [options]"
+---
+
+# /docs 命令
+
+管理、编写和生成专案文档。
+
+## 用法
+
+```bash
+/docs [subcommand] [options]
+```
+
+### 子命令
+
+| Subcommand | Description |
+|------------|-------------|
+| `generate` | 生成文档产物（速查表、参考手册） |
+| `readme` | 审查并更新 README.md |
+| `api` | 从代码生成 API 文档 |
+| `structure` | 检查文档文件夹结构 |
+| `(none)` | 显示文档指南/状态 |
+
+### Generate 选项
+
+与 `/docs generate` 一起使用：
+
+| Option | Description |
+|--------|-------------|
+| `--lang <lang>` | 语言（`en`、`zh-TW`、`zh-CN`） |
+| `--cheatsheet` | 仅生成速查表 |
+| `--reference` | 仅生成功能参考 |
+| `--check` | 检查文档是否不同步 |
+
+## 范例
+
+```bash
+# 生成所有文档
+/docs generate
+
+# 生成繁体中文文档
+/docs generate --lang zh-TW
+
+# 更新 README
+/docs readme
+
+# 检查文档结构
+/docs structure
+```
+
+## 参考
+
+*   [文档指南技能](../documentation-guide/SKILL.md)
+*   [核心规范](../../core/documentation-writing-standards.md)

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

@@ -0,0 +1,87 @@
+---
+source: ../../../../skills/commands/durable.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide workflow failure recovery with checkpoints, retries and rollback strategies"
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[workflow name or failure context | 工作流名称或失败情境]"
+---
+
+# Durable Execution Assistant | 持久执行助手
+
+Guide workflow failure recovery with checkpoints, retries and rollback strategies.
+
+引导工作流程故障恢复，包含检查点、重试与回滚策略。
+
+## Workflow | 工作流程
+
+```
+DETECT ──► DIAGNOSE ──► RECOVER ──► VERIFY ──► CONTINUE
+```
+
+## Usage | 使用方式
+
+- `/durable` - 启动交互式故障恢复
+- `/durable --checkpoint` - 设计检查点策略
+- `/durable --retry` - 设计重试策略
+- `/durable --rollback` - 规划回滚策略
+- `/durable <workflow>` - 分析特定工作流程
+
+## AI Agent Behavior | AI 代理行为
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 进入路由
+
+| 输入 | AI 动作 |
+|------|---------|
+| `/durable` | 询问工作流程或失败情境，进入 DETECT |
+| `/durable --checkpoint` | 直接进入检查点策略设计 |
+| `/durable --retry` | 直接进入重试策略设计 |
+| `/durable --rollback` | 直接进入回滚策略规划 |
+| `/durable <workflow>` | 分析指定工作流程 |
+
+### Interaction Script | 交互脚本
+
+#### DETECT / DIAGNOSE
+1. 分析工作流程结构和失败点
+2. 识别需要持久化的状态
+
+**Decision: 故障类型**
+- IF 暂时性故障（网络、超时） → 建议重试策略（exponential backoff）
+- IF 数据不一致 → 建议检查点 + 补偿事务
+- IF 不可逆失败 → 建议回滚策略
+
+**STOP**: 诊断结果展示后等待用户确认策略方向
+
+#### RECOVER
+1. 设计选定的恢复策略
+2. 展示策略细节和代码建议
+
+**STOP**: 策略设计后等待用户确认
+
+#### VERIFY
+1. 建议验证步骤确认恢复成功
+
+### Stop Points | 停止点
+
+| 阶段 | 停止点 | 等待内容 |
+|------|--------|---------|
+| DIAGNOSE | 诊断结果后 | 确认策略方向 |
+| RECOVER | 策略设计后 | 确认实施 |
+
+### Error Handling | 错误处理
+
+| 错误条件 | AI 动作 |
+|----------|---------|
+| 无法识别工作流程模式 | 询问用户描述工作流程步骤 |
+| 多种故障类型并存 | 逐一分析，建议组合策略 |
+
+## Reference | 参考
+
+- Full standard: [durable-execution-assistant](../durable-execution-assistant/SKILL.md)

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

@@ -0,0 +1,52 @@
+---
+source: ../../../../skills/commands/guide.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+status: current
+---
+
+---
+name: guide
+description: [UDS] Access Universal Development Standards guides and references.
+---
+
+# /guide 命令
+
+> **语言**: [English](../../../../skills/commands/guide.md) | 简体中文
+
+`/guide` 命令是访问所有 Universal Development Standards 参考资料和指南的中央入口。
+
+## 用法
+
+```bash
+/guide [topic]
+```
+
+## 可用主题
+
+| 主题 | 说明 | 来源 |
+|------|------|------|
+| `git` | Git 工作流与分支策略 | `skills/git-workflow-guide/` |
+| `testing` | 测试金字塔与策略 | `skills/testing-guide/` |
+| `errors` | 错误码设计规范 | `skills/error-code-guide/` |
+| `logging` | 结构化日志规范 | `skills/logging-guide/` |
+| `structure` | 专案结构约定 | `skills/project-structure-guide/` |
+| `ai-arch` | AI 友好的架构 | `skills/ai-friendly-architecture/` |
+| `ai-collab` | AI 协作与防幻觉 | `skills/ai-collaboration-standards/` |
+| `ai-instruct` | AI 指令文件规范 | `skills/ai-instruction-standards/` |
+
+## 范例
+
+- `/guide git` - 显示 Git 分支与命名约定
+- `/guide testing` - 显示测试金字塔与最佳实践
+- `/guide structure` - 显示推荐的专案文件夹结构
+- `/guide` - 列出所有可用指南
+
+## AI 实作说明
+
+当用户调用 `/guide [topic]` 时：
+1.  识别请求的主题。
+2.  读取对应的规范/技能文件（例如 `skills/git-workflow-guide/SKILL.md`）。
+3.  向用户摘要或呈现该文件的关键信息。
+4.  如果主题缺失或无效，列出可用主题。

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

@@ -0,0 +1,92 @@
+---
+source: ../../../../skills/commands/incident.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide incident response, root cause analysis and post-mortem documentation"
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[incident description or severity | 事故描述或严重程度]"
+---
+
+# Incident Response Assistant | 事故响应助手
+
+Guide incident response, root cause analysis and post-mortem documentation.
+
+引导事故响应、根因分析和事后复盘文档撰写。
+
+## Workflow | 工作流程
+
+```
+DETECT ──► TRIAGE ──► MITIGATE ──► RESOLVE ──► POST-MORTEM
+```
+
+## Usage | 使用方式
+
+- `/incident` - 启动交互式事故响应
+- `/incident "API 500 errors"` - 响应特定事故
+- `/incident --post-mortem` - 为已解决事故撰写复盘文档
+- `/incident --sev1` - 启动 SEV1 响应协议
+
+## AI Agent Behavior | AI 代理行为
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 进入路由
+
+| 输入 | AI 动作 |
+|------|---------|
+| `/incident` | 询问事故描述和严重程度，进入 DETECT |
+| `/incident "description"` | 以描述为起点，进入 TRIAGE |
+| `/incident --post-mortem` | 直接进入 POST-MORTEM 阶段 |
+| `/incident --sev1` | 启动 SEV1 紧急响应协议 |
+
+### Interaction Script | 交互脚本
+
+#### DETECT / TRIAGE
+1. 收集事故症状和影响范围
+2. 评估严重程度（SEV1-4）
+
+**Decision: 严重程度**
+- IF SEV1/SEV2 → 立即列出紧急行动清单，建议通知相关人员
+- IF SEV3/SEV4 → 按标准流程排查
+
+**STOP**: 严重程度评估后等待用户确认
+
+#### MITIGATE
+1. 建议即时缓解措施
+2. 追踪缓解状态
+
+#### RESOLVE
+1. 引导根因分析（5 Whys）
+2. 建议修复方案
+
+**STOP**: 修复方案确认后等待用户确认实施
+
+#### POST-MORTEM
+1. 收集时间线、根因、影响
+2. 生成事后复盘文档
+
+**STOP**: 文档生成后等待用户确认写入
+
+### Stop Points | 停止点
+
+| 阶段 | 停止点 | 等待内容 |
+|------|--------|---------|
+| TRIAGE | 严重程度评估后 | 确认分级 |
+| RESOLVE | 修复方案提出后 | 确认实施 |
+| POST-MORTEM | 文档生成后 | 确认写入 |
+
+### Error Handling | 错误处理
+
+| 错误条件 | AI 动作 |
+|----------|---------|
+| 无法判断严重程度 | 列出分级标准，请用户选择 |
+| 缺乏足够症状信息 | 引导收集更多信息（日志、监控、错误消息） |
+
+## Reference | 参考
+
+- Full standard: [incident-response-assistant](../incident-response-assistant/SKILL.md)