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

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

@@ -0,0 +1,337 @@
+---
+description: [UDS] Update development standards to latest version
+allowed-tools: Read, Bash(uds update:*), Bash(uds check:*), Bash(uds configure:*), Bash(npx:*), Bash(cat .standards/*), Bash(ls .claude/*), Bash(ls .opencode/*), Bash(ls .github/*)
+argument-hint: "[--yes] [--offline] [--beta]"
+---
+
+# Update Standards | 更新标准
+
+Update Universal Development Standards to the latest version.
+
+将 Universal Development Standards 更新至最新版本。
+
+## Interactive Mode (Default) | 交互模式（默认）
+
+When invoked without `--yes`, use AskUserQuestion to confirm update preferences.
+
+当不带 `--yes` 执行时，使用 AskUserQuestion 确认更新偏好。
+
+### Step 1: Check Current Status | 步骤 1：检查当前状态
+
+First, run `uds check --summary` to show compact installation status.
+
+首先，执行 `uds check --summary` 显示精简安装状态。
+
+```bash
+uds check --summary
+```
+
+This shows: version (with update indicator), level, files status, Skills status, and Commands status.
+
+### Step 2: Ask Update Preferences | 步骤 2：询问更新偏好
+
+If updates are available, use AskUserQuestion with options based on version type.
+
+根据可用更新的版本类型显示对应选项。
+
+#### Pre-release Version Types | Pre-release 版本类型
+
+Pre-release versions are sorted by stability (ascending):
+
+Pre-release 版本按稳定度排序（由低到高）：
+
+| Type | Stability | Description | 说明 |
+|------|-----------|-------------|------|
+| alpha | Early | Features may be incomplete, for internal testing | 功能可能不完整，供内部测试 |
+| beta | Testing | Features complete, may have bugs, for early adopters | 功能大致完成，可能有 bug，供早期采用者 |
+| rc | Near-stable | Release candidate, close to stable, for beta testers | 候选发布版，接近正式版，供 beta 测试者 |
+
+Version comparison: `alpha < beta < rc < stable`
+
+For detailed versioning standards, see [core/versioning.md](../../core/versioning.md).
+
+#### Update Options | 更新选项
+
+**If stable version available (e.g., 3.5.1):**
+
+| Option | Description |
+|--------|-------------|
+| **Update Now** | 更新标准至最新稳定版 X.Y.Z（推荐） |
+| **Check Beta** | 检查 beta 版本更新 |
+| **Skip** | 目前不更新 |
+
+**If only pre-release version available, show specific type:**
+
+Detect the version type from `uds check` output and display the specific type name:
+
+| Detected Type | Option Label | Description |
+|---------------|--------------|-------------|
+| `X.Y.Z-alpha.N` | **Update to Alpha** | 更新至 alpha 版本 X.Y.Z-alpha.N（早期测试） |
+| `X.Y.Z-beta.N` | **Update to Beta** | 更新至 beta 版本 X.Y.Z-beta.N（功能大致完成） |
+| `X.Y.Z-rc.N` | **Update to RC** | 更新至 RC 版本 X.Y.Z-rc.N（接近稳定） |
+
+Always include **Skip** option: 目前不更新。
+
+**Example AskUserQuestion for beta version:**
+- Question: "有新的 beta 版本可用：3.5.1-beta.3 → 3.5.1-beta.15。您想如何处理？"
+- Option 1: "更新至 Beta (建议)" - "更新标准至 3.5.1-beta.15 版本（功能大致完成）"
+- Option 2: "暂时跳过" - "目前不进行更新，维持现有版本"
+
+### Step 3: Execute Update | 步骤 3：执行更新
+
+**If Update Now selected:**
+```bash
+uds update --yes
+```
+
+**If Check Beta selected:**
+```bash
+uds update --beta --yes
+```
+
+### Step 4: Check Skills/Commands Status | 步骤 4：检查 Skills/Commands 状态
+
+After update completes, check for missing or outdated Skills/Commands using multi-stage AskUserQuestion.
+
+更新完成后，使用多阶段 AskUserQuestion 检查缺少或过时的 Skills/Commands。
+
+**重要：** 由于 AskUserQuestion 选项有限（最多 4 个），使用多阶段方式处理不同 AI 工具和安装偏好。
+
+#### Step 4a: Detect Missing Skills | 步骤 4a：检测缺少的 Skills
+
+First, read the manifest to identify configured AI tools and their Skills status:
+
+首先读取 manifest 来识别已配置的 AI 工具及其 Skills 状态：
+
+```bash
+# Read manifest to get configured AI tools
+cat .standards/manifest.json
+# Check existing Skills installations
+ls .claude/skills/ 2>/dev/null || echo "Not installed"
+ls .opencode/skill/ 2>/dev/null || echo "Not installed"
+```
+
+For each configured AI tool that supports Skills, check if Skills are installed.
+
+#### Step 4b/4c: Ask Skills Installation (Combined) | 步骤 4b/4c：询问 Skills 安装（整合）
+
+If any configured AI tools are missing Skills, use **Smart Grouping** strategy.
+
+如果有已配置的 AI 工具缺少 Skills，使用**智能分组**策略。
+
+**重要：AskUserQuestion 最多只能有 4 个选项。** 使用智能分组来处理。
+
+**Step 4b-1: Check Marketplace Status (Claude Code only)**
+
+First, check if Plugin Marketplace is already installed:
+```bash
+ls ~/.claude/plugins/universal-dev-standards@asia-ostrich 2>/dev/null && echo "Marketplace installed"
+```
+
+- If Marketplace IS installed → Show "Claude Code: ✓ 已通过 Marketplace 安装" and skip Claude Code options
+- If Marketplace NOT installed → Include Marketplace option
+
+**Step 4b-2: Apply Smart Grouping Strategy**
+
+#### Strategy A: 1-2 Tools → Combined Question | 策略 A：1-2 个工具 → 合并询问
+
+**Example (Claude Code only, Marketplace not installed):**
+```
+Question: "Skills 要安装到哪里？"
+Options:
+1. Plugin Marketplace (建议) - 自动更新，易于管理
+2. User Level (~/.claude/skills/) - 所有项目共用
+3. Project Level (.claude/skills/) - 仅此项目
+4. 跳过 - 不安装 Skills
+```
+
+**Example (OpenCode + Copilot, Claude Code already via Marketplace):**
+```
+Question: "Skills 要安装到哪里？（Claude Code: ✓ 已通过 Marketplace 安装）"
+Options:
+1. 全部 User Level - 所有项目共用
+2. 全部 Project Level (建议) - 仅此项目
+3. 跳过 - 不安装额外 Skills
+```
+
+#### Strategy B: 3+ Tools → Two-Stage Question | 策略 B：3+ 个工具 → 两阶段询问
+
+**Stage 1: Ask unified or individual**
+```
+Question: "有多个 AI 工具需要安装 Skills，安装层级要如何设定？"
+Options:
+1. 统一层级 (建议) - 所有工具使用相同层级
+2. 个别设定 - 为每个工具分别选择层级
+3. 跳过 - 不安装 Skills
+```
+
+**Stage 2a: If unified → ask level once**
+```
+Question: "所有 Skills 要安装到哪个层级？"
+Options:
+1. User Level - 所有项目共用
+2. Project Level (建议) - 仅此项目
+```
+
+**Stage 2b: If individual → per-tool questions**
+
+**Execute installation:**
+```bash
+uds configure --type skills --ai-tool opencode --skills-location project
+uds configure --type skills --ai-tool cursor --skills-location user
+```
+
+**注意：** 如果用户选择统一层级，使用 `--skills-location` 选项。如果选择个别设定，不带此选项执行以触发交互提示。
+
+#### Step 4d: Detect Missing Commands | 步骤 4d：检测缺少的 Commands
+
+Check for configured AI tools that support Commands but don't have them installed:
+
+检查已配置但尚未安装 Commands 的 AI 工具：
+
+```bash
+# Check existing Commands installations
+ls .opencode/commands/ 2>/dev/null || echo "Not installed"
+ls .github/commands/ 2>/dev/null || echo "Not installed"
+```
+
+**Note:** Not all AI tools support Commands. Tools that support Commands:
+- OpenCode (.opencode/commands/)
+- GitHub Copilot (.github/commands/)
+- Roo Code (.roo/commands/)
+- Gemini CLI (.gemini/commands/)
+
+#### Step 4e: Ask Commands Installation | 步骤 4e：询问 Commands 安装
+
+If any configured AI tools are missing Commands, use **Smart Grouping** strategy.
+
+如果有已配置的 AI 工具缺少 Commands，使用**智能分组**策略。
+
+**重要：AskUserQuestion 最多只能有 4 个选项。** 使用智能分组来处理。
+
+#### Strategy A: 1-2 Tools → Combined Question | 策略 A：1-2 个工具 → 合并询问
+
+**Example (OpenCode only):**
+```
+Question: "Commands 要安装到哪里？"
+Options:
+1. User Level (~/.config/opencode/command/) - 所有项目共用
+2. Project Level (.opencode/command/) - 仅此项目 (建议)
+3. 跳过 - 使用 Skills 即可
+```
+
+**Example (OpenCode + Copilot):**
+```
+Question: "Commands 要安装到哪里？"
+Options:
+1. 全部 User Level - 所有项目共用
+2. 全部 Project Level (建议) - 仅此项目
+3. 跳过 - 使用 Skills 即可
+```
+
+#### Strategy B: 3+ Tools → Two-Stage Question | 策略 B：3+ 个工具 → 两阶段询问
+
+**Stage 1: Ask unified or individual**
+```
+Question: "有多个 AI 工具需要安装 Commands，安装层级要如何设定？"
+Options:
+1. 统一层级 (建议) - 所有工具使用相同层级
+2. 个别设定 - 为每个工具分别选择层级
+3. 跳过 - 不安装 Commands
+```
+
+**Stage 2a: If unified → ask level once**
+```
+Question: "所有 Commands 要安装到哪个层级？"
+Options:
+1. User Level - 所有项目共用
+2. Project Level (建议) - 仅此项目
+```
+
+**Stage 2b: If individual → per-tool questions**
+
+**Execute installation:**
+```bash
+# CLI will prompt for installation level
+uds configure --type commands --ai-tool opencode
+uds configure --type commands --ai-tool copilot
+```
+
+**注意：** 指定 `--ai-tool` 时，CLI 会交互询问安装层级（project 或 user）。
+
+#### Declined Features Handling | 拒绝功能处理
+
+**重要：** CLI 会在 `manifest.declinedFeatures` 中追踪用户拒绝的选项。
+
+- 用户之前拒绝的工具不会在后续提示中显示
+- 可通过 `/config skills` 或 `/config commands` 重新安装
+- 拒绝按工具记录（例如拒绝 OpenCode 的 Skills 不影响 Claude Code）
+
+### Step 5: Explain Results | 步骤 5：说明结果
+
+After all operations complete, explain:
+1. 更新了什么（标准版本、文件数量）
+2. Skills/Commands 安装结果
+3. 遇到的任何错误
+4. 后续步骤（如果安装了 Skills 则重启 AI 工具）
+
+## Quick Mode | 快速模式
+
+When invoked with `--yes` or specific options, skip interactive questions:
+
+```bash
+/update --yes           # 无需确认直接更新
+/update --beta --yes    # 更新至 beta 版本
+/update --offline       # 跳过 npm registry 检查
+/update --skills        # 仅更新 Skills
+/update --commands      # 仅更新 Commands
+```
+
+**注意：** 在 `--yes` 模式下，CLI 显示可用 Skills/Commands 的提示但不会自动安装（保守行为）。
+
+## Options Reference | 选项参考
+
+| Option | Description | 说明 |
+|--------|-------------|------|
+| `--yes`, `-y` | Skip confirmation prompt | 跳过确认提示 |
+| `--offline` | Skip npm registry check | 跳过 npm registry 检查 |
+| `--beta` | Check for beta version updates | 检查 beta 版本更新 |
+| `--skills` | Update Skills only | 仅更新 Skills |
+| `--commands` | Update Commands only | 仅更新 Commands |
+| `--integrations-only` | Regenerate integration files only | 仅重新生成集成文件 |
+| `--sync-refs` | Sync integration file references | 同步集成文件引用 |
+| `--standards-only` | Update standards without integrations | 仅更新标准，不更新集成 |
+
+## What Gets Updated | 更新内容
+
+- `.standards/` 目录中的标准文件
+- 扩展文件（语言、框架、区域设置）
+- 集成文件（`.cursorrules`、`CLAUDE.md` 等）
+- `manifest.json` 中的版本信息
+
+## Skills Update | Skills 更新
+
+Skills are managed separately:
+
+| Installation | Update Method | 更新方法 |
+|--------------|---------------|----------|
+| Plugin Marketplace | Auto-updates on Claude Code restart | 重启 Claude Code 自动更新 |
+| User-level | `cd ~/.claude/skills && git pull` | 手动更新 |
+| Project-level | `cd .claude/skills && git pull` | 手动更新 |
+
+## Troubleshooting | 故障排查
+
+**"Standards not initialized"**
+- 先运行 `/init` 初始化标准
+
+**"Already up to date"**
+- 无需操作；标准已是最新
+
+**"Skills previously declined"**
+- 运行 `/config skills` 重新安装被拒绝的 Skills
+
+## Reference | 参考
+
+- CLI documentation: `uds update --help`
+- Check command: [/check](./check.md)
+- Config command: [/config](./config.md)

package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md

@@ -60,9 +60,8 @@ description: |
 `/commit` 完成后，AI 助手应建议：
 
 > **提交完成。建议下一步：**
-> - 执行 `/changelog` 更新变更日志
 > - 执行 `git push` 推送到远端
-> - 执行 `/release`（若准备发布）
+> - 准备发布时 → 执行 `/changelog` + `/release`
 > - 发现重复模式或规范摩擦 → 执行 `/audit --report` 回报
 
 ## 参考

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

@@ -0,0 +1,97 @@
+---
+source: ../../../../skills/database-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-23
+status: current
+description: |
+  引导数据库设计、迁移规划和查询优化。
+  使用时机：schema 设计、迁移规划、查询优化、索引策略。
+  关键字：database, schema, migration, SQL, index, query, 数据库, 迁移, 查询。
+---
+
+# 数据库助手
+
+> **语言**: [English](../../../../skills/database-assistant/SKILL.md) | 简体中文
+
+引导数据库设计、迁移规划和查询优化。
+
+## 核心原则
+
+| 原则 | 说明 |
+|------|------|
+| 规范化 | 消除冗余（至少 3NF） |
+| 参照完整性 | 强制外键约束 |
+| 索引策略 | 依查询模式建立索引 |
+| 迁移安全 | 可逆、零停机 |
+| 数据保护 | 加密敏感字段、审计访问 |
+
+## Schema 设计检查清单
+
+- [ ] 主键已定义（建议 UUID 或 BIGINT）
+- [ ] 外键含适当的 ON DELETE/UPDATE 策略
+- [ ] 必填字段加 NOT NULL 约束
+- [ ] 常查询字段建立索引
+- [ ] 所有表加创建/更新时间戳
+- [ ] 敏感数据静态加密
+- [ ] 命名惯例一致（snake_case）
+
+## 规范化快速参考
+
+| 范式 | 规则 |
+|------|------|
+| **1NF** | 原子值、无重复组 |
+| **2NF** | 1NF + 无部分依赖 |
+| **3NF** | 2NF + 无传递依赖 |
+| **反规范化** | 仅针对已证实的读取性能需求 |
+
+## 迁移工作流程
+
+```
+PLAN ──► WRITE ──► TEST ──► DEPLOY ──► VERIFY
+```
+
+### 1. Plan — 评估影响
+识别受影响的表、估算数据量、规划回滚策略。
+
+### 2. Write — 编写迁移
+编写正向和回滚脚本。使用递增编号的迁移。
+
+### 3. Test — 验证迁移
+在 staging 环境使用类生产数据执行。验证迁移后数据完整性。
+
+### 4. Deploy — 执行迁移
+在维护窗口执行，或使用在线 Schema 变更工具。
+
+### 5. Verify — 确认成功
+检查行数、约束有效性、应用程序功能。
+
+## 索引策略
+
+| 类型 | 使用场景 |
+|------|----------|
+| B-tree | 等值、范围查询（默认） |
+| Hash | 仅精确匹配 |
+| GIN | 全文搜索、JSONB |
+| Partial | 过滤子集 |
+| Composite | 多字段查询 |
+
+## 使用方式
+
+- `/database` - 交互式数据库设计引导
+- `/database schema` - 审查 Schema 设计
+- `/database --migration` - 迁移规划助手
+
+## 下一步引导
+
+`/database` 完成后，AI 助手应建议：
+
+> **数据库设计完成。建议下一步：**
+> - 执行 `/security` 检查数据保护措施
+> - 执行 `/testing` 规划数据库测试策略
+> - 执行 `/checkin` 确认迁移符合提交规范
+> - 生成 API 端点 → 执行 `/api-design`
+
+## 参考
+
+- 核心规范：[database-standards.md](../../../../core/database-standards.md)

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

@@ -0,0 +1,145 @@
+---
+source: ../../../../skills/dev-workflow-guide/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-24
+status: current
+description: |
+  将软件开发阶段对应到 UDS 命令与技能。
+  使用时机：查找适用的 UDS 命令、规划开发流程、新手入门。
+  关键字：workflow, development-phases, commands, 工作流程, 开发阶段。
+---
+
+# 开发工作流程指南
+
+> **语言**: [English](../../../../skills/dev-workflow-guide/SKILL.md) | 简体中文
+
+将你目前的软件开发阶段对应到正确的 UDS 命令与技能。即时了解在开发的每个阶段应该使用哪些工具。
+
+> **相关**：如需选择或切换开发方法论（SDD、BDD、TDD），请改用 `/methodology`。
+
+## 软件开发阶段总览
+
+```
+I. Planning ──► II. Testing Design ──► III. Implementation ──► IV. Quality Gates
+   需求设计          测试驱动开发            代码开发              品质保证
+
+V. Release ──► VI. Documentation ──► VII. Standards ──► VIII. Advanced
+   版本提交         文档与架构              工具与标准           进阶分析
+```
+
+### 快速对照表
+
+| 阶段 | UDS 命令 | 用途 |
+|------|---------|------|
+| **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` `/testing` `/guide` `/git` | 参考指南 |
+| **VIII. 进阶分析** | `/methodology` | 跨方法论工作流程 |
+
+## 常见场景
+
+### 场景 1：新功能开发
+
+从零开始构建新功能的推荐流程：
+
+```
+/brainstorm → /requirement → /sdd → /derive → /tdd → /checkin → /commit
+```
+
+| 步骤 | 命令 | 做什么 |
+|------|------|--------|
+| 1 | `/brainstorm` | 探索想法与方法 |
+| 2 | `/requirement` | 撰写用户故事 |
+| 3 | `/sdd` | 创建规格文件 |
+| 4 | `/derive` | 从规格产生测试骨架 |
+| 5 | `/tdd` | 用红绿重构循环实现 |
+| 6 | `/checkin` | 验证品质关卡 |
+| 7 | `/commit` | 创建规范化提交 |
+
+### 场景 2：修复错误
+
+修复既有代码错误的推荐流程：
+
+```
+/discover → /reverse → /tdd → /checkin → /commit
+```
+
+| 步骤 | 命令 | 做什么 |
+|------|------|--------|
+| 1 | `/discover` | 评估受影响区域健康度 |
+| 2 | `/reverse` | 理解现有代码结构 |
+| 3 | `/tdd` | 先写失败测试，再修复 |
+| 4 | `/checkin` | 验证品质关卡 |
+| 5 | `/commit` | 创建规范化提交 |
+
+### 场景 3：重构
+
+代码重构的推荐流程：
+
+```
+/discover → /reverse → /coverage → /refactor → /checkin → /commit
+```
+
+| 步骤 | 命令 | 做什么 |
+|------|------|--------|
+| 1 | `/discover` | 评估项目健康度与风险 |
+| 2 | `/reverse` | 记录目前行为 |
+| 3 | `/coverage` | 确保测试安全网存在 |
+| 4 | `/refactor` | 套用重构策略 |
+| 5 | `/checkin` | 验证品质关卡 |
+| 6 | `/commit` | 创建规范化提交 |
+
+## 使用方式
+
+```bash
+/dev-workflow                    # 显示完整阶段总览
+/dev-workflow planning           # 获取第一阶段指引
+/dev-workflow testing            # 获取第二阶段指引
+/dev-workflow new-feature        # 获取新功能工作流程
+/dev-workflow bug-fix            # 获取修复错误工作流程
+/dev-workflow refactoring        # 获取重构工作流程
+```
+
+### 支持的参数
+
+| 参数 | 说明 |
+|------|------|
+| `planning` | 第一阶段：规划与设计 |
+| `testing` | 第二阶段：测试驱动开发 |
+| `implementation` | 第三阶段：实现 |
+| `quality` | 第四阶段：品质关卡 |
+| `release` | 第五阶段：发布与提交 |
+| `docs` | 第六阶段：文档 |
+| `standards` | 第七阶段：工具与标准 |
+| `advanced` | 第八阶段：进阶系统分析 |
+| `new-feature` | 场景：新功能开发 |
+| `bug-fix` | 场景：修复错误 |
+| `refactoring` | 场景：重构 |
+
+## 工作流程行为
+
+调用时：
+
+1. **无参数**：显示完整的阶段总览表，询问用户目前在哪个阶段
+2. **阶段参数**：显示该阶段的详细指引，包含所有相关命令与示例
+3. **场景参数**：显示该场景的推荐逐步工作流程
+
+## 下一步引导
+
+`/dev-workflow` 完成后，AI 助手应根据用户情况建议：
+
+> **工作流程已显示。建议下一步：**
+> - 新功能开发 → 执行 `/brainstorm` 探索想法
+> - 修复错误 → 执行 `/discover` 评估受影响区域
+> - 重构代码 → 执行 `/discover` 评估健康度
+> - 遗留系统 → 执行 `/reverse` 进行系统考古
+
+## 参考
+
+- [详细阶段指南](./workflow-phases.md) - 完整的阶段参考
+- [日常工作流程指南](../../../../adoption/DAILY-WORKFLOW-GUIDE.md) - 综合日常工作流程指南

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

@@ -0,0 +1,84 @@
+---
+source: ../../../../skills/durable-execution-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-24
+status: current
+description: |
+  引导工作流程故障恢复，包含检查点、重试与回滚策略。
+  使用时机：工作流中途失败、需要重试逻辑、设计容错流程。
+  关键字：durable, execution, checkpoint, retry, rollback, recovery, 持久执行, 恢复。
+---
+
+# 持久执行助手
+
+> **语言**: [English](../../../../skills/durable-execution-assistant/SKILL.md) | 简体中文
+
+引导容错工作流程设计，包含自动恢复、检查点与重试策略。
+
+## 使用方式
+
+| 命令 | 用途 |
+|------|------|
+| `/durable` | 启动交互式故障恢复引导 |
+| `/durable --checkpoint` | 设计检查点策略 |
+| `/durable --retry` | 配置重试策略 |
+| `/durable --rollback` | 规划回滚程序 |
+| `/durable <workflow>` | 分析特定工作流的持久性 |
+
+## 核心概念
+
+| 概念 | 定义 |
+|------|------|
+| **检查点** | 在已知正确的位置储存执行状态 |
+| **重试** | 自动重新尝试失败的操作 |
+| **回滚** | 失败时回复到上一个已知正确状态 |
+| **幂等性** | 操作重新执行时产生相同结果 |
+| **断路器** | 失败率超过阈值时停止重试 |
+
+## 故障恢复决策树
+
+```
+侦测到故障
+├── 是否为暂时性？（网络、超时）
+│   ├── 是 → 带退避的重试
+│   └── 否 → 状态是否损坏？
+│       ├── 是 → 回滚至检查点
+│       └── 否 → 是否为逻辑错误？
+│           ├── 是 → 停止、回报、修复代码
+│           └── 否 → 带诊断信息升级处理
+```
+
+## 重试策略指南
+
+| 策略 | 使用时机 | 配置 |
+|------|---------|------|
+| **立即重试** | 罕见故障、快速操作 | 最多 2 次重试 |
+| **指数退避** | 网络/API 调用 | 基底 1s、最大 30s |
+| **断路器** | 下游服务问题 | 阈值 50%、窗口 60s |
+| **死信队列** | 重试后仍不可恢复 | 最多 5 次重试后排入队列 |
+
+## 检查点粒度
+
+| 粒度 | 使用场景 |
+|------|---------|
+| **每步骤** | 长管线（> 5 步骤） |
+| **每批次** | 批量数据处理 |
+| **每阶段** | 多阶段工作流程 |
+| **起始/结束** | 短暂的原子操作 |
+
+## 工作流程
+
+1. **侦测** - 识别故障类型与范围
+2. **诊断** - 判定根本原因类别
+3. **恢复** - 套用适当的恢复策略
+4. **验证** - 确认系统状态一致
+5. **继续** - 从上一个检查点继续
+
+## 下一步引导
+
+`/durable` 完成后，AI 助手应建议：
+
+> **持久性分析完成。建议下一步：**
+> - 执行 `/methodology` 选择适合的开发方法论
+> - 执行 `/commit` 提交持久化设计变更