-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathcode-block-snapshot.txt
More file actions
557 lines (544 loc) · 23.6 KB
/
Copy pathcode-block-snapshot.txt
File metadata and controls
557 lines (544 loc) · 23.6 KB
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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
uid=5_0 RootWebArea "Agent Skills 完全指南 - Claude Code" url="http://localhost:4321/"
uid=5_1 navigation
uid=5_2 StaticText "Agent Skills"
uid=5_3 link "什么是 Skills" url="http://localhost:4321/#what-is-skill"
uid=5_4 StaticText "什么是 Skills"
uid=5_5 link "工作原理" url="http://localhost:4321/#how-it-works"
uid=5_6 StaticText "工作原理"
uid=5_7 link "创建 Skill" url="http://localhost:4321/#create-skill"
uid=5_8 StaticText "创建 Skill"
uid=5_9 link "设计规范" url="http://localhost:4321/#design-specs"
uid=5_10 StaticText "设计规范"
uid=5_11 StaticText "•"
uid=5_12 link "官方 Skills" url="http://localhost:4321/#official-skills"
uid=5_13 StaticText "官方 Skills"
uid=5_14 link "示例" url="http://localhost:4321/#examples"
uid=5_15 StaticText "示例"
uid=5_16 link "最佳实践" url="http://localhost:4321/#best-practices"
uid=5_17 StaticText "最佳实践"
uid=5_18 button "切换主题"
uid=5_19 StaticText "Claude Code 官方文档指南 + 官方 Skills 仓库解析"
uid=5_20 heading "Agent Skills" level="1"
uid=5_21 StaticText "让 Claude 学会你的工作方式——自动匹配专业知识,无需记忆命令"
uid=5_22 link "开始创建" url="http://localhost:4321/#create-skill"
uid=5_23 StaticText "开始创建"
uid=5_24 link "探索官方 Skills" url="http://localhost:4321/#official-skills"
uid=5_25 StaticText "探索官方 Skills"
uid=5_26 heading "什么是 Agent Skills?" level="2"
uid=5_27 StaticText "Skill 是一个 Markdown 文件,教 Claude 如何完成特定任务。当你的请求匹配 Skill 的用途时,Claude 会"
uid=5_28 StaticText "自动应用"
uid=5_29 StaticText "它。"
uid=5_30 heading "Skills vs 其他配置方式" level="3"
uid=5_31 StaticText "方式"
uid=5_32 StaticText "用途"
uid=5_33 StaticText "触发时机"
uid=5_34 StaticText "适用场景"
uid=5_35 StaticText "Skills"
uid=5_36 StaticText "给 Claude 专业知识"
uid=5_37 StaticText "Claude 自动选择"
uid=5_38 StaticText "代码审查标准、提交信息规范"
uid=5_39 StaticText "Slash Commands"
uid=5_40 StaticText "可复用提示词"
uid=5_41 StaticText "手动输入 "
uid=5_42 StaticText "/command"
uid=5_43 StaticText "部署流程、代码生成模板"
uid=5_44 StaticText "CLAUDE.md"
uid=5_45 StaticText "项目级指令"
uid=5_46 StaticText "每次对话加载"
uid=5_47 StaticText "项目规范、技术栈约定"
uid=5_48 StaticText "MCP Servers"
uid=5_49 StaticText "连接外部工具"
uid=5_50 StaticText "按需调用"
uid=5_51 StaticText "数据库、API、文件系统"
uid=5_52 heading "自动匹配" level="3"
uid=5_53 StaticText "无需记忆命令,Claude 根据你的请求自动选择合适的 Skill"
uid=5_54 heading "渐进式披露" level="3"
uid=5_55 StaticText "核心信息始终加载,详细文档按需加载,节省 token"
uid=5_56 heading "权限控制" level="3"
uid=5_57 StaticText "通过 allowed-tools 限制 Skill 可用的工具,确保安全"
uid=5_58 heading "Skills 如何工作?" level="2"
uid=5_59 StaticText "当你发送请求时,Claude 经过以下步骤找到并使用相关的 Skills"
uid=5_60 heading "用户发送请求" level="3"
uid=5_61 StaticText "例如:"帮我看看这个 PR 的代码质量""
uid=5_62 StaticText "1"
uid=5_63 StaticText "2"
uid=5_64 heading "意图识别 & 技能匹配" level="3"
uid=5_65 StaticText "Claude 分析请求,在所有 Skills 中查找匹配的 description"
uid=5_66 heading "加载 Skill 内容" level="3"
uid=5_67 StaticText "SKILL.md 加载到上下文,支持文件按需加载"
uid=5_68 StaticText "3"
uid=5_69 StaticText "4"
uid=5_70 heading "生成响应" level="3"
uid=5_71 StaticText "Claude 按照 Skill 的指令生成符合标准的响应"
uid=5_72 heading "Skills 存储位置与优先级" level="3"
uid=5_73 StaticText "最高优先级"
uid=5_74 heading "Enterprise" level="4"
uid=5_75 StaticText "组织级设置路径"
uid=5_76 StaticText "组织内所有用户"
uid=5_77 StaticText "个人级"
uid=5_78 heading "Personal" level="4"
uid=5_79 StaticText "~/.claude/skills/"
uid=5_80 StaticText "你个人,所有项目"
uid=5_81 StaticText "项目级"
uid=5_82 heading "Project" level="4"
uid=5_83 StaticText ".claude/skills/"
uid=5_84 StaticText "仓库内所有协作者"
uid=5_85 StaticText "最低优先级"
uid=5_86 heading "Plugin" level="4"
uid=5_87 StaticText "随插件打包"
uid=5_88 StaticText "安装该插件的任何人"
uid=5_89 StaticText "如果两个 Skills 同名,优先级高的会覆盖优先级低的"
uid=5_90 heading "平台支持" level="3"
uid=5_91 heading "Claude Code" level="4"
uid=5_92 StaticText "• 完整 Skills 支持"
uid=5_93 StaticText "• Plugin Marketplace"
uid=5_94 StaticText "• 四级优先级"
uid=5_95 StaticText "• 零上下文脚本执行"
uid=5_96 heading "Claude.ai" level="4"
uid=5_97 StaticText "• 付费计划包含 Skills"
uid=5_98 StaticText "• 项目级 Skills"
uid=5_99 StaticText "• 通过 Claude Code 创建"
uid=5_100 StaticText "• 网页界面使用"
uid=5_101 heading "Claude API" level="4"
uid=5_102 StaticText "• Skills API Quickstart"
uid=5_103 StaticText "• 程序化调用"
uid=5_104 StaticText "• 自定义 Skill 加载"
uid=5_105 StaticText "• API 文档参考"
uid=5_106 heading "如何创建 Skill" level="2"
uid=5_107 StaticText "创建 Skill 只需要一个 SKILL.md 文件,包含元数据和指令"
uid=5_108 heading "SKILL.md 基本结构" level="3"
uid=5_109 StaticText "---"
uid=5_110 StaticText "
"
uid=5_111 StaticText "name"
uid=5_112 StaticText ": "
uid=5_113 StaticText "your-skill-name"
uid=5_114 StaticText "
"
uid=5_115 StaticText "description"
uid=5_116 StaticText ": "
uid=5_117 StaticText "简述 Skill 的作用和使用场景 (Claude 用它来决定何时应用)"
uid=5_118 StaticText "
"
uid=5_119 StaticText "allowed-tools"
uid=5_120 StaticText ": "
uid=5_121 StaticText "Read, Grep, Glob"
uid=5_122 StaticText " "
uid=5_123 StaticText "# 可选:限制工具权限"
uid=5_124 StaticText "
"
uid=5_125 StaticText "license"
uid=5_126 StaticText ": "
uid=5_127 StaticText "Complete terms in LICENSE.txt"
uid=5_128 StaticText " "
uid=5_129 StaticText "# 可选:许可证信息"
uid=5_130 StaticText "
"
uid=5_131 StaticText "---"
uid=5_132 StaticText "
"
uid=5_133 StaticText "# Your Skill Name"
uid=5_134 StaticText "
"
uid=5_135 StaticText "## Instructions"
uid=5_136 StaticText "
提供清晰、分步的指导给 Claude。
"
uid=5_137 StaticText "## Examples"
uid=5_138 StaticText "
展示具体的使用示例。"
uid=5_139 heading "必需字段" level="4"
uid=5_140 StaticText "name"
uid=5_141 StaticText "Skill 名称,只能用小写字母、数字和连字符(最多64字符)"
uid=5_142 StaticText "description"
uid=5_143 StaticText "Skill 的作用和使用场景(最多1024字符)"
uid=5_144 LineBreak "
"
uid=5_145 StaticText "这是 Claude 匹配的关键!"
uid=5_146 heading "可选字段" level="4"
uid=5_147 StaticText "allowed-tools"
uid=5_148 StaticText "Skill 激活时 Claude 可无需权限使用的工具"
uid=5_149 StaticText "model"
uid=5_150 StaticText "Skill 激活时使用的模型(如 claude-sonnet-4-20250514)"
uid=5_151 StaticText "license"
uid=5_152 StaticText "许可证信息(如 "Complete terms in LICENSE.txt")"
uid=5_153 heading "Skill 文件结构(渐进式披露)" level="3"
uid=5_154 heading "简单 Skill(单文件)" level="4"
uid=5_155 StaticText "my-skill/
├── SKILL.md
└── LICENSE.txt "
uid=5_156 StaticText "# 可选"
uid=5_157 StaticText "适合简单任务、单一目的"
uid=5_158 heading "复杂 Skill(多文件)" level="4"
uid=5_159 StaticText "my-skill/
├── SKILL.md "
uid=5_160 StaticText "# 概览和快速开始"
uid=5_161 StaticText "
├── LICENSE.txt "
uid=5_162 StaticText "# 许可证"
uid=5_163 StaticText "
├── reference.md "
uid=5_164 StaticText "# 详细 API 文档"
uid=5_165 StaticText "
├── examples.md "
uid=5_166 StaticText "# 使用示例"
uid=5_167 StaticText "
└── scripts/
└── helper.py "
uid=5_168 StaticText "# 工具脚本(零上下文执行)"
uid=5_169 StaticText "支持文件按需加载,节省 token"
uid=5_170 heading "Skill 设计规范" level="2"
uid=5_171 StaticText "遵循官方最佳实践,创建高质量、可维护的 Skills"
uid=5_172 heading "核心设计原则" level="3"
uid=5_173 heading "保持简洁" level="4"
uid=5_174 StaticText "SKILL.md 应 < 500 行"
uid=5_175 StaticText "核心信息放在 SKILL.md,详细内容放到支持文件。保持主文件简洁,确保快速加载和易于维护。"
uid=5_176 heading "渐进式披露" level="4"
uid=5_177 StaticText "SKILL.md - 核心指令 + 快速开始"
uid=5_178 StaticText "reference.md - 完整 API 文档"
uid=5_179 StaticText "examples.md - 详细使用示例"
uid=5_180 StaticText "详细内容按需加载,节省 token 使用的核心策略。"
uid=5_181 heading "完整设计规范参考" level="3"
uid=5_182 StaticText "官方文档提供了详细的 Skill 设计指南,包括结构、样式、权限控制等各个方面。"
uid=5_183 link "查看官方设计规范" url="https://docs.anthropic.com/en/docs/build-with-claude/agent-skills"
uid=5_184 StaticText "查看官方设计规范"
uid=5_185 heading "Anthropic 官方 Skills" level="2"
uid=5_186 StaticText "Anthropic 在 GitHub 上维护了一个官方 Skills 仓库,包含 16 个生产级 Skills"
uid=5_187 heading "anthropic/skills" level="3"
uid=5_188 StaticText "官方 Skills 仓库 - 生产级参考实现"
uid=5_189 link "访问仓库" url="https://github.com/anthropics/skills"
uid=5_190 StaticText "访问仓库"
uid=5_191 heading "algorithmic-art" level="4"
uid=5_192 StaticText "使用 p5.js 创建算法艺术"
uid=5_193 heading "frontend-design" level="4"
uid=5_194 StaticText "高质量前端界面设计"
uid=5_195 heading "mcp-builder" level="4"
uid=5_196 StaticText "MCP 服务器开发指南"
uid=5_197 heading "skill-creator" level="4"
uid=5_198 StaticText "创建高质量 Skills"
uid=5_199 heading "pdf" level="4"
uid=5_200 StaticText "PDF 处理完整工具包"
uid=5_201 heading "docx" level="4"
uid=5_202 StaticText "Word 文档处理"
uid=5_203 heading "pptx" level="4"
uid=5_204 StaticText "PowerPoint 演示文稿"
uid=5_205 heading "xlsx" level="4"
uid=5_206 StaticText "Excel 表格处理"
uid=5_207 heading "brand-guidelines" level="4"
uid=5_208 StaticText "Anthropic 品牌规范"
uid=5_209 heading "canvas-design" level="4"
uid=5_210 StaticText "Canvas 图形设计"
uid=5_211 heading "theme-factory" level="4"
uid=5_212 StaticText "主题样式生成器"
uid=5_213 heading "artifacts-builder" level="4"
uid=5_214 StaticText "复杂 HTML Artifacts"
uid=5_215 heading "doc-coauthoring" level="4"
uid=5_216 StaticText "文档协作工作流"
uid=5_217 heading "internal-comms" level="4"
uid=5_218 StaticText "内部沟通模板"
uid=5_219 heading "License 与开源信息" level="3"
uid=5_220 heading "MIT 许可证" level="4"
uid=5_221 StaticText "所有官方 Skills 使用 MIT 许可证,允许自由使用、修改和分发。"
uid=5_222 StaticText "Complete terms in LICENSE.txt"
uid=5_223 heading "贡献指南" level="4"
uid=5_224 StaticText "欢迎社区贡献!遵循官方仓库的贡献准则。"
uid=5_225 StaticText "• Fork 项目并创建分支"
uid=5_226 StaticText "• 遵循代码规范"
uid=5_227 StaticText "• 添加测试和文档"
uid=5_228 StaticText "• 提交 Pull Request"
uid=5_229 heading "常见 Skill 示例" level="2"
uid=5_230 StaticText "从简单到复杂,覆盖常见使用场景"
uid=5_231 heading "提交信息助手" level="3"
uid=5_232 StaticText "单文件 Skill - 自动生成规范的 Git 提交信息"
uid=5_233 StaticText "---"
uid=5_234 StaticText "
"
uid=5_235 StaticText "name"
uid=5_236 StaticText ": "
uid=5_237 StaticText "generating-commit-messages"
uid=5_238 StaticText "
"
uid=5_239 StaticText "description"
uid=5_240 StaticText ": "
uid=5_241 StaticText "从 git diff 生成清晰的提交信息。使用当用户需要写提交信息或查看暂存的更改时。"
uid=5_242 StaticText "
"
uid=5_243 StaticText "---"
uid=5_244 StaticText "
"
uid=5_245 StaticText "# Generating Commit Messages"
uid=5_246 StaticText "
"
uid=5_247 StaticText "## Instructions"
uid=5_248 StaticText "
"
uid=5_249 StaticText "1. 运行 `git diff --staged` 查看变更"
uid=5_250 StaticText "
"
uid=5_251 StaticText "2. 建议包含以下内容的提交信息:"
uid=5_252 StaticText "
"
uid=5_253 StaticText " - 50字符以内的摘要"
uid=5_254 StaticText "
"
uid=5_255 StaticText " - 详细描述"
uid=5_256 StaticText "
"
uid=5_257 StaticText " - 受影响的组件"
uid=5_258 StaticText "
"
uid=5_259 StaticText "## Best Practices"
uid=5_260 StaticText "
"
uid=5_261 StaticText "- 使用现在时态"
uid=5_262 StaticText "
"
uid=5_263 StaticText "- 解释"做什么"和"为什么",而不是"怎么做""
uid=5_264 heading "使用方式" level="4"
uid=5_265 StaticText "只需说:"
uid=5_266 StaticText ""帮我写个提交信息""
uid=5_267 StaticText " 或 "
uid=5_268 StaticText ""看看我暂存了什么""
uid=5_269 heading "PDF 处理专家" level="3"
uid=5_270 StaticText "多文件 Skill - 支持文档、脚本、权限控制"
uid=5_271 StaticText "---"
uid=5_272 StaticText "
"
uid=5_273 StaticText "name"
uid=5_274 StaticText ": "
uid=5_275 StaticText "pdf"
uid=5_276 StaticText "
"
uid=5_277 StaticText "description"
uid=5_278 StaticText ": "
uid=5_279 StaticText "从 PDF 提取文本和表格,填充表单,合并文档。处理 PDF 文件时使用,或当用户提及 PDF、表单、文档提取时。"
uid=5_280 StaticText "
"
uid=5_281 StaticText "allowed-tools"
uid=5_282 StaticText ": "
uid=5_283 StaticText "Read, Bash(python:*)"
uid=5_284 StaticText "
"
uid=5_285 StaticText "---"
uid=5_286 StaticText "
"
uid=5_287 StaticText "# PDF Processing Guide"
uid=5_288 StaticText "
"
uid=5_289 StaticText "## Overview"
uid=5_290 StaticText "
"
uid=5_291 StaticText "本指南涵盖基本的 PDF 处理操作。高级功能见 reference.md,表单填写见 forms.md。"
uid=5_292 StaticText "
"
uid=5_293 StaticText "## Quick Start"
uid=5_294 StaticText "
```python
"
uid=5_295 StaticText "from pypdf import PdfReader"
uid=5_296 StaticText "
"
uid=5_297 StaticText "reader = PdfReader("document.pdf")"
uid=5_298 StaticText "
"
uid=5_299 StaticText "text = "".join(page.extract_text() for page in reader.pages)"
uid=5_300 StaticText "
```
"
uid=5_301 StaticText "## Additional Resources"
uid=5_302 StaticText "
"
uid=5_303 StaticText "- 表单字段映射见 "
uid=5_304 link "forms.md" url="http://localhost:4321/#"
uid=5_305 StaticText "forms.md"
uid=5_306 StaticText "
"
uid=5_307 StaticText "- API 详细信息见 "
uid=5_308 link "reference.md" url="http://localhost:4321/#"
uid=5_309 StaticText "reference.md"
uid=5_310 heading "文件结构" level="4"
uid=5_311 StaticText "pdf/
├── SKILL.md
├── forms.md
├── reference.md
└── scripts/"
uid=5_312 heading "代码审查标准" level="3"
uid=5_313 StaticText "企业级 Skill - 定义团队代码审查规范"
uid=5_314 StaticText "---"
uid=5_315 StaticText "
"
uid=5_316 StaticText "name"
uid=5_317 StaticText ": "
uid=5_318 StaticText "team-code-review"
uid=5_319 StaticText "
"
uid=5_320 StaticText "description"
uid=5_321 StaticText ": "
uid=5_322 StaticText "按照团队标准审查代码质量。检查错误处理、类型安全、性能优化、安全性。使用当用户要求代码审查、PR 审查或质量检查时。"
uid=5_323 StaticText "
"
uid=5_324 StaticText "allowed-tools"
uid=5_325 StaticText ": "
uid=5_326 StaticText "Read, Grep, Glob"
uid=5_327 StaticText "
"
uid=5_328 StaticText "---"
uid=5_329 StaticText "
"
uid=5_330 StaticText "# Team Code Review Standards"
uid=5_331 StaticText "
"
uid=5_332 StaticText "## Review Checklist"
uid=5_333 StaticText "
"
uid=5_334 StaticText "1. **错误处理**:所有可能失败的操作都有 try-catch"
uid=5_335 StaticText "
"
uid=5_336 StaticText "2. **类型安全**:TypeScript 严格模式,无 any 类型"
uid=5_337 StaticText "
"
uid=5_338 StaticText "3. **性能**:无不必要的渲染,优化大列表"
uid=5_339 StaticText "
"
uid=5_340 StaticText "4. **安全**:无 XSS/SQL 注入风险,验证输入"
uid=5_341 StaticText "
"
uid=5_342 StaticText "5. **可读性**:命名清晰,适当注释"
uid=5_343 StaticText "
"
uid=5_344 StaticText "## Output Format"
uid=5_345 StaticText "
"
uid=5_346 StaticText "按优先级输出问题:"
uid=5_347 StaticText "
"
uid=5_348 StaticText "- 🔴 严重:安全漏洞、崩溃风险"
uid=5_349 StaticText "
"
uid=5_350 StaticText "- 🟡 警告:性能问题、代码异味"
uid=5_351 StaticText "
"
uid=5_352 StaticText "- 💡 建议:最佳实践、可读性"
uid=5_353 heading "使用方式" level="4"
uid=5_354 StaticText "只需说:"
uid=5_355 StaticText ""审查这个 PR""
uid=5_356 StaticText " 或 "
uid=5_357 StaticText ""检查代码质量""
uid=5_358 heading "编写高质量 Skills" level="2"
uid=5_359 StaticText "基于官方 Skills 分析的实战准则"
uid=5_360 heading "编写精确的 Description" level="3"
uid=5_361 StaticText "description 是 Claude 匹配的关键信号"
uid=5_362 StaticText "❌ 模糊:"
uid=5_363 StaticText " Helps with documents"
uid=5_364 StaticText "✅ 精确:"
uid=5_365 StaticText " Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction."
uid=5_366 heading "使用渐进式披露" level="3"
uid=5_367 StaticText "保持 SKILL.md 轻量,详细内容放单独文件"
uid=5_368 StaticText "SKILL.md: 核心指令 + 快速开始"
uid=5_369 StaticText "reference.md: 完整 API 文档"
uid=5_370 StaticText "examples.md: 详细示例"
uid=5_371 heading "限制工具权限" level="3"
uid=5_372 StaticText "使用 allowed-tools 保护安全边界"
uid=5_373 StaticText "只读 Skill: "
uid=5_374 StaticText "allowed-tools: Read, Grep, Glob"
uid=5_375 StaticText "数据处理: "
uid=5_376 StaticText "allowed-tools: Bash(python:*)"
uid=5_377 heading "脚本零上下文执行" level="3"
uid=5_378 StaticText "脚本执行只加载输出,不加载代码"
uid=5_379 StaticText "scripts/validate.py - 执行但不读取"
uid=5_380 StaticText "只有输出消耗 token,结果可靠"
uid=5_381 heading "从官方 Skills 学到的最佳实践" level="3"
uid=5_382 heading "指令编写风格" level="4"
uid=5_383 StaticText "✓"
uid=5_384 StaticText "结构化分层"
uid=5_385 StaticText ":使用明确的 ## 标题层级(Overview → Quick Start → Advanced)"
uid=5_386 StaticText "✓"
uid=5_387 StaticText "CRITICAL 标记"
uid=5_388 StaticText ":关键步骤用 ⚠️ 或 **CRITICAL** 强调"
uid=5_389 StaticText "✓"
uid=5_390 StaticText "示例驱动"
uid=5_391 StaticText ":每个概念都有具体代码示例"
uid=5_392 StaticText "✓"
uid=5_393 StaticText "避免 vs 坚持"
uid=5_394 StaticText ":明确说明应该做什么和不应该做什么"
uid=5_395 heading "文件组织策略" level="4"
uid=5_396 StaticText "✓"
uid=5_397 StaticText "templates/ 目录"
uid=5_398 StaticText ":存储可复用的模板文件(如 HTML 模板)"
uid=5_399 StaticText "✓"
uid=5_400 StaticText "reference/ 子目录"
uid=5_401 StaticText ":按语言或主题组织参考文档"
uid=5_402 StaticText "✓"
uid=5_403 StaticText "examples/ 目录"
uid=5_404 StaticText ":提供完整的示例代码"
uid=5_405 StaticText "✓"
uid=5_406 StaticText "LICENSE.txt"
uid=5_407 StaticText ":每个 Skill 都包含许可证文件"
uid=5_408 heading "常见问题排查" level="3"
uid=5_409 heading "Skill 未触发" level="4"
uid=5_410 StaticText "原因:"
uid=5_411 StaticText "description 太模糊,无法匹配"
uid=5_412 StaticText "解决:"
uid=5_413 StaticText "包含具体动作和触发关键词,如 "从 PDF 提取文本、填充表单、合并文档""
uid=5_414 heading "Skill 未加载" level="4"
uid=5_415 StaticText "检查:"
uid=5_416 StaticText "• 文件路径正确:"
uid=5_417 StaticText "~/.claude/skills/my-skill/SKILL.md"
uid=5_418 StaticText "• YAML 语法正确:用空格不用 Tab"
uid=5_419 StaticText "• 使用 "
uid=5_420 StaticText "claude --debug"
uid=5_421 StaticText " 查看错误"
uid=5_422 heading "多 Skills 冲突" level="4"
uid=5_423 StaticText "原因:"
uid=5_424 StaticText "description 太相似"
uid=5_425 StaticText "解决:"
uid=5_426 StaticText "用具体触发词区分,如 "销售数据 Excel 分析" vs "日志文件分析""
uid=5_427 heading "快速参考" level="2"
uid=5_428 StaticText "常用命令和路径"
uid=5_429 heading "存储路径" level="4"
uid=5_430 StaticText "Personal:"
uid=5_431 StaticText " "
uid=5_432 StaticText "~/.claude/skills/"
uid=5_433 StaticText "Project:"
uid=5_434 StaticText " "
uid=5_435 StaticText ".claude/skills/"
uid=5_436 heading "调试命令" level="4"
uid=5_437 StaticText "claude --debug"
uid=5_438 StaticText " "
uid=5_439 StaticText "# 查看加载错误"
uid=5_440 StaticText ""What Skills available?""
uid=5_441 StaticText " "
uid=5_442 StaticText "# 列出 Skills"
uid=5_443 heading "Description 公式" level="4"
uid=5_444 StaticText "[动作清单] + [触发场景] + [使用时机]"
uid=5_445 heading "必备文件" level="4"
uid=5_446 StaticText "SKILL.md"
uid=5_447 StaticText " (必需,大写)"
uid=5_448 heading "相关资源" level="2"
uid=5_449 StaticText "深入学习 Agent Skills"
uid=5_450 link "anthropic/skills 官方 Skills 仓库 16 个生产级 Skills 参考实现" url="https://github.com/anthropics/skills"
uid=5_451 heading "anthropic/skills" level="4"
uid=5_452 StaticText "官方 Skills 仓库"
uid=5_453 StaticText "16 个生产级 Skills 参考实现"
uid=5_454 link "Claude Code 文档 code.claude.com 官方使用指南" url="https://code.claude.com/docs/en/skills"
uid=5_455 heading "Claude Code 文档" level="4"
uid=5_456 StaticText "code.claude.com"
uid=5_457 StaticText "官方使用指南"
uid=5_458 link "工程博客 anthropic.com Agent Skills 设计理念" url="https://anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills"
uid=5_459 heading "工程博客" level="4"
uid=5_460 StaticText "anthropic.com"
uid=5_461 StaticText "Agent Skills 设计理念"
uid=5_462 link "官方模板 GitHub 快速开始创建 Skill" url="https://github.com/anthropics/skills/blob/main/template/SKILL.md"
uid=5_463 heading "官方模板" level="4"
uid=5_464 StaticText "GitHub"
uid=5_465 StaticText "快速开始创建 Skill"
uid=5_466 contentinfo
uid=5_467 StaticText "Agent Skills Guide - 让 Claude 学会你的工作方式"
uid=5_468 link "GitHub" url="https://github.com/Ekko7778/claude-skills-guide"
uid=5_469 StaticText "GitHub"
uid=5_470 link "官方文档" url="https://docs.anthropic.com/en/docs/build-with-claude/agent-skills"
uid=5_471 StaticText "官方文档"
uid=5_472 button "Menu"
uid=5_473 button "Inspect"
uid=5_474 button "Audit"
uid=5_475 button "Settings"