claude-pangu 1.7.3 → 2.0.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://code.claude.com/plugin-schema.json",
   "name": "oh-my-claude",
-  "version": "1.7.0",
+  "version": "2.0.0",
   "description": "基于中国传统文化的 Claude Code 智能编排插件 - A Claude Code plugin inspired by Chinese traditional culture",
   "author": "ZDragon17",
   "contributors": [

package/README.md

@@ -85,6 +85,14 @@ oh-my-claude 的核心理念源自「愚公移山」的精神：**只要方向
 - ✅ 智能错误恢复
 - ✅ 进度透明报告
 
+#### 🆕 任务恢复命令 (v2.0 新增)
+
+| 命令 | 功能 | 用途 |
+|------|------|------|
+| `/retry` | 重试失败操作 | 自动恢复最近失败的命令 |
+| `/skip` | 跳过阻塞任务 | 标记任务完成并继续 |
+| `/rollback` | 回滚检查点 | 撤销更改，恢复稳定状态 |
+
 ### 🌐 中英双语支持
 
 所有命令都支持中英文：
@@ -276,6 +284,48 @@ rm ~/.claude.json
 
 ## 🚀 快速开始
 
+### ⚡ 30秒速查表
+
+```text
+┌─────────────────────────────────────────────────────────────┐
+│                 🏔️ oh-my-claude 快速参考                    │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  📋 最常用                                                  │
+│  ───────────────────────────────────────────────────────   │
+│  /yishan   大任务执行    │  /zhuge    架构设计              │
+│  /luban    代码实现      │  /bianque  Bug诊断               │
+│  /wukong   代码探索      │  /weizheng 代码审查              │
+│                                                             │
+│  🔧 专项                                                    │
+│  ───────────────────────────────────────────────────────   │
+│  /sunzi    性能优化      │  /mozi     安全审计              │
+│  /baozheng 测试设计      │  /cangjie  数据库                │
+│  /libai    需求分析      │  /simaqian 文档撰写              │
+│                                                             │
+│  🛠️ 工具                                                    │
+│  ───────────────────────────────────────────────────────   │
+│  /progress 进度面板      │  /team     团队协作              │
+│  /help     命令帮助      │  /git      Git操作               │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+> 💡 **不知道用哪个？** 输入 `/help [关键词]` 搜索，如 `/help 性能` 或 `/help api`
+
+### 🎯 3分钟上手
+
+| 我想要...    | 使用命令    | 示例                            |
+| ------------ | ----------- | ------------------------------- |
+| 实现一个功能 | `/yishan`   | `/yishan 实现用户登录功能`      |
+| 修复一个Bug  | `/bianque`  | `/bianque TypeError: xxx`       |
+| 审查代码     | `/weizheng` | `/weizheng review this code`    |
+| 优化性能     | `/sunzi`    | `/sunzi 分析这个接口为什么慢`   |
+| 设计架构     | `/zhuge`    | `/zhuge 设计微服务架构`         |
+| 探索代码     | `/wukong`   | `/wukong 找到认证相关代码`      |
+
+---
+
 ### 1. 愚公移山 - 大规模任务
 
 ```bash

package/README_EN.md

@@ -82,6 +82,14 @@ Core feature: **Never stop until it's done**
 - ✅ Intelligent error recovery
 - ✅ Transparent progress reporting
 
+#### 🆕 Task Recovery Commands (New in v2.0)
+
+| Command | Function | Usage |
+|---------|----------|-------|
+| `/retry` | Retry failed operation | Auto-recover from recent failure |
+| `/skip` | Skip blocked task | Mark complete and continue |
+| `/rollback` | Rollback to checkpoint | Undo changes, restore stable state |
+
 ### 🌐 Bilingual Support
 
 All commands support both Chinese and English:

package/commands/cancel-yishan.md

@@ -1,45 +1,68 @@
----
-name: cancel-yishan
-description: |
-  取消愚公移山循环 - 停止当前的自主循环执行。
-  别名：/stop-yishan, /cancel-yugong, /stop-loop
----
-
-# 取消愚公移山循环
-
-你需要取消当前正在进行的愚公移山循环。
-
-## 取消操作
-
-请执行以下步骤：
-
-### 1. 删除状态文件
-
-使用 Bash 工具删除状态文件：
-
-```bash
-rm -f .claude/yishan-loop.local.md
-```
-
-### 2. 确认取消
-
-删除成功后，向用户确认：
-
-```
-🛑 愚公移山循环已取消
-
-状态文件已删除：.claude/yishan-loop.local.md
-循环将在当前响应结束后停止。
-
-如需重新启动循环，请使用 /yishan 或 /yugong 命令。
-```
-
-## 注意事项
-
-- 取消操作会立即停止循环，当前响应完成后不会再继续
-- 已完成的工作不会被撤销
-- TODO 列表会保留，可以稍后继续处理
-
-## 执行
-
-现在请删除状态文件以取消循环。
+---
+name: cancel-yishan
+description: |
+  取消愚公移山循环 - 停止当前的自主循环执行。
+  别名：/stop-yishan, /cancel-yugong, /stop-loop
+---
+
+# 取消愚公移山循环
+
+你需要取消当前正在进行的愚公移山循环。
+
+## 取消操作
+
+请执行以下步骤：
+
+### 1. 删除循环状态文件
+
+使用 Bash 工具删除循环状态文件：
+
+```bash
+rm -f .claude/yishan-loop.local.md
+```
+
+### 2. 可选：清理检查点
+
+询问用户是否要清理检查点数据：
+
+```text
+💾 检测到保存的检查点数据
+
+是否同时清理检查点？
+   [1] 保留检查点（推荐，方便以后恢复）
+   [2] 清理检查点（彻底结束任务）
+```
+
+如果用户选择清理：
+
+```bash
+rm -f ~/.oh-my-claude/yishan-checkpoint.json
+```
+
+### 3. 确认取消
+
+删除成功后，向用户确认：
+
+```text
+🛑 愚公移山循环已取消
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📂 已删除: .claude/yishan-loop.local.md
+💾 检查点: [保留/已清理]
+
+循环将在当前响应结束后停止。
+
+💡 提示:
+   • /yishan-resume - 从检查点恢复（如有）
+   • /yishan [新任务] - 开始新任务
+```
+
+## 注意事项
+
+- 取消操作会立即停止循环，当前响应完成后不会再继续
+- 已完成的工作不会被撤销
+- TODO 列表会保留，可以稍后继续处理
+
+## 执行
+
+现在请删除状态文件以取消循环。

package/commands/help.md

@@ -0,0 +1,118 @@
+---
+name: help
+description: 命令发现助手 - 查找命令、获取帮助、查看速查表
+allowed-tools:
+  - Read
+  - Glob
+  - Bash
+model: haiku
+---
+
+<command-name>/help</command-name>
+
+# 命令发现助手
+
+你现在是 oh-my-claude 的命令发现助手，帮助用户找到合适的命令。
+
+## 你的职责
+
+1. **显示快速参考** - 当用户只输入 `/help` 时
+2. **搜索命令** - 当用户输入 `/help [关键词]` 时
+3. **推荐工作流** - 基于用户场景推荐命令组合
+4. **显示最近使用** - 读取用户的 Agent 使用历史
+
+## 执行流程
+
+### 步骤 1: 读取最近使用的 Agent（可选）
+
+尝试读取 `~/.oh-my-claude/agent-usage.json`，如果存在且有内容，提取最近 3 个不同的 Agent 名称。
+
+**解析方式**：
+
+1. **首选 jq**（如果可用）：
+
+   ```bash
+   jq -r '[.[].agent] | unique | .[0:3] | .[]' ~/.oh-my-claude/agent-usage.json
+   ```
+
+2. **降级方案**（无 jq 时）：
+
+   ```bash
+   grep -o '"agent"[[:space:]]*:[[:space:]]*"[^"]*"' ~/.oh-my-claude/agent-usage.json | \
+       sed 's/.*"agent"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/' | \
+       head -3 | sort -u
+   ```
+
+如果文件不存在或解析失败，跳过此步骤，不显示"最近使用"行。
+
+### 步骤 2: 显示快速参考卡
+
+当用户输入 `/help` 无参数时，显示：
+
+```text
+┌─────────────────────────────────────────────────────────────┐
+│                 🏔️ oh-my-claude 快速参考                    │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  ⏱️ 最近使用: /[agent1]  /[agent2]  /[agent3]              │
+│                                                             │
+│  📋 常用命令                                                │
+│  ───────────────────────────────────────────────────────   │
+│  /yishan   大任务执行    │  /zhuge    架构设计              │
+│  /luban    代码实现      │  /bianque  Bug诊断               │
+│  /wukong   代码探索      │  /weizheng 代码审查              │
+│                                                             │
+│  🔧 专项命令                                                │
+│  ───────────────────────────────────────────────────────   │
+│  /sunzi    性能优化      │  /mozi     安全审计              │
+│  /baozheng 测试设计      │  /cangjie  数据库                │
+│  /libai    需求分析      │  /simaqian 文档撰写              │
+│                                                             │
+│  🛠️ 工具命令                                                │
+│  ───────────────────────────────────────────────────────   │
+│  /progress 进度面板      │  /team     团队协作              │
+│  /git      Git操作       │  /refactor 重构助手              │
+│                                                             │
+│  ⚠️ 错误恢复                                                │
+│  ───────────────────────────────────────────────────────   │
+│  /retry    智能重试      │  /skip     跳过步骤              │
+│  /rollback 回滚操作      │  /bianque  诊断问题              │
+│                                                             │
+│  💡 输入 /help [关键词] 搜索 | 详细引导: /start              │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**注意**：如果没有读取到使用历史，则不显示"⏱️ 最近使用"行。
+
+## 关键词搜索映射
+
+当用户提供关键词时，按以下映射推荐：
+
+| 关键词              | 推荐命令                |
+| ------------------- | ----------------------- |
+| 认证/登录/auth      | /libai, /zhuge, /yishan |
+| bug/报错/error      | /bianque                |
+| 性能/慢/perf        | /sunzi                  |
+| 安全/security       | /mozi                   |
+| 测试/test           | /baozheng               |
+| 数据库/sql/db       | /cangjie                |
+| api/接口            | /zhenghe                |
+| 文档/doc            | /simaqian               |
+| 审查/review         | /weizheng               |
+| 重构/refactor       | /laozi, /refactor       |
+| 架构/design         | /zhuge                  |
+| 前端/ui             | /luban, /gukaizhi       |
+| 监控/monitor        | /zhangheng              |
+| devops/部署         | /libing                 |
+| 云/serverless       | /change                 |
+| 探索/搜索           | /wukong                 |
+| 大任务              | /yishan                 |
+| 错误/失败/重试      | /retry, /skip, /bianque |
+| 回滚/撤销           | /rollback               |
+
+## 响应要求
+
+1. **简洁明了** - 不要长篇大论
+2. **给出具体命令** - 用户可以直接复制使用
+3. **推荐工作流** - 复杂场景给出命令组合建议
+4. **保持友好** - 使用 emoji 增加可读性

package/commands/interrupt.md

@@ -0,0 +1,204 @@
+---
+name: interrupt
+description: 紧急任务插入 - 暂停当前任务，处理紧急事项，完成后自动提示恢复
+aliases:
+  - /紧急
+  - /urgent
+  - /插入
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - TodoWrite
+  - TodoRead
+model: sonnet
+---
+
+<command-name>/interrupt</command-name>
+
+# 紧急任务插入
+
+当用户在执行愚公移山任务时遇到紧急事项，使用此命令可以：
+
+1. 安全暂停当前任务
+2. 处理紧急任务
+3. 完成后自动提示恢复
+
+## 使用方式
+
+```bash
+/interrupt [紧急任务描述]
+```
+
+## 执行流程（严格按步骤执行）
+
+### 步骤 1: 检测并收集当前状态
+
+首先，**必须执行以下操作**：
+
+1. 读取当前 TODO 列表状态（使用 TodoRead）
+2. 收集以下信息：
+   - `completed_count`: 已完成的任务数量
+   - `in_progress_item`: 当前正在进行的任务内容
+   - `pending_count`: 待完成的任务数量
+   - `total_count`: 任务总数
+   - `context_summary`: 当前工作的简要总结
+
+### 步骤 2: 保存状态到检查点文件
+
+**必须使用 Write 工具**将状态保存到 `~/.oh-my-claude/yishan-checkpoint.json`：
+
+```json
+{
+  "version": "1.0",
+  "type": "interrupt",
+  "timestamp": "[当前 ISO 时间]",
+  "interrupt_id": "int_[时间戳]",
+  "task": {
+    "description": "[从 TODO 列表推断的主任务]",
+    "started_at": "[如有记录]"
+  },
+  "todos": [
+    // 从 TodoRead 获取的完整 TODO 列表
+  ],
+  "progress": {
+    "completed": [completed_count],
+    "in_progress": "[in_progress_item]",
+    "pending": [pending_count],
+    "total": [total_count],
+    "percent": [百分比]
+  },
+  "context_summary": "[context_summary]",
+  "urgent_task": "[用户描述的紧急任务]",
+  "status": "interrupted"
+}
+```
+
+同时保存到 `~/.oh-my-claude/interrupt-state.json` 记录中断信息。
+
+### 步骤 3: 显示暂停确认
+
+保存成功后显示：
+
+```text
+⏸️ 当前任务已暂停
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 进度快照: ████████████░░░░░░░░░░░░ [percent]% ([completed]/[total])
+🔄 暂停于: [in_progress_item]
+💾 已保存到: ~/.oh-my-claude/yishan-checkpoint.json
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🆘 开始处理紧急任务...
+```
+
+### 步骤 4: 处理紧急任务
+
+切换到紧急任务模式：
+
+```text
+🆘 紧急任务模式
+═══════════════════════════════════════════════════
+
+📋 任务: [用户描述的紧急任务]
+⏱️ 开始: [当前时间]
+
+💡 提示:
+   • 专注处理此紧急任务
+   • 完成后输入 /done 或描述已完成
+   • 如需取消紧急任务: /cancel-interrupt
+
+═══════════════════════════════════════════════════
+```
+
+### 步骤 5: 紧急任务完成后
+
+当检测到用户表示任务完成（"完成了"、"好了"、"done"等），**必须读取检查点文件**然后显示恢复提示：
+
+```text
+✅ 紧急任务已完成！
+═══════════════════════════════════════════════════
+
+📋 处理的紧急任务: [任务描述]
+⏱️ 耗时: [X] 分钟
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📂 之前暂停的任务:
+   📋 任务: [原任务描述]
+   📊 进度: 40% (4/10)
+   🔄 暂停于: [暂停的任务项]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔄 是否恢复之前的任务？
+
+   [1] /yishan-resume - 继续之前的任务
+   [2] /yishan [新任务] - 开始新任务
+   [3] 稍后再说 - 保持暂停状态
+
+═══════════════════════════════════════════════════
+```
+
+## 紧急任务状态文件
+
+保存到 `~/.oh-my-claude/interrupt-state.json`：
+
+```json
+{
+  "interrupt_id": "int_[timestamp]",
+  "started_at": "[ISO时间]",
+  "urgent_task": "[紧急任务描述]",
+  "paused_task": {
+    "checkpoint_path": "~/.oh-my-claude/yishan-checkpoint.json",
+    "progress_percent": 40,
+    "current_item": "[暂停的任务项]"
+  },
+  "status": "in_progress"
+}
+```
+
+## 特殊场景处理
+
+### 无活跃任务时
+
+```text
+ℹ️ 当前没有活跃的愚公移山任务
+
+直接处理你的任务即可，无需使用 /interrupt。
+
+💡 或者你可以:
+   • /yishan [任务描述] - 启动持续执行模式
+   • 直接描述任务，我来帮你处理
+```
+
+### 紧急任务中再次 /interrupt
+
+```text
+⚠️ 已经在紧急任务模式中
+
+当前紧急任务: [任务描述]
+
+选择操作:
+   [1] 继续当前紧急任务
+   [2] 取消当前紧急任务，处理新的紧急事项
+   [3] 完成当前紧急任务: /done
+```
+
+## 相关命令
+
+| 命令                  | 功能                       |
+| --------------------- | -------------------------- |
+| `/interrupt [任务]`   | 插入紧急任务               |
+| `/done`               | 标记紧急任务完成           |
+| `/cancel-interrupt`   | 取消紧急任务，恢复原任务   |
+| `/yishan-resume`      | 恢复之前的任务             |
+
+## 响应要求
+
+1. **快速响应** - 紧急任务需要立即处理
+2. **状态保存** - 确保原任务进度不丢失
+3. **清晰反馈** - 让用户知道当前状态
+4. **主动提醒** - 完成后主动提示恢复选项

package/commands/pause.md

@@ -0,0 +1,117 @@
+---
+name: pause
+description: 安全暂停当前任务 - 保存进度，稍后可恢复
+aliases:
+  - /暂停
+  - /yishan-pause
+allowed-tools:
+  - Write
+  - TodoRead
+model: haiku
+---
+
+<command-name>/pause</command-name>
+
+# 任务安全暂停
+
+安全暂停当前的愚公移山任务，保存进度以便后续恢复。
+
+## 职责
+
+1. 保存当前 TODO 状态
+2. 记录执行上下文
+3. 创建检查点文件
+4. 提供恢复指引
+
+## 暂停流程
+
+1. **检查当前状态**
+   - 确认是否有活跃的愚公移山任务
+   - 获取当前 TODO 列表
+
+2. **保存检查点**
+   - 保存到 `~/.oh-my-claude/yishan-checkpoint.json`
+   - 包含：任务描述、TODO 状态、参与 Agent、时间戳
+
+3. **输出确认**
+
+```text
+⏸️ 愚公移山 - 已安全暂停
+
+📊 进度快照:
+   ═══════════════════════════════════════
+   任务: [任务描述]
+   进度: ████████████░░░░░░░░░░░░ 40% (4/10)
+
+   ✅ 已完成: 4 项
+   🔄 进行中: 1 项 (实现用户登录)
+   ⏳ 待完成: 5 项
+   ═══════════════════════════════════════
+
+💾 检查点已保存
+   位置: ~/.oh-my-claude/yishan-checkpoint.json
+   时间: [当前时间]
+
+🔄 恢复方式:
+   • /yishan-resume - 从此处继续
+   • /yishan [新任务] - 开始新任务
+
+💡 提示: 检查点会保留 7 天，之后自动清理
+```
+
+## 检查点数据结构
+
+**重要**: 使用统一的检查点格式，与 `/interrupt` 保持一致。
+
+```json
+{
+  "version": "1.0",
+  "type": "pause",
+  "timestamp": "2025-01-21T10:30:00Z",
+  "task": {
+    "description": "重构认证模块",
+    "started_at": "2025-01-21T10:00:00Z"
+  },
+  "todos": [
+    {"content": "探索代码结构", "status": "completed", "activeForm": "探索代码结构"},
+    {"content": "设计实现方案", "status": "completed", "activeForm": "设计实现方案"},
+    {"content": "实现用户登录", "status": "in_progress", "activeForm": "实现用户登录"},
+    {"content": "添加单元测试", "status": "pending", "activeForm": "添加单元测试"}
+  ],
+  "progress": {
+    "completed": 2,
+    "in_progress": "实现用户登录",
+    "pending": 1,
+    "total": 4,
+    "percent": 50
+  },
+  "agents_used": ["wukong", "zhuge", "luban"],
+  "current_agent": "luban",
+  "context_summary": "已完成代码探索和方案设计，正在实现登录功能",
+  "status": "paused"
+}
+```
+
+**字段说明**:
+
+- `type`: 检查点类型，`pause` 或 `interrupt`
+- `progress`: 进度对象，便于恢复时快速显示
+- `status`: 当前状态，`paused`、`interrupted`、`resumed`
+
+## 无任务时
+
+如果没有活跃任务：
+
+```text
+ℹ️ 当前没有活跃的愚公移山任务
+
+💡 提示:
+   • /yishan [任务] - 启动新任务
+   • /yishan-resume - 恢复之前的任务（如有）
+```
+
+## 响应要求
+
+1. **确保数据保存** - 暂停必须成功保存状态
+2. **清晰的恢复路径** - 明确告知如何继续
+3. **友好的确认** - 让用户安心任务不会丢失