claude-pangu 2.0.13 → 2.0.17

package/README.md

@@ -133,6 +133,13 @@ oh-my-claude 的核心理念源自「愚公移山」的精神：**只要方向
 
 ## 📦 安装
 
+> ⚠️ **前提条件**: 需要先安装 Claude Code。Claude Code 现已切换为原生安装器：
+> ```bash
+> # 安装 Claude Code（如果尚未安装）
+> claude install
+> # 或访问 https://docs.anthropic.com/en/docs/claude-code/getting-started
+> ```
+
 提供多种安装方式，选择最适合你的：
 
 ### 方式一：npm / npx（推荐）
@@ -284,6 +291,30 @@ rm ~/.claude.json
 
 ## 🚀 快速开始
 
+### 🆕 极简入口（v2.0.14 新增）
+
+**不想记命令？只需要这一个：**
+
+```bash
+/do 你想做的任何事情
+```
+
+就是这么简单。比如：
+
+- `/do 实现用户登录功能`
+- `/do 修复这个报错`
+- `/do 优化这段代码的性能`
+
+**其他快捷命令：**
+
+| 命令             | 功能         | 示例                    |
+| ---------------- | ------------ | ----------------------- |
+| `/do [任务]`     | 极简万能入口 | `/do 添加深色模式`      |
+| `/suggest [描述]`| 智能命令推荐 | `/suggest 我想优化性能` |
+| `/cheatsheet`    | 快速参考卡   | `/cheatsheet`           |
+
+> 💡 `/do` 等同于 `/yishan`，但更短更直观。如果你只想记一个命令，记住 `/do` 就够了。
+
 ### ⚡ 30秒速查表
 
 ```text
@@ -488,6 +519,9 @@ oh-my-claude/
 
 | 命令 | 功能 |
 |------|------|
+| `/do` | 🚀 极简万能入口（等同 /yishan） |
+| `/suggest` | 🎯 智能命令推荐 |
+| `/cheatsheet` | 📋 快速参考卡 |
 | `/progress` | 📊 可视化进度面板 |
 | `/team` | 🤝 多 Agent 团队协作 |
 
@@ -738,6 +772,11 @@ model: sonnet
 - [x] v2.0.9 - **卸载残留检测修复** 🐛（插件目录不存在时仍清理 commands/skills 残留）
 - [x] v2.0.10 - **备用清理列表生效** 🐛（修复动态扫描返回空时未使用备用列表）
 - [x] v2.0.11 - **始终完整清理** 🐛（避免 npx 旧版缓存导致清理不完整）
+- [x] v2.0.12 - **CI 构建修复** 🐛（移除未使用变量和函数）
+- [x] v2.0.13 - **历史版本检测增强** 🔍（支持仅有 zcf 目录的旧版本检测）
+- [x] v2.0.14 - **易用性增强** ✨（新增 `/do` 极简入口、`/suggest` 智能推荐、`/cheatsheet` 速查表）
+- [x] v2.0.15 - **用户体验深度优化** 🎯（新增 `/what` 意图识别、`/quickfix` 快速修复、`/recipes` 场景指南）
+- [x] v2.0.16 - **活跃会话命令文档** 📖（斜杠命令限制说明、自然语言替代方案、Linux 兼容性修复）
 
 ## 🤝 贡献
 

package/README_EN.md

@@ -130,6 +130,13 @@ Auto-configured on installation, no manual setup required:
 
 ## 📦 Installation
 
+> ⚠️ **Prerequisites**: You need to install Claude Code first. Claude Code now uses a native installer:
+> ```bash
+> # Install Claude Code (if not already installed)
+> claude install
+> # Or visit https://docs.anthropic.com/en/docs/claude-code/getting-started
+> ```
+
 Multiple installation methods available - choose what works best for you:
 
 ### Option 1: npm / npx (Recommended)
@@ -564,6 +571,11 @@ The legendary creator of Chinese characters, who served as a historian during th
 - [x] v1.5.0 - P2 enhancement features (JSONC config, Monitor Hooks)
 - [x] v1.6.0 - **Feature alignment complete** 🎯 (~95% aligned with oh-my-opencode)
 - [x] v1.7.0 - **100% Feature Alignment** 🚀 (MCP auto-install, Session tools, new Agents)
+- [x] v2.0.0 - **Major Update** ✨ (npm package renamed to claude-pangu, CLI installation simplified)
+- [x] v2.0.1~v2.0.13 - Bug fixes and stability improvements
+- [x] v2.0.14 - **Usability Enhancement** ✨ (New `/do`, `/suggest`, `/cheatsheet` commands)
+- [x] v2.0.15 - **Deep UX Optimization** 🎯 (New `/what`, `/quickfix`, `/recipes` commands)
+- [x] v2.0.16 - **Session Command Docs** 📖 (Slash command limitation docs, natural language alternatives, Linux compatibility)
 
 ## 🤝 Contributing
 

package/commands/agents.md

@@ -0,0 +1,148 @@
+# Agent 发现中心 (Agent Discovery)
+
+快速查看所有可用的 Agent 专家及其专长。
+
+---
+
+## 使用方式
+
+```
+/agents [分类关键词]
+```
+
+无参数显示所有 Agent 分类视图。
+
+---
+
+## Agent 分类视图
+
+### 按功能分类
+
+当用户输入 `/agents` 无参数时，显示：
+
+```text
+╔══════════════════════════════════════════════════════════════╗
+║  🏔️ oh-my-claude 专家团队                                    ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  🚀 开发实现                                                  ║
+║  ─────────────────────────────────────────────────────────   ║
+║  /yishan  愚公   大任务持续执行    /luban   鲁班   精细代码实现 ║
+║  /gukaizhi 顾恺之 UI/UX界面设计   /cangjie 仓颉   数据库设计   ║
+║                                                              ║
+║  🔍 问题诊断                                                  ║
+║  ─────────────────────────────────────────────────────────   ║
+║  /bianque 扁鹊   Bug诊断修复      /wukong  悟空   代码探索定位 ║
+║  /sunzi   孙子   性能分析优化                                  ║
+║                                                              ║
+║  ✅ 质量保障                                                  ║
+║  ─────────────────────────────────────────────────────────   ║
+║  /baozheng 包拯  测试设计验证     /weizheng 魏征  代码审查规范 ║
+║  /mozi    墨子   安全审计防护     /laozi   老子   代码简化重构 ║
+║                                                              ║
+║  📐 设计规划                                                  ║
+║  ─────────────────────────────────────────────────────────   ║
+║  /zhuge   诸葛   架构战略设计     /libai   李白   需求分析提炼 ║
+║  /liubowen 刘伯温 计划审查验证                                 ║
+║                                                              ║
+║  📝 文档运维                                                  ║
+║  ─────────────────────────────────────────────────────────   ║
+║  /simaqian 司马迁 文档撰写记录    /libing  李冰   DevOps基础设施║
+║  /change  嫦娥   云服务部署       /zhangheng 张衡 系统监控告警 ║
+║  /zhenghe 郑和   API集成对接                                  ║
+║                                                              ║
+║  🖼️ 多模态                                                   ║
+║  ─────────────────────────────────────────────────────────   ║
+║  /lilou   离娄   图像PDF分析                                  ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+
+💡 输入 /agents [关键词] 筛选，如: /agents 测试
+```
+
+---
+
+## 关键词筛选
+
+| 关键词 | 显示的 Agent | 
+|--------|--------------|
+| 开发/实现/dev | 愚公、鲁班、顾恺之、仓颉 |
+| 诊断/debug/bug | 扁鹊、悟空、孙子 |
+| 质量/quality | 包拯、魏征、墨子、老子 |
+| 设计/design | 诸葛、李白、刘伯温 |
+| 文档/运维/ops | 司马迁、李冰、嫦娥、张衡、郑和 |
+| 前端/ui/ux | 顾恺之、鲁班 |
+| 后端/api | 鲁班、郑和、仓颉 |
+| 测试/test | 包拯 |
+| 安全/security | 墨子 |
+| 性能/perf | 孙子 |
+
+---
+
+## Agent 详情查看
+
+查看单个 Agent 的详细信息：
+
+```
+/agents 扁鹊
+```
+
+输出：
+```text
+🩺 扁鹊 (BianQue) - Bug 诊断专家
+
+📜 背景: 战国时期神医，创立望闻问切四诊法
+
+🎯 专长:
+  • 错误信息分析
+  • 问题根因定位
+  • 修复方案设计
+  • 预防建议
+
+📖 使用示例:
+  /bianque TypeError: Cannot read property 'name' of undefined
+  /bianque 分析这个 500 错误
+  /bianque 为什么用户登录会失败
+
+🔗 相关命令:
+  • /wukong - 代码探索（先找再诊断）
+  • /baozheng - 测试验证（诊断后测试）
+  • /retry - 重试上次操作
+```
+
+---
+
+## 场景推荐
+
+### 不知道该用谁？
+
+```
+/agents 推荐
+```
+
+显示智能推荐引导：
+
+```text
+🎯 不知道用哪个 Agent？
+
+告诉我你想做什么，我来推荐:
+
+1. 想实现一个功能 → /yishan (愚公持续执行)
+2. 遇到报错/Bug → /bianque (扁鹊诊断)
+3. 找代码在哪 → /wukong (悟空探索)
+4. 审查代码质量 → /weizheng (魏征审查)
+5. 设计架构方案 → /zhuge (诸葛顾问)
+
+或者直接用: /do [任务描述]
+系统会自动选择合适的 Agent！
+```
+
+---
+
+## 别名
+
+- `/agents` - 主命令
+- `/team-list` - 英文别名
+- `/专家` - 中文别名
+- `/who` - 简写
+

package/commands/cancel-yishan.md

@@ -1,68 +1,68 @@
----
-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 列表会保留，可以稍后继续处理
-
-## 执行
-
-现在请删除状态文件以取消循环。
+---
+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/cheatsheet.md

@@ -0,0 +1,89 @@
+# oh-my-claude 快速参考卡 (Cheatsheet)
+
+显示常用命令速查表，帮助快速找到需要的命令。
+
+---
+
+## 🎯 核心三剑客（必记）
+
+```
+/yishan [任务]    持续执行直到完成（万能命令）
+/wukong [搜索]    快速探索代码库
+/help [关键词]    查询帮助和推荐
+```
+
+---
+
+## 🛠️ 按场景选择
+
+### 📝 写代码
+```
+/luban      精工巧匠 - 代码实现
+/gukaizhi   顾恺之 - UI/前端开发
+/cangjie    仓颉 - 数据库设计
+```
+
+### 🐛 修 Bug
+```
+/bianque    扁鹊 - Bug诊断修复
+/wukong     悟空 - 定位问题代码
+```
+
+### 🏗️ 架构设计
+```
+/zhuge      诸葛 - 架构战略顾问
+/libai      李白 - 需求分析提炼
+```
+
+### ✅ 质量保证
+```
+/baozheng   包拯 - 测试设计
+/weizheng   魏征 - 代码审查
+/mozi       墨子 - 安全审计
+```
+
+### ⚡ 性能优化
+```
+/sunzi      孙子 - 性能分析
+/laozi      老子 - 代码简化
+```
+
+### 📖 文档 & Git
+```
+/simaqian   司马迁 - 文档撰写
+/git        Git操作助手
+```
+
+---
+
+## 🔄 流程控制
+
+```
+/progress   查看当前进度
+/team       启动多Agent协作
+/pause      暂停当前任务
+/cancel-yishan  取消循环执行
+```
+
+---
+
+## 💡 小技巧
+
+1. **不知道用什么？** → 直接用 `/yishan` + 描述任务
+2. **想找代码？** → `/wukong 关键词`
+3. **遇到问题？** → `/help 问题关键词`
+
+---
+
+## 🔗 别名对照
+
+| 主命令 | 别名 | 说明 |
+|--------|------|------|
+| /yishan | /yugong, /persist, /ulw, /ultrawork | 愚公移山模式 |
+| /bianque | /debug, /diagnose | Bug诊断 |
+| /wukong | /explore, /scout | 代码探索 |
+| /zhuge | /consult, /strategy | 架构顾问 |
+
+---
+
+> 💬 输入 `/help` 获取更详细的帮助

package/commands/do.md

@@ -0,0 +1,112 @@
+# 极简执行命令 (Just Do It)
+
+最简单的入口 - 直接说你要做什么，剩下的交给我。
+
+---
+
+## 核心理念
+
+**用户不需要记任何命令。**
+
+只需要：
+```
+/do [你想做的事情]
+```
+
+---
+
+## 使用方式
+
+### 基础用法
+```
+/do 给用户表添加手机号字段
+/do 修复登录页面的样式问题
+/do 写一个文件上传的API
+/do 帮我review这段代码
+/do 优化首页加载速度
+```
+
+### 等同于
+```
+/yishan [任务描述]
+```
+
+但更短、更直觉。
+
+---
+
+## 执行逻辑
+
+当收到 `/do [任务]` 时：
+
+1. **激活愚公移山模式** - 持续执行直到完成
+2. **智能任务分析** - 理解任务类型
+3. **自动分派Agent** - 根据任务调用合适的专家
+4. **全程跟踪** - TODO管理 + 进度更新
+5. **验证完成** - 确保任务真正完成
+
+---
+
+## 为什么要用 /do
+
+| 传统方式 | /do 方式 |
+|----------|----------|
+| 先想用什么命令 | 直接说任务 |
+| /zhuge 分析 → /luban 实现 | /do 实现功能 |
+| 记住20个命令 | 记住1个 |
+| 看文档选命令 | 开箱即用 |
+
+---
+
+## 示例
+
+### 示例 1: 开发功能
+```
+/do 实现一个用户注册功能，包含邮箱验证
+```
+
+### 示例 2: 修复问题
+```
+/do 修复这个TypeError: Cannot read property 'map' of undefined
+```
+
+### 示例 3: 代码优化
+```
+/do 把这个500行的函数拆分成更小的模块
+```
+
+### 示例 4: 文档撰写
+```
+/do 给这个项目写一个完整的README
+```
+
+---
+
+## 进阶技巧
+
+### 指定范围
+```
+/do 在 src/components/ 目录下添加一个按钮组件
+```
+
+### 指定约束
+```
+/do 用TypeScript重写这个模块，保持API不变
+```
+
+### 指定验证
+```
+/do 添加登录功能，确保测试通过
+```
+
+---
+
+## 与其他命令的关系
+
+- `/do` = `/yishan` 的简写
+- 如果你知道具体要找谁，可以直接用 `/zhuge`、`/bianque` 等
+- 不确定？就用 `/do`，系统会帮你找对的人
+
+---
+
+> 💡 **记住一个命令就够了: /do**