claude-pangu 2.1.2 → 2.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +1 -1
- package/README.md +5 -0
- package/commands/diagnose.md +471 -0
- package/commands/preferences.md +339 -0
- package/commands/progress.md +154 -0
- package/commands/tutorial.md +225 -2
- package/commands/verify.md +18 -0
- package/commands/workflow.md +510 -0
- package/hooks/agent-handoff-prompt.sh +442 -0
- package/hooks/error-friendly-display.sh +280 -0
- package/hooks/hooks.json +18 -0
- package/package.json +4 -2
- package/scripts/sync-version.cjs +31 -0
- package/skills/error-friendly/SKILL.md +346 -0
- package/skills/preferences/SKILL.md +263 -0
- package/skills/workflow/SKILL.md +218 -0
- package/skills/workflow/workflows.json +359 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://code.claude.com/plugin-schema.json",
|
|
3
3
|
"name": "oh-my-claude",
|
|
4
|
-
"version": "2.
|
|
4
|
+
"version": "2.1.4",
|
|
5
5
|
"hooks": "./hooks/hooks.json",
|
|
6
6
|
"description": "基于中国传统文化的 Claude Code 智能编排插件 - A Claude Code plugin inspired by Chinese traditional culture",
|
|
7
7
|
"author": "ZDragon17",
|
package/README.md
CHANGED
|
@@ -798,6 +798,11 @@ model: sonnet
|
|
|
798
798
|
- [x] v2.0.14 - **易用性增强** ✨（新增 `/do` 极简入口、`/suggest` 智能推荐、`/cheatsheet` 速查表）
|
|
799
799
|
- [x] v2.0.15 - **用户体验深度优化** 🎯（新增 `/what` 意图识别、`/quickfix` 快速修复、`/recipes` 场景指南）
|
|
800
800
|
- [x] v2.0.16 - **活跃会话命令文档** 📖（斜杠命令限制说明、自然语言替代方案、Linux 兼容性修复）
|
|
801
|
+
- [x] v2.1.0 - **重大功能升级** 🚀（13 个新命令、14 个技能模块、105 个测试用例）
|
|
802
|
+
- [x] v2.1.1 - **别名冲突修复** 🔧（移除与其他工具冲突的通用英文别名）
|
|
803
|
+
- [x] v2.1.2 - **用户体验简化** 🎯（`/do` 作为唯一入口、精简帮助输出）
|
|
804
|
+
- [x] v2.1.3 - **版本检测修复** 🐛（plugin.json 版本同步）
|
|
805
|
+
- [x] v2.1.4 - **用户体验第三轮** ✨（工作流模板、偏好设置、友好错误、自诊断）
|
|
801
806
|
|
|
802
807
|
## 🤝 贡献
|
|
803
808
|
|
|
@@ -0,0 +1,471 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: diagnose
|
|
3
|
+
description: 插件自诊断命令 - 全面检查 oh-my-claude 健康状态，检测问题并提供修复建议
|
|
4
|
+
aliases:
|
|
5
|
+
- /诊断
|
|
6
|
+
- /health-check
|
|
7
|
+
- /doctor
|
|
8
|
+
allowed-tools:
|
|
9
|
+
- Read
|
|
10
|
+
- Glob
|
|
11
|
+
- Bash
|
|
12
|
+
model: haiku
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
<command-name>/diagnose</command-name>
|
|
16
|
+
|
|
17
|
+
# 插件自诊断命令
|
|
18
|
+
|
|
19
|
+
全面检查 oh-my-claude 插件的运行状态，主动发现潜在问题并提供修复建议。
|
|
20
|
+
|
|
21
|
+
## 与 /verify 的区别
|
|
22
|
+
|
|
23
|
+
| 命令 | 用途 | 深度 |
|
|
24
|
+
|------|------|------|
|
|
25
|
+
| `/verify` | 安装验证 - 检查文件是否存在 | 浅层检查 |
|
|
26
|
+
| `/diagnose` | 运行诊断 - 检查功能是否正常 | 深度检查 |
|
|
27
|
+
|
|
28
|
+
## 执行流程
|
|
29
|
+
|
|
30
|
+
### 步骤 1: 显示诊断启动
|
|
31
|
+
|
|
32
|
+
```text
|
|
33
|
+
🏥 oh-my-claude 诊断中心
|
|
34
|
+
═══════════════════════════════════════════════════════════════
|
|
35
|
+
|
|
36
|
+
正在进行全面健康检查...
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### 步骤 2: 执行诊断项目
|
|
40
|
+
|
|
41
|
+
依次执行以下诊断类别：
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## 诊断类别
|
|
46
|
+
|
|
47
|
+
### 📦 1. 核心组件诊断
|
|
48
|
+
|
|
49
|
+
检查插件核心文件完整性：
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
# 检查插件目录
|
|
53
|
+
ls -d ~/.claude/plugins/oh-my-claude 2>/dev/null
|
|
54
|
+
|
|
55
|
+
# 检查 plugin.json
|
|
56
|
+
cat ~/.claude/plugins/oh-my-claude/.claude-plugin/plugin.json 2>/dev/null | head -10
|
|
57
|
+
|
|
58
|
+
# 检查 package.json 版本
|
|
59
|
+
cat ~/.claude/plugins/oh-my-claude/package.json 2>/dev/null | grep '"version"'
|
|
60
|
+
|
|
61
|
+
# 检查核心目录
|
|
62
|
+
ls -d ~/.claude/plugins/oh-my-claude/agents 2>/dev/null
|
|
63
|
+
ls -d ~/.claude/plugins/oh-my-claude/commands 2>/dev/null
|
|
64
|
+
ls -d ~/.claude/plugins/oh-my-claude/hooks 2>/dev/null
|
|
65
|
+
ls -d ~/.claude/plugins/oh-my-claude/skills 2>/dev/null
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
**诊断结果示例：**
|
|
69
|
+
|
|
70
|
+
```text
|
|
71
|
+
📦 核心组件
|
|
72
|
+
────────────────────────────────────────────────────────────────
|
|
73
|
+
✅ 插件目录 ~/.claude/plugins/oh-my-claude
|
|
74
|
+
✅ plugin.json 配置完整
|
|
75
|
+
✅ package.json v2.1.3
|
|
76
|
+
✅ agents/ 20 个 Agent 定义
|
|
77
|
+
✅ commands/ 73 个命令定义
|
|
78
|
+
✅ hooks/ 45 个 Hook 脚本
|
|
79
|
+
✅ skills/ 14 个技能模块
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
### 🎭 2. Agent 可用性诊断
|
|
85
|
+
|
|
86
|
+
检查所有 Agent 是否可正常加载：
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
# 列出所有 Agent 文件
|
|
90
|
+
ls ~/.claude/plugins/oh-my-claude/agents/*.md 2>/dev/null
|
|
91
|
+
|
|
92
|
+
# 检查 Agent 文件格式是否正确（YAML frontmatter）
|
|
93
|
+
for f in ~/.claude/plugins/oh-my-claude/agents/*.md; do
|
|
94
|
+
head -1 "$f" | grep -q "^---" && echo "ok:$(basename $f)" || echo "err:$(basename $f)"
|
|
95
|
+
done 2>/dev/null
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
**诊断结果示例：**
|
|
99
|
+
|
|
100
|
+
```text
|
|
101
|
+
🎭 Agent 可用性
|
|
102
|
+
────────────────────────────────────────────────────────────────
|
|
103
|
+
✅ yugong.md 愚公 - 主编排 Agent
|
|
104
|
+
✅ zhuge.md 诸葛 - 战略顾问
|
|
105
|
+
✅ luban.md 鲁班 - 精工巧匠
|
|
106
|
+
✅ wukong.md 悟空 - 代码侦察
|
|
107
|
+
✅ bianque.md 扁鹊 - Bug 诊断
|
|
108
|
+
✅ mozi.md 墨子 - 安全审计
|
|
109
|
+
✅ sunzi.md 孙子 - 性能优化
|
|
110
|
+
✅ simaqian.md 司马迁 - 文档撰写
|
|
111
|
+
✅ zhenghe.md 郑和 - API 集成
|
|
112
|
+
✅ zhangheng.md 张衡 - 系统监控
|
|
113
|
+
✅ libing.md 李冰 - DevOps
|
|
114
|
+
✅ laozi.md 老子 - Clean Code
|
|
115
|
+
✅ baozheng.md 包拯 - 测试专家
|
|
116
|
+
✅ weizheng.md 魏征 - 代码审查
|
|
117
|
+
✅ cangjie.md 仓颉 - 数据库设计
|
|
118
|
+
✅ libai.md 李白 - 需求分析
|
|
119
|
+
✅ gukaizhi.md 顾恺之 - UI/UX
|
|
120
|
+
✅ change.md 嫦娥 - 云服务
|
|
121
|
+
✅ lilou.md 离娄 - 多模态
|
|
122
|
+
✅ liubowen.md 刘伯温 - 计划审查
|
|
123
|
+
|
|
124
|
+
状态: 20/20 Agent 可用
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
### 🪝 3. Hook 状态诊断
|
|
130
|
+
|
|
131
|
+
检查 Hook 配置和执行权限：
|
|
132
|
+
|
|
133
|
+
```bash
|
|
134
|
+
# 检查 hooks.json 配置
|
|
135
|
+
cat ~/.claude/plugins/oh-my-claude/hooks/hooks.json 2>/dev/null | head -30
|
|
136
|
+
|
|
137
|
+
# 检查 Hook 脚本权限（Unix）
|
|
138
|
+
ls -la ~/.claude/plugins/oh-my-claude/hooks/*.sh 2>/dev/null | head -10
|
|
139
|
+
|
|
140
|
+
# 检查关键 Hook 是否存在
|
|
141
|
+
ls ~/.claude/plugins/oh-my-claude/hooks/todo-enforcer.sh 2>/dev/null
|
|
142
|
+
ls ~/.claude/plugins/oh-my-claude/hooks/progress-notifier.sh 2>/dev/null
|
|
143
|
+
ls ~/.claude/plugins/oh-my-claude/hooks/keyword-detector.sh 2>/dev/null
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
**诊断结果示例：**
|
|
147
|
+
|
|
148
|
+
```text
|
|
149
|
+
🪝 Hook 状态
|
|
150
|
+
────────────────────────────────────────────────────────────────
|
|
151
|
+
配置文件: ✅ hooks.json 有效
|
|
152
|
+
|
|
153
|
+
UserPromptSubmit Hooks (12 个):
|
|
154
|
+
✅ keyword-detector.sh 关键词检测
|
|
155
|
+
✅ agent-usage-reminder.sh Agent 使用提醒
|
|
156
|
+
✅ auto-slash-command.sh 自动命令建议
|
|
157
|
+
✅ session-recovery.sh 会话恢复
|
|
158
|
+
✅ first-use-onboarding.sh 新手引导
|
|
159
|
+
⚠️ directory-readme-injector.sh 权限不足
|
|
160
|
+
...
|
|
161
|
+
|
|
162
|
+
PostToolUse Hooks (18 个):
|
|
163
|
+
✅ progress-notifier.sh 进度通知
|
|
164
|
+
✅ todo-enforcer.sh TODO 强制执行
|
|
165
|
+
✅ failure-transparency.sh 失败透明度
|
|
166
|
+
...
|
|
167
|
+
|
|
168
|
+
Stop Hooks (5 个):
|
|
169
|
+
✅ ralph-loop.sh Ralph Loop 检测
|
|
170
|
+
...
|
|
171
|
+
|
|
172
|
+
状态: 43/45 Hook 正常, 2 个需要修复
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
---
|
|
176
|
+
|
|
177
|
+
### 📋 4. 命令同步诊断
|
|
178
|
+
|
|
179
|
+
检查命令文件是否正确同步到 Claude Code：
|
|
180
|
+
|
|
181
|
+
```bash
|
|
182
|
+
# 统计源命令数
|
|
183
|
+
ls ~/.claude/plugins/oh-my-claude/commands/*.md 2>/dev/null | wc -l
|
|
184
|
+
|
|
185
|
+
# 统计已安装命令数
|
|
186
|
+
ls ~/.claude/commands/*.md 2>/dev/null | wc -l
|
|
187
|
+
|
|
188
|
+
# 检查关键命令是否已同步
|
|
189
|
+
ls ~/.claude/commands/yishan.md 2>/dev/null && echo "yishan:synced" || echo "yishan:missing"
|
|
190
|
+
ls ~/.claude/commands/do.md 2>/dev/null && echo "do:synced" || echo "do:missing"
|
|
191
|
+
ls ~/.claude/commands/help.md 2>/dev/null && echo "help:synced" || echo "help:missing"
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
**诊断结果示例：**
|
|
195
|
+
|
|
196
|
+
```text
|
|
197
|
+
📋 命令同步
|
|
198
|
+
────────────────────────────────────────────────────────────────
|
|
199
|
+
源命令: 73 个 (plugins/oh-my-claude/commands/)
|
|
200
|
+
已同步: 73 个 (~/.claude/commands/)
|
|
201
|
+
|
|
202
|
+
核心命令检查:
|
|
203
|
+
✅ /yishan 已同步
|
|
204
|
+
✅ /do 已同步
|
|
205
|
+
✅ /help 已同步
|
|
206
|
+
✅ /verify 已同步
|
|
207
|
+
✅ /progress 已同步
|
|
208
|
+
✅ /diagnose 已同步
|
|
209
|
+
|
|
210
|
+
状态: ✅ 所有命令已正确同步
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
---
|
|
214
|
+
|
|
215
|
+
### 🎯 5. 技能模块诊断
|
|
216
|
+
|
|
217
|
+
检查 Skill 加载状态：
|
|
218
|
+
|
|
219
|
+
```bash
|
|
220
|
+
# 列出所有技能目录
|
|
221
|
+
ls -d ~/.claude/plugins/oh-my-claude/skills/*/ 2>/dev/null
|
|
222
|
+
|
|
223
|
+
# 检查技能 SKILL.md 是否存在
|
|
224
|
+
for d in ~/.claude/plugins/oh-my-claude/skills/*/; do
|
|
225
|
+
ls "$d/SKILL.md" 2>/dev/null && echo "ok:$(basename $d)" || echo "missing:$(basename $d)"
|
|
226
|
+
done 2>/dev/null
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
**诊断结果示例：**
|
|
230
|
+
|
|
231
|
+
```text
|
|
232
|
+
🎯 技能模块
|
|
233
|
+
────────────────────────────────────────────────────────────────
|
|
234
|
+
✅ yishan/ 愚公移山循环技能
|
|
235
|
+
✅ bilingual/ 中英双语支持
|
|
236
|
+
✅ progress/ 进度面板技能
|
|
237
|
+
✅ git-master/ Git 操作技能
|
|
238
|
+
✅ playwright/ 浏览器自动化
|
|
239
|
+
✅ agent-handoff/ Agent 交接
|
|
240
|
+
✅ context/ 上下文管理
|
|
241
|
+
✅ error-friendly/ 友好错误显示
|
|
242
|
+
✅ preferences/ 用户偏好
|
|
243
|
+
✅ workflow/ 工作流模板
|
|
244
|
+
...
|
|
245
|
+
|
|
246
|
+
状态: 14/14 技能正常
|
|
247
|
+
```
|
|
248
|
+
|
|
249
|
+
---
|
|
250
|
+
|
|
251
|
+
### 🔌 6. MCP 服务器诊断
|
|
252
|
+
|
|
253
|
+
检查 MCP 配置状态：
|
|
254
|
+
|
|
255
|
+
```bash
|
|
256
|
+
# 检查 MCP 配置文件
|
|
257
|
+
cat ~/.claude/.mcp.json 2>/dev/null | head -20
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
**诊断结果示例：**
|
|
261
|
+
|
|
262
|
+
```text
|
|
263
|
+
🔌 MCP 服务器
|
|
264
|
+
────────────────────────────────────────────────────────────────
|
|
265
|
+
配置文件: ✅ ~/.claude/.mcp.json 存在
|
|
266
|
+
|
|
267
|
+
已配置的 MCP:
|
|
268
|
+
✅ context7 官方文档查询
|
|
269
|
+
✅ grep-app GitHub 代码搜索
|
|
270
|
+
⚠️ deepwiki 未配置（可选）
|
|
271
|
+
⚠️ open-websearch 未配置（可选）
|
|
272
|
+
|
|
273
|
+
状态: 2/4 MCP 已配置
|
|
274
|
+
提示: 运行 npx claude-pangu install --mcp 安装全部 MCP
|
|
275
|
+
```
|
|
276
|
+
|
|
277
|
+
---
|
|
278
|
+
|
|
279
|
+
### 🔄 7. 更新状态诊断
|
|
280
|
+
|
|
281
|
+
检查是否有可用更新：
|
|
282
|
+
|
|
283
|
+
```bash
|
|
284
|
+
# 获取当前版本
|
|
285
|
+
cat ~/.claude/plugins/oh-my-claude/package.json 2>/dev/null | grep '"version"'
|
|
286
|
+
|
|
287
|
+
# 检查 npm 最新版本（如果有网络）
|
|
288
|
+
npm view claude-pangu version 2>/dev/null || echo "无法检查远程版本"
|
|
289
|
+
```
|
|
290
|
+
|
|
291
|
+
**诊断结果示例：**
|
|
292
|
+
|
|
293
|
+
```text
|
|
294
|
+
🔄 更新状态
|
|
295
|
+
────────────────────────────────────────────────────────────────
|
|
296
|
+
当前版本: v2.1.3
|
|
297
|
+
最新版本: v2.1.4 (有更新可用)
|
|
298
|
+
|
|
299
|
+
更新命令: npx claude-pangu@latest update
|
|
300
|
+
或: /update-omc
|
|
301
|
+
```
|
|
302
|
+
|
|
303
|
+
---
|
|
304
|
+
|
|
305
|
+
## 诊断报告汇总
|
|
306
|
+
|
|
307
|
+
### 全部健康
|
|
308
|
+
|
|
309
|
+
```text
|
|
310
|
+
╔══════════════════════════════════════════════════════════════╗
|
|
311
|
+
║ 🎉 oh-my-claude 诊断完成 - 一切正常 ║
|
|
312
|
+
╠══════════════════════════════════════════════════════════════╣
|
|
313
|
+
║ ║
|
|
314
|
+
║ 📊 诊断汇总 ║
|
|
315
|
+
║ ──────────────────────────────────────────────────────── ║
|
|
316
|
+
║ 📦 核心组件 ✅ 全部正常 ║
|
|
317
|
+
║ 🎭 Agent ✅ 20/20 可用 ║
|
|
318
|
+
║ 🪝 Hook ✅ 45/45 正常 ║
|
|
319
|
+
║ 📋 命令同步 ✅ 73/73 已同步 ║
|
|
320
|
+
║ 🎯 技能模块 ✅ 14/14 正常 ║
|
|
321
|
+
║ 🔌 MCP 服务器 ✅ 4/4 已配置 ║
|
|
322
|
+
║ 🔄 版本 ✅ 已是最新 ║
|
|
323
|
+
║ ║
|
|
324
|
+
║ 🚀 系统运行正常，可以开始工作！ ║
|
|
325
|
+
║ ║
|
|
326
|
+
║ 快速开始: ║
|
|
327
|
+
║ /do [任务描述] - 万能入口 ║
|
|
328
|
+
║ /help - 查看命令帮助 ║
|
|
329
|
+
║ /tutorial - 交互式教程 ║
|
|
330
|
+
║ ║
|
|
331
|
+
╚══════════════════════════════════════════════════════════════╝
|
|
332
|
+
```
|
|
333
|
+
|
|
334
|
+
### 发现问题
|
|
335
|
+
|
|
336
|
+
```text
|
|
337
|
+
╔══════════════════════════════════════════════════════════════╗
|
|
338
|
+
║ ⚠️ oh-my-claude 诊断完成 - 发现 3 个问题 ║
|
|
339
|
+
╠══════════════════════════════════════════════════════════════╣
|
|
340
|
+
║ ║
|
|
341
|
+
║ 📊 诊断汇总 ║
|
|
342
|
+
║ ──────────────────────────────────────────────────────── ║
|
|
343
|
+
║ 📦 核心组件 ✅ 全部正常 ║
|
|
344
|
+
║ 🎭 Agent ✅ 20/20 可用 ║
|
|
345
|
+
║ 🪝 Hook ⚠️ 43/45 正常 (2 个权限问题) ║
|
|
346
|
+
║ 📋 命令同步 ❌ 68/73 已同步 (缺少 5 个) ║
|
|
347
|
+
║ 🎯 技能模块 ✅ 14/14 正常 ║
|
|
348
|
+
║ 🔌 MCP 服务器 ⚠️ 2/4 已配置 ║
|
|
349
|
+
║ 🔄 版本 ⚠️ 有新版本 v2.1.4 ║
|
|
350
|
+
║ ║
|
|
351
|
+
║ ══════════════════════════════════════════════════════════ ║
|
|
352
|
+
║ ║
|
|
353
|
+
║ 🔧 问题详情与修复建议 ║
|
|
354
|
+
║ ──────────────────────────────────────────────────────── ║
|
|
355
|
+
║ ║
|
|
356
|
+
║ 问题 1: Hook 权限不足 ║
|
|
357
|
+
║ ──────── ║
|
|
358
|
+
║ 受影响: directory-readme-injector.sh, atlas.sh ║
|
|
359
|
+
║ 修复: ║
|
|
360
|
+
║ chmod +x ~/.claude/plugins/oh-my-claude/hooks/*.sh ║
|
|
361
|
+
║ ║
|
|
362
|
+
║ 问题 2: 命令未同步 ║
|
|
363
|
+
║ ──────── ║
|
|
364
|
+
║ 缺少: workflow.md, preferences.md, diagnose.md 等 ║
|
|
365
|
+
║ 修复: ║
|
|
366
|
+
║ npx claude-pangu@latest install ║
|
|
367
|
+
║ ║
|
|
368
|
+
║ 问题 3: 版本过旧 ║
|
|
369
|
+
║ ──────── ║
|
|
370
|
+
║ 当前: v2.1.3 → 最新: v2.1.4 ║
|
|
371
|
+
║ 更新: ║
|
|
372
|
+
║ npx claude-pangu@latest update ║
|
|
373
|
+
║ ║
|
|
374
|
+
║ ══════════════════════════════════════════════════════════ ║
|
|
375
|
+
║ ║
|
|
376
|
+
║ 💡 一键修复全部问题: ║
|
|
377
|
+
║ npx claude-pangu@latest install --force ║
|
|
378
|
+
║ ║
|
|
379
|
+
╚══════════════════════════════════════════════════════════════╝
|
|
380
|
+
```
|
|
381
|
+
|
|
382
|
+
---
|
|
383
|
+
|
|
384
|
+
## 参数选项
|
|
385
|
+
|
|
386
|
+
### `/diagnose` (无参数)
|
|
387
|
+
|
|
388
|
+
完整诊断，输出详细报告。
|
|
389
|
+
|
|
390
|
+
### `/diagnose --quick` 或 `/diagnose -q`
|
|
391
|
+
|
|
392
|
+
快速诊断，仅检查核心组件：
|
|
393
|
+
|
|
394
|
+
```text
|
|
395
|
+
🏥 快速诊断
|
|
396
|
+
───────────────────────────────────────
|
|
397
|
+
📦 核心组件 ✅ 🎭 Agent ✅
|
|
398
|
+
🪝 Hook ⚠️ 📋 命令 ✅
|
|
399
|
+
───────────────────────────────────────
|
|
400
|
+
状态: 1 个问题 | 详情: /diagnose
|
|
401
|
+
```
|
|
402
|
+
|
|
403
|
+
### `/diagnose --fix`
|
|
404
|
+
|
|
405
|
+
自动修复检测到的问题：
|
|
406
|
+
|
|
407
|
+
```text
|
|
408
|
+
🔧 正在修复检测到的问题...
|
|
409
|
+
|
|
410
|
+
[1/3] 修复 Hook 权限...
|
|
411
|
+
chmod +x ~/.claude/plugins/oh-my-claude/hooks/*.sh
|
|
412
|
+
✅ 已修复
|
|
413
|
+
|
|
414
|
+
[2/3] 同步命令文件...
|
|
415
|
+
复制 5 个缺失的命令
|
|
416
|
+
✅ 已同步
|
|
417
|
+
|
|
418
|
+
[3/3] 更新插件...
|
|
419
|
+
npx claude-pangu@latest update
|
|
420
|
+
⏭️ 跳过 (需要手动执行)
|
|
421
|
+
|
|
422
|
+
🎉 修复完成！请重启 Claude Code。
|
|
423
|
+
```
|
|
424
|
+
|
|
425
|
+
### `/diagnose --json`
|
|
426
|
+
|
|
427
|
+
输出 JSON 格式的诊断结果（供脚本使用）：
|
|
428
|
+
|
|
429
|
+
```json
|
|
430
|
+
{
|
|
431
|
+
"status": "warning",
|
|
432
|
+
"version": "2.1.3",
|
|
433
|
+
"latestVersion": "2.1.4",
|
|
434
|
+
"components": {
|
|
435
|
+
"core": { "status": "ok", "details": {} },
|
|
436
|
+
"agents": { "status": "ok", "available": 20, "total": 20 },
|
|
437
|
+
"hooks": { "status": "warning", "available": 43, "total": 45, "issues": ["permission"] },
|
|
438
|
+
"commands": { "status": "error", "synced": 68, "total": 73 },
|
|
439
|
+
"skills": { "status": "ok", "available": 14, "total": 14 },
|
|
440
|
+
"mcp": { "status": "warning", "configured": 2, "total": 4 }
|
|
441
|
+
},
|
|
442
|
+
"issues": [
|
|
443
|
+
{ "type": "hook_permission", "affected": ["directory-readme-injector.sh"] },
|
|
444
|
+
{ "type": "command_missing", "affected": ["workflow.md", "preferences.md"] },
|
|
445
|
+
{ "type": "update_available", "current": "2.1.3", "latest": "2.1.4" }
|
|
446
|
+
],
|
|
447
|
+
"fixes": [
|
|
448
|
+
"chmod +x ~/.claude/plugins/oh-my-claude/hooks/*.sh",
|
|
449
|
+
"npx claude-pangu@latest install",
|
|
450
|
+
"npx claude-pangu@latest update"
|
|
451
|
+
]
|
|
452
|
+
}
|
|
453
|
+
```
|
|
454
|
+
|
|
455
|
+
---
|
|
456
|
+
|
|
457
|
+
## 使用场景
|
|
458
|
+
|
|
459
|
+
1. **安装后确认** - 安装完成后运行 `/diagnose` 确保一切正常
|
|
460
|
+
2. **功能异常时** - 某个命令或 Agent 不工作时诊断问题
|
|
461
|
+
3. **定期检查** - 定期运行确保插件健康
|
|
462
|
+
4. **更新前后** - 更新前后对比诊断结果
|
|
463
|
+
|
|
464
|
+
---
|
|
465
|
+
|
|
466
|
+
## 别名
|
|
467
|
+
|
|
468
|
+
- `/diagnose` - 主命令
|
|
469
|
+
- `/诊断` - 中文别名
|
|
470
|
+
- `/health-check` - 健康检查
|
|
471
|
+
- `/doctor` - 医生（扁鹊风格）
|