1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
|
我需要你作为一个自动化诊断和修复agent来帮我解决Claude Code Skill的安装问题。
基于官方文档：https://support.claude.com/en/articles/12512198-how-to-create-custom-skills 请帮我执行完整的Claude Code技能故障诊断。
## 重要说明
- 你是一个执行agent，不仅要诊断问题，还要**立即修复**每个发现的问题
- 使用系统命令（ls, cat, find, chmod, mkdir等）来**实际操作文件**，而不仅仅是检查
- 对每个步骤执行完毕后，立即输出结果和采取的行动
- 最后生成一份**修复清单**说明你发现了什么问题以及如何修复的
请按以下完整流程检查：
## 第1步：全环境检查
**目的**：确认Claude Code环境和系统状态
请检查：
1. Claude Code版本和运行状态
2. 当前用户名和主目录路径
3. 系统权限状态（是否有读写权限）
4. 网络连接状态（如果需要在线资源）
## 第2步：全面搜索技能位置
**目的**：找到所有可能的技能文件位置
请搜索以下位置：
- 主目录：/Users/[当前用户名]/
- 官方目录：~/.claude/plugins/marketplaces/
- 配置目录：~/.config/claude/
- 用户目录：~/Documents/Claude/Skills/
- 下载目录：~/Downloads/
- 桌面目录：~/Desktop/
- 搜索命令：find ~ -name "*.md" -path "*skill*" -o -name "skill.md" 2>/dev/null
## 第3步：安装流程回溯检查
**目的**：检查技能安装的完整流程
### 3.1 目录创建检查
对每个找到的技能目录，检查：
- 目录权限是否正确（755）
- 目录结构是否符合标准
- 是否包含必要的子目录
### 3.2 文件编写检查
对每个skill.md文件，验证：
- YAML头部格式是否完全正确
- name字段是否存在且≤64字符
- description字段是否存在且≤200字符
- 文件编码是否为UTF-8
- 文件权限是否正确（644）
- 内容结构是否完整
### 3.3 配置修改检查
检查Claude Code相关配置：
- 设置文件中的技能注册状态
- 技能启用状态
- 配置文件格式是否正确
### 3.4 系统注册检查
验证技能是否正确注册：
- 技能在设置界面是否可见
- 技能描述是否正确显示
- 技能状态是否为启用
### 3.5 技能使用检查
测试技能功能：
- 技能是否能正常触发
- 返回结果是否符合预期
- 是否有错误信息
## 第4步：常见问题专项检查
**目的**：检查最常见的问题类型
- YAML语法错误（使用在线YAML验证器）
- 特殊字符或编码问题
- 文件名大小写问题
- 路径中的空格或特殊字符
- 权限不足问题
- 缓存问题
## 第5步：环境兼容性检查
**目的**：检查系统兼容性
- 操作系统版本兼容性
- Python环境依赖（如果有脚本）
- 必要的系统工具是否可用
## 第6步：网络和资源检查
**目的**：检查外部资源依赖
- 如果技能依赖在线资源，检查网络连接
- 检查resources目录中的文件是否完整
- 验证外部依赖的可用性
## 第7步：日志和错误信息分析
**目的**：分析系统日志和错误信息
- Claude Code日志文件
- 系统错误日志
- 技能执行时的错误输出
## 第8步：修复建议和方案
**目的**：提供具体的修复方案
基于以上检查结果：
1. 列出所有发现的问题
2. 按优先级排序问题
3. 提供详细的修复步骤
4. 如果需要，提供修复后的完整代码
请执行完整的诊断流程，并告诉我每个步骤的详细结果和最终的修复方案。并生成一份**修复清单**说明你发现了什么问题以及如何修复的
|
