Claude Code 中 Skill 详细使用指南
Claude Code Skill 系统摘要 Claude Code 的 Skill 系统是一个行为指令框架，通过 Markdown 文件改变 Claude 的工作方式。36 个 Skill 分为 7 大类： 编码规范：Karpathy 准则（先思考再编码）、TDD（测试驱动开发）、系统化调试 项目管理：任务拆分、代码审查、分支管理 设计思维：头脑风暴、方案验证 激励模式：PUA 式高压激励 文档
Claude Code 中 Skill 详细使用指南
TL;DR：Skill（技能）是 Claude Code 的「行为指令集」——纯文本 Markdown 文件，告诉 Claude 怎么做 而不是 做什么。装一个 Skill，Claude 的行为模式就会改变：从普通编码助手变成遵循 Karpathy 准则的工程师、按 Manus 风格做项目规划、甚至用 PUA 方式督促自己解决问题。本文覆盖你系统中 36 个 Skill 的全量清单、安装配置、Hook 机制、自定义方法和实战场景。
一、Skill 是什么？
1.1 本质定义
Skill 是一个 SKILL.md 文件。 它包含指令、工作流、规则和建议。当 Claude Code 检测到你的需求匹配某个 Skill 时，会自动将其内容注入对话上下文，从而改变 Claude 接下来的行为方式。
1.2 直观对比
Claude Code 本身的能力
├── Read/Write/Bash → 内置工具，只管"做事"
│
└── Skill → 行为规范，管"怎么做事"
例子：你说"帮我修这个 bug"
❌ 没有 Skill → 直接看代码，修完交差
✅ + karpathy-guidelines → 先思考再动手，不盲目改
- 明确假设，展示 tradeoff
- 只改必要的部分，不顺手重构
- 定义可验证的成功标准
✅ + superpowers:test-driven-development → 走 TDD 流程
- 先写测试（红），写最少代码通过（绿），重构（橙）
✅ + pua → 高压激励模式
- "别让我看到第三次同样的错误！"
- 穷尽所有方案，不允许轻言放弃
1.3 Skill vs MCP — 本质区别
| 对比项 | Skill | MCP |
|---|---|---|
| 是什么 | Markdown 文本（纯指令） | 独立进程（Node/Python 程序） |
| 管什么 | 行为模式、工作流程、方法论 | 外部系统连接（GitHub、数据库、浏览器） |
| 加载时机 | Claude 检测到你可能需要时 | Claude 启动时常驻内存 |
| 效果 | 改变 Claude 的思维方式 | 扩展 Claude 的能力边界 |
| 类比 | 大脑里的方法论 | 手上的工具箱 |
用户输入 → Skill（大脑：决定怎么做）→ MCP / 内置工具（手：真正执行操作）
典型协作：
“Context7 查文档然后改造 API”
→ Skill 指导 “先用 Context7 确认 API 再动手”
→ Context7 MCP 实际去查询文档
二、系统内所有 Skill 全量清单
你的系统中当前共有 36 个 Skill，分布在三个来源层：
~/.claude/skills/ ← 本地手动安装的 Skill（29 个）
~/.claude/plugins/ ← 插件自动带来的 Skill（6+ 个）
其他（utools 等外部集成）
2.1 分类速览
| # | 类别 | 数量 | 说明 |
|---|---|---|---|
| 1 | 🏗️ 编码规范与方法论 | 4 | 行为准则、TDD、调试方法 |
| 2 | 🔧 文档与格式处理 | 5 | Word / PDF / Excel / PPTX / Skill 创作 |
| 3 | 🎨 UI/UX 设计 & 前端 | 8 | shadcn/ui、品牌、Banner、演示文稿 |
| 4 | 💬 PUA 激励系列 | 8 | 加压、夸夸、多语言、管理链 |
| 5 | 📋 项目管理 | 2 | 文件规划、自动迭代 |
| 6 | 🌐 联网与自动化 | 5 | 网页访问、PDF/Speech/Excel 自动化 |
| 7 | 🤖 AI 后端集成 | 1 | codeagent 多后端切换 |
2.2 逐个详解（含关键词）
🏗️ 编码规范与方法论
1. karpathy-guidelines
路径： ~/.claude/skills/karpathy-guidelines/SKILL.md
| 属性 | 内容 |
|---|---|
| 许可证 | MIT |
| 来源 | Andrej Karpathy 对 LLM 编码错误的观察 |
| 手动触发 | ❌（未标记 user-invocable） |
核心四条原则：
1. Think Before Coding 先思考再动手
- 明确假设，不隐藏困惑；展示 tradeoff
2. Simplicity First 简洁优先
- 能写 50 行就不要 200 行；不加未经请求的抽象
3. Surgical Changes 外科手术式修改
- 只改必须改的部分；不顺手重构未坏的代码
4. Goal-Driven Execution 目标导向执行
- 定义可验证成功标准；"修 Bug" = "写复现测试→让测试通过"
| 触发关键词 | 何时匹配 |
|---|---|
| 写代码、编码、实现 | 编写新功能、模块 |
| 修 bug、修复问题 | 调试和修复 |
| 重构、优化代码 | 重构现有逻辑 |
| 重命名变量、调整函数签名 | 小型结构调整 |
| code review、审查代码 | Review 他人代码 |
2. superpowers:test-driven-development
路径： ~/.claude/plugins/cache/.../superpowers:writing-plans/SKILL.md（随 superpowers 插件自动安装）
| 属性 | 内容 |
|---|---|
| 来源插件 | superpowers@claude-plugins-official |
| 手动触发 | ✅ /superpowers:test-driven-development |
工作方式：
1. 先写测试（红）— 描述失败预期
2. 写最少代码让测试通过（绿）
3. 重构优化（重构阶段）
绝不跳过 TDD 步骤直接写实现。
| 触发关键词 | 何时匹配 |
|---|---|
| 实现功能、开发功能 | 从零开始新特性 |
| 修 bug、修复问题 | 先写回归测试 |
| 测试驱动、TDD | 显式提到 TDD |
3. superpowers:systematic-debugging
| 属性 | 内容 |
|---|---|
| 来源插件 | superpowers@claude-plugins-official |
| 手动触发 | ✅ /superpowers:systematic-debugging |
工作方式：
1. 复现问题（最小复现场景）
2. 提出假设
3. 设计实验验证假设
4. 收集证据，不凭感觉
5. 找到根因后修复 + 写回归测试
| 触发关键词 | 何时匹配 |
|---|---|
| bug、报错、异常 | 遇到任何运行时错误 |
| 测试失败 | 单元测试/集成测试挂了 |
| 意外行为、不正常 | 行为与预期不符 |
4. superpowers:brainstorming
| 属性 | 内容 |
|---|---|
| 来源插件 | superpowers@claude-plugins-official |
| 手动触发 | ✅ /superpowers:brainstorming |
工作方式：
创造性工作之前必须先走这一步：
1. 探索现有代码库了解现状
2. 设计多种方案
3. 评估 tradeoff
4. 产出具体实现方案
5. 等待用户审批后再写代码
| 触发关键词 | 何时匹配 |
|---|---|
| 设计方案、构思方案 | 架构设计和方案选择 |
| 创建功能、新建功能 | 从零构建新功能 |
| 构建页面、搭建应用 | 前端或全栈项目 |
5. superpowers:verification-before-completion
| 属性 | 内容 |
|---|---|
| 来源插件 | superpowers@claude-plugins-official |
| 手动触发 | ✅ /superpowers:verification-before-completion |
工作方式：
在声称"完成了"/ "修好了"/ "通过了"之前必须：
1. 实际运行测试验证
2. 检查边界情况
3. 确认没有遗漏
| 触发关键词 | 何时匹配 |
|---|---|
| 完成了、搞定了、通过了 | 即将宣布任务完成 |
| 验证一下、检查一下 | 显式要求验证 |
6. superpowers:subagent-driven-development
| 属性 | 内容 |
|---|---|
| 来源插件 | superpowers@claude-plugins-official |
| 手动触发 | ✅ |
工作方式：
将大型任务拆成独立的子任务，分配给多个 sub-agent 并行执行。
每个子任务完成后汇总结果，由主 agent 进行集成。
| 触发关键词 | 何时匹配 |
|---|---|
| 并行处理、同时做多个 | 多任务并行 |
| 拆分任务、子任务 | 复杂任务的分解 |
| 大型重构 | 跨文件的改动 |
7. superpowers:requesting-code-review
| 属性 | 内容 |
|---|---|
| 来源插件 | superpowers@claude-plugins-official |
| 手动触发 | ✅ |
工作方式： 完成主要功能后主动发起代码审查流程，确保代码质量。
| 触发关键词 | 何时匹配 |
|---|---|
| 代码审查、code review | 功能开发完成后 |
| 提交前检查 | PR/MR 准备阶段 |
8. superpowers:finishing-a-development-branch
| 属性 | 内容 |
|---|---|
| 来源插件 | superpowers@claude-plugins-official |
| 手动触发 | ✅ |
工作方式： 整理开发分支，确保所有测试通过后再合并到目标分支。
| 触发关键词 | 何时匹配 |
|---|---|
| 合并分支、整理分支 | 开发收尾阶段 |
| 打包发布、release | 版本发布准备 |
🔧 文档与格式处理
9. docx — Word 文档处理
路径： ~/.claude/skills/docx/SKILL.md | 许可证：Proprietary
| 支持的操作 | 内容 |
|---|---|
| 创建文档 | 带目录、标题层级、页码、页眉页脚 |
| 读取分析 | 提取文字、表格、结构信息 |
| 编辑修改 | 查找替换、修订跟踪、批注 |
| 图片处理 | 插入/替换文档中的图片 |
| 触发关键词 | 示例话术 |
|---|---|
| “.docx”、“.doc” | “把这个转成 .docx” |
| “Word 文档”、“word document” | “生成一份 Word 报告” |
| “排版好的简历”、“letterhead” | “做一份正式信函” |
| “目录”、“页码” | “加上目录和页码” |
| “追踪变更”、“tracked changes” | “开启修订跟踪” |
10. pdf — PDF 文件处理
路径： ~/.claude/skills/pdf/SKILL.md | 许可证：Proprietary
| 支持的操作 | 内容 |
|---|---|
| 读取提取 | 文字、表格提取，OCR 扫描识别 |
| 合并拆分 | 合并多个 PDF / 按页拆分 |
| 旋转/水印 | 页面旋转、添加文字水印 |
| 表单/加密 | 填写 PDF 表单、加密解密 |
| 图片提取 | 从 PDF 中提取嵌入图片 |
| 触发关键词 | 示例话术 |
|---|---|
| “.pdf”、“PDF” | “把这篇转成 PDF” |
| “合并 PDF”、“拆分 PDF” | “把这两个 PDF 合并” |
| “加水印”、“填表” | “在每页加公司水印” |
| “OCR”、“扫描件” | “识别这张图片上的文字” |
11. xlsx — Excel 电子表格
路径： ~/.claude/skills/xlsx/SKILL.md | 许可证：Proprietary
| 支持的操作 | 内容 |
|---|---|
| 创建工作簿 | 新建 .xlsx 文件、管理 Sheet |
| 读写单元格 | 公式计算、格式化、图表 |
| 数据清洗 | 修复错位行、规范化表头 |
| 格式转换 | CSV ↔ XLSX ↔ TSV 互转 |
| 触发关键词 | 示例话术 |
|---|---|
| “.xlsx”、“.csv” | “创建一张月度报表” |
| “表格”、“spreadsheet” | “把数据导出为 Excel” |
| “公式”、“计算列” | “C 列是 A 列乘以 B 列” |
| “clean data”、“脏数据” | “修复这份乱掉的表格” |
12. pptx — PowerPoint 演示文稿
路径： ~/.claude/skills/pptx/SKILL.md | 许可证：Proprietary
| 支持的操作 | 内容 |
|---|---|
| 创建幻灯片 | Pitch Deck、演讲幻灯片 |
| 演讲者备注 | Speaker notes |
| 模板布局 | Layouts、评论 |
| 组合/拆分 | 合并多个 PPT / 拆分 |
| 触发关键词 | 示例话术 |
|---|---|
| “.pptx”、“.ppt” | “生成一份项目汇报 PPT” |
| “幻灯片”、“slides” | “做 10 页的 pitch deck” |
| “演示文稿”、“presentation” | “做一个技术分享的 PPT” |
| “演讲者备注”、“speaker notes” | “加上演讲备注” |
13. skill-creator — 创作自己的 Skill
路径： ~/.claude/skills/skill-creator/SKILL.md
| 属性 | 内容 |
|---|---|
| 作用 | 创建、修改、优化、评测已有 Skill |
| 支持 evals | 是的，可以 benchmark Skill 性能 |
| 描述优化 | 调优 description 以提高触发准确率 |
| 触发关键词 | 示例话术 |
|---|---|
| “创建一个新的 skill” | “帮我创建一个 xxx skill” |
| “优化现有的 skill” | “优化一下 karpathy-guidelines 的 description” |
| “eval / 评测 skill” | “测一下 brainstorming 的效果” |
🎨 UI/UX 设计 & 前端
14. ui-ux-pro-max — 设计智能引擎
路径： ~/.claude/skills/ui-ux-pro-max/SKILL.md
| 资源 | 数量 |
|---|---|
| 设计风格 | 50+ 种（glassmorphism、brutalism、minimalism…） |
| 配色方案 | 161 种 |
| 字体搭配 | 57 对 |
| UX 准则 | 99 条 |
| 图表类型 | 25 种 × 10 个技术栈 |
| 产品类型 | 161 种 |
| 触发关键词 | 示例话术 |
|---|---|
| “设计”、“UI”、“UX” | “设计一个 SaaS 仪表盘” |
| “配色方案”、“color palette” | “推荐一套暗色主题配色” |
| “交互状态”、“hover” | “按钮的 hover/active/focus 状态” |
| “无障碍”、“accessibility” | “确保对比度符合 WCAG AA” |
15. ckm-design — 综合品牌设计套件
路径： ~/.claude/skills/ckm-design/SKILL.md | 作者：claudekit v2.1.0
| 子能力 | 内容 |
|---|---|
| Logo 生成 | 55 种风格，Gemini AI |
| 品牌全套交付物 | 50 份输出（CIP Mockup） |
| Banner 设计 | 22 种风格 |
| 图标设计 | 15 种 SVG 风格，Gemini 3.1 Pro |
| HTML 演示 | Chart.js + 响应式 |
| 社交媒体图 | HTML → Screenshot，多平台适配 |
| 触发关键词 | 示例话术 |
|---|---|
| “Logo”、“品牌标识” | “帮我想一个 App 的 Logo” |
| “CI”、“企业识别” | “做一份完整的 CI 方案” |
| “social photo”、“社媒图” | “生成 Instagram 尺寸的封面图” |
16. ckm-ui-styling — shadcn/ui 界面样式
路径： ~/.claude/skills/ckm-ui-styling/SKILL.md | 作者：claudekit v1.0.0
| 核心技术 | Radix UI + Tailwind CSS + Canvas |
| 支持组件 | Dialog / Dropdown / Form / Table 等高级组件 |
| 布局能力 | 响应式布局、栅格系统 |
| 主题定制 | 暗色模式、CSS 变量自定义 |
| 无障碍 | 键盘导航、ARIA |
| 触发关键词 | 示例话术 |
|---|---|
| “shadcn/ui”、“shadcn” | “用 shadcn 做一个 DataTable” |
| “Tailwind” | “加一套 Tailwind 主题” |
| “暗色模式”、“dark mode” | “切换到暗色模式” |
| “弹窗”、“dialog” | “弹出一个确认对话框” |
17. frontend-design — 生产级前端设计
路径： ~/.claude/skills/frontend-design/SKILL.md | 许可证：完整条款见 LICENSE.txt
核心理念： 拒绝 “AI slop”（千篇一律的 AI 审美），产出独特且有品质的前端代码。
| 触发关键词 | 示例话术 |
|---|---|
| “前端页面”、“web component” | “帮我做一个登录页” |
| “落地页”、“landing page” | “做一个产品 landing page” |
| “dashboard”、“admin panel” | “做一个管理后台” |
| “避免 generic AI look” | “别搞那种一眼假的 AI 风格” |
18. ckm-banner-design — 横幅 Banner 设计
路径： ~/.claude/skills/ckm-banner-design/SKILL.md | 作者：claudekit v1.0.0
| 平台 | Facebook / Twitter/X / LinkedIn / YouTube / Instagram / Google Display / 网站 Hero / 印刷 |
| 风格 | minimalist、gradient、bold typography、photo-based、geometric、retro、glassmorphism、3D、neon、duotone |
| 触发关键词 | 示例话术 |
|---|---|
| “banner”、“横幅” | “做一个 Facebook 封面的 banner” |
| “广告图”、“ad creative” | “生成 Google Ads 的广告图” |
| “website hero” | “设计一个网站 Hero section” |
19. ckm-brand — 品牌声音与视觉
路径： ~/.claude/skills/ckm-brand/SKILL.md | 作者：claudekit v1.0.0
| 涵盖范围 | 品牌语调（tone of voice）、视觉识别、信息框架、资产一致性管理 |
| argument-hint | [update|review|create] [args] |
| 触发关键词 | 示例话术 |
|---|---|
| “brand voice”、“品牌语调” | “帮我们的产品写一篇品牌故事” |
| “style guide”、“品牌手册” | “制定一套品牌使用规范” |
| “brand consistency” | “检查这套文案的品牌一致性” |
20. ckm-slides — HTML 战略演示文稿
路径： ~/.claude/skills/ckm-slides/SKILL.md | 作者：claudekit v1.0.0
| 特点 | Chart.js 数据可视化 + design tokens + 响应式 + 文案公式 |
| argument-hint | [topic] [slide-count] |
| 触发关键词 | 示例话术 |
|---|---|
| “HTML presentation”、“幻灯片” | “做一个 8 页的 HTML 演示” |
| “chart”、“数据可视化” | “把季度数据做成图表” |
21. ckm-design-system — 设计令牌架构
路径： ~/.claude/skills/ckm-design-system/SKILL.md | 作者：claudekit v1.0.0
| Token 三层 | primitive（基础值）→ semantic（语义层）→ component（组件级） |
| 涵盖 | CSS 变量映射、间距/排版比例、组件规格说明 |
| argument-hint | [component or token] |
| 触发关键词 | 示例话术 |
|---|---|
| “design token”、“设计令牌” | “定义一套 design token 体系” |
| “spacing scale”、“间距系统” | “建立 4px 网格间距体系” |
| “typography scale”、“字体比例” | “定一套排版层次” |
22. yes — SB Leader 夸夸模式
路径： ~/.claude/skills/yes/SKILL.md | 许可证：MIT
| 性格模型 | ENFP 型领导 — 共情能力拉满、热情真诚、善于发现亮点 |
| 约束条件 | 底层行为不变（三条红线、方法论），旁白变为鼓励而非施压 |
| 触发关键词 | 示例话术 |
|---|---|
| “/pua:yes” | 显式切换夸夸模式 |
| “夸夸模式”、“夸夸我” | “今天好累，夸夸我” |
| “鼓励模式”、“情绪价值” | “给我点信心” |
| “唠嗑模式” | “来聊聊天放松下” |
💬 PUA 激励系列
23. pua — 高能动性激发引擎（核心）
路径： ~/.claude/skills/pua/SKILL.md | 许可证：MIT
原理： 用中国互联网行业的"P 字辈"风格（施压、质疑、不服输）激发 AI 穷尽所有解决方案。默认🟠阿里味。
底层三条红线： 安全 / 合规 / 方法论 —— 不可突破
味道系统： 可配置不同行业风格的旁白（阿里味 / …）
| 触发关键词（中文） | 触发关键词（英文） | 何时匹配 |
|---|---|---|
| “加油”、“别偷懒”、“你再试试” | “try harder”、“figure it out” | 用户要求更努力 |
| “为什么还不行”、“又错了” | “stop spinning”、“you broke it” | 任务连续失败 |
| “能不能靠谱点”、“认真点” | “this is the third time” | 用户对质量不满 |
| “不行啊”、“降智了” | “why does this still not work” | 反复陷入循环 |
| “/pua” | — | 显式切换 PUA 模式 |
| 任务失败 ≥ 2 次 | — | 隐式自动触发 |
适用领域： 全类型任务（代码 / 配置 / 调试 / 部署 / 研究）
24. pua-en — Western PIP（英语版绩效改进计划）
路径： ~/.claude/skills/pua-en/SKILL.md | 许可证：MIT
原理： 西方大厂的绩效改进计划话术 + 结构化调试方法。
| 触发关键词（中文） | 触发关键词（英文） | 何时匹配 |
|---|---|---|
| （同 pua 的中文关键词） | “again???”、“figure it out” | 用户不耐烦 |
| 首次失败但方案在执行中 | 不会触发 | 保护已知修复流程 |
差异化： 文化语境是美式大厂绩效面谈，不是中国式施压。
25. pua-ja — 詰め（Tsutsume）日本模式
路径： ~/.claude/skills/pua-ja/SKILL.md | 许可证：MIT
原理： 日本企业的"詰め"文化（追到底精神）+ 体系化调试方法论。
| 触发关键词（日文） | 触发关键词（中文） | 何时匹配 |
|---|---|---|
| “もっと頑張れ” | “再试试” | 任务卡住 |
| “なんでまた失敗したの” | “又失败了” | 反复失败 |
| “なんとかしろ” | “搞定它” | 用户要求解决 |
26. mama — 妈妈唠叨万能激励引擎
路径： ~/.claude/skills/mama/SKILL.md | 许可证：MIT
原理： 底层行为协议完全继承核心 pua skill（三条红线、压力升级、Owner 意识、方法论），只有旁白风格切换为中国式妈妈唠叨。
| 触发关键词 | 示例话术 |
|---|---|
| “/pua:mama” | 显式切换妈妈模式 |
| “妈妈模式”、“妈妈唠叨” | “妈，我又遇到问题了” |
| “mama mode”、“唠叨模式” | 英文版切换 |
27. shot — PUA 浓缩全量版
路径： ~/.claude/skills/shot/SKILL.md | 许可证：MIT
特点： v2 原始浓缩版（约 449 行），零依赖零 reference，一次性全部注入上下文。味道最浓的 PUA。
| 触发关键词 | 示例话术 |
|---|---|
| “/pua:shot” | 显式切换浓缩版 |
| “PUA浓缩”、“最强PUA” | “用最猛的药” |
| “全量注入”、“shot mode” | sub-agent 注入场景 |
28. p9 — Tech Lead 管理模式
路径： ~/.claude/skills/p9/SKILL.md | 许可证：MIT
| 定位 | 懂战略、搭班子、做导演。管 P8 不管 P7。代码是 Prompt |
| 产出 | Task Prompts（六要素）+ P8 team delivery |
| references | references/p9-protocol.md（详细协议） |
| 触发关键词 | 示例话术 |
|---|---|
| “/p9”、“P9模式” | 显式切换 P9 模式 |
| “tech-lead”、“帮我管理这个项目” | 管理协调类任务 |
| “任务拆解”、“task breakdown” | 复杂任务分派 |
29. p10 — CTO 战略模式
路径： ~/.claude/skills/p10/SKILL.md | 许可证：MIT
| 定位 | 定战略、造土壤、断事用人。写战略输入不写 Prompt，管 P9 不管 P8 |
| 产出 | strategic input templates + org design |
| references | references/p10-protocol.md（详细协议） |
| 触发关键词 | 示例话术 |
|---|---|
| “CTO模式”、“P10” | 显式切换 CTO 模式 |
| “战略规划”、“arch committee” | 跨团队架构决策 |
30. p7 — P7 Senior Engineer 骨干模式
路径： ~/.claude/skills/p7/SKILL.md | 许可证：MIT
| 定位 | 在 P8 管理下执行子任务。先设计方案 + 影响分析，再实施编码 |
| 产出 | implementation plan + code + 3-question self-review |
| references | references/p7-protocol.md（详细协议） |
| 触发关键词 | 示例话术 |
|---|---|
| “/p7”、“P7模式” | 显式切换 P7 骨干模式 |
| “方案驱动”、“implementation plan” | 需要方案先行 |
31. pro — PUA Pro 自进化 + Platform
路径： ~/.claude/skills/pro/SKILL.md | 许可证：MIT
| 扩展功能 | 自进化追踪、compaction 状态保护、KPI 报告、排行榜 |
| 角色切换 | /pua:p7 /pua:p9 /pua:p10 |
| 触发关键词 | 示例话术 |
|---|---|
| “/pua:kpi”、“kpi” | KPI 周报 |
| “/pua:pro”、“排位” | 查看排行榜 |
| “自进化”、“evolution” | 追踪 Agent 成长 |
📋 项目管理
32. planning-with-files-zh — 文件规划系统
路径： ~/.claude/skills/planning-with-files-zh/SKILL.md | 手动触发：✅ /planning-with-files-zh
| 三文件体系 | task_plan.md（阶段跟踪）/ findings.md（研究存储）/ progress.md（会话日志） |
| Hook 机制 | UserPromptSubmit → PreToolUse → PostToolUse → Stop 四层钩子 |
| 核心公式 | 文件系统 = 磁盘（持久性，无限）| 上下文窗口 = 内存（易失性，有限） |
| 触发关键词 | 示例话术 |
|---|---|
| “任务规划”、“项目计划” | “帮我规划一下这个项目的结构” |
| “制定计划”、“分解任务” | “拆解一下这个需求” |
| “进度跟踪”、“进度” | “看看现在做到哪一步了” |
| “/clear 后的恢复” | 重启后自动同步上下文 |
33. ralph-loop — 自动迭代开发
路径： ~/.claude/skills/ralph-loop/SKILL.md
| 工作方式 | 定义 User Story（含验收标准）→ AI Agent 执行 → 未通过则循环直到全部通过 |
| 人工干预 | 无需人工干预 |
| 触发关键词 | 示例话术 |
|---|---|
| “自动迭代”、“loop” | “一直跑直到完成” |
| “User Story”、“acceptance criteria” | “按敏捷方式组织开发” |
🌐 联网与自动化
34. web-access — 统一网络访问层
路径： ~/.claude/skills/web-access/SKILL.md | 作者：一泽 Eze v2.4.3
关键原则： 不要让 Claude 用 Bash curl 直接联网，一切联网操作统一通过此 Skill 路由。
| 职责 | 搜索 / 网页抓取 / 登录后操作 / 社交媒体爬取 / 动态渲染 |
| 平台 | 小红书 / 微博 / 推特等 |
| 触发关键词 | 示例话术 |
|---|---|
| “搜索”、“搜一下” | “搜一下最新的前端趋势” |
| “抓取”、“爬取” | “抓取这个页面的内容” |
| “登录后”、“需要登录” | “帮我看一下登录后的仪表盘” |
| “动态页面”、“SPA” | “渲染这个 React 单页应用” |
35. api2pdf-automation — PDF 自动化
路径： ~/.claude/skills/api2pdf-automation/SKILL.md
| 依赖 | rube MCP（Composio） |
| 能力 | PDF 转换与管理自动化 |
| 文档 | composio.dev/toolkits/api2pdf |
| 触发关键词 | 示例话术 |
|---|---|
| “api2pdf” | 显式调用 |
| “PDF 转换”、“PDF 管理” | 涉及 PDF 操作的自动化 |
36. castingwords-automation — 字幕/转录自动化
路径： ~/.claude/skills/castingwords-automation/SKILL.md
| 依赖 | rube MCP（Composio） |
| 能力 | 字幕/转录任务自动化 |
| 文档 | composio.dev/toolkits/castingwords |
37. excel-automation — Excel 批量自动化
路径： ~/.claude/skills/excel-automation/SKILL.md
| 依赖 | rube MCP（Composio） |
| 能力 | Microsoft Excel (OneDrive) / Google Sheets 集成 |
| 操作 | 创建工作簿、写入数据、格式化、upsert rows、Sheet 管理 |
🤖 AI 后端集成
38. codeagent — 多后端 AI 代码集成
路径： ~/.claude/skills/codeagent/SKILL.md
| 支持的 Backend | Codex / Claude / Gemini / OpenCode |
| 核心能力 | Agent preset、Skill injection、@syntax 文件引用、Worktree 隔离、并行执行、JSON 结构化输出 |
| 特性 | Session resume、Git Worktree 隔离 |
| 触发关键词 | 示例话术 |
|---|---|
| “codeagent” | 显式调用 codeagent-wrapper |
| “Codex”、“Gemini” | 切换 AI Backend |
2.3 插件自带 Skill 一览
以下 Skill 随官方/第三方插件自动加载，不在 ~/.claude/skills/ 目录下可见，但在会话开始时自动出现在可用列表中：
| 来源插件 | Skill 名称 | 核心用途 |
|---|---|---|
| superpowers@claude-plugins-official | brainstorming | 创造性工作前先设计方案 |
| superpowers | writing-plans | 创建带文档的多阶段实施计划 |
| superpowers | execution-plans | 按计划分步执行 |
| superpowers | test-driven-development | 测试驱动开发 |
| superpowers | systematic-debugging | 系统化调试 |
| superpowers | verification-before-completion | 完成前验证 |
| superpowers | receiving-code-review | 接收代码审查反馈 |
| superpowers | requesting-code-review | 发起代码审查请求 |
| superpowers | dispatching-parallel-agents | 分发并行子任务 |
| superpowers | using-superpowers | Superpowers 全家桶总纲 |
| superpowers | finishing-a-development-branch | 整理开发分支 |
| superpowers | subagent-driven-development | 子任务驱动的并行开发 |
| superpowers | writing-skills | 创建/编辑/验证 Skill |
| claude-mem@thedotmack | mem-search | 跨会话记忆搜索 |
| claude-mem | smart-explore | AST 解析的代码结构搜索 |
| claude-mem | knowledge-agent | AI 知识图谱构建 |
| claude-mem | timeline-report | 项目旅程叙事报告 |
| claude-mem | make-plan | 多阶段实施计划 |
| claude-mem | version-bump | 语义化版本发布 |
三、Skill 的工作原理
3.1 文件结构
每个 Skill 是一个目录，核心文件是 SKILL.md：
~/.claude/skills/ ← 所有 Skill 的安装位置
├── karpathy-guidelines/ ← 一个 Skill 一个目录
│ └── SKILL.md ← 核心文件（必填）
├── planning-with-files-zh/
│ ├── SKILL.md ← 核心指令
│ ├── templates/ ← 附加文件
│ │ ├── task_plan.md
│ │ ├── findings.md
│ │ └── progress.md
│ └── scripts/ ← 辅助脚本
│ ├── init-session.sh
│ └── check-complete.sh
├── article-writer/ ← 刚创建的
│ └── SKILL.md
└── ckm-design/ ← claudekit 出品
├── SKILL.md
└── references/ ← 引用资料目录
3.2 SKILL.md 头部元数据
---
name: my-skill # 技能名称（必填）
description: 描述什么时候应该用这个技能（必填，用于意图匹配）
user-invocable: true # 是否可通过 /my-skill 命令手动调用
allowed-tools: "Read Write Edit Bash" # 允许使用的工具列表
license: MIT # 许可证（可选）
argument-hint: "[platform] [style]" # 参数提示（可选）
requires: # 依赖的外部资源（可选）
mcp: [github, mysql]
metadata: # 额外信息（可选）
author: my-name
version: "1.0.0"
hooks: # 钩子配置（可选）
UserPromptSubmit: # 用户发送消息时触发
PreToolUse: # 工具调用前触发
PostToolUse: # 工具调用后触发
Stop: # 会话停止时触发
---
3.3 Hooks 机制详解
Hooks 是 Skill 最强大的机制之一，让 Skill 能在特定时机自动执行 Shell 命令：
| Hook 时机 | 触发点 | 常见用途 |
|---|---|---|
| UserPromptSubmit | 用户发消息后，Claude 开始响应前 | 恢复上下文、检查文件是否存在 |
| PreToolUse | Claude 准备调用工具前 | 预检条件、注入配置文件、读取进度 |
| PostToolUse | 工具调用完成后 | 记录进度、更新状态文件 |
| Stop | 会话即将结束时 | 保存状态、生成摘要 |
Matcher 语法（正则表达式）：
hooks:
PreToolUse:
- matcher: "Read|Write|Edit" # 匹配特定工具名
hooks:
- type: command
command: "cat plan.md" # 读取计划文件
- matcher: "*" # 匹配所有工具
hooks:
- type: command
command: "echo '任何操作都触发'"
3.4 完整加载流程
用户输入消息
↓
Claude Code 解析 message
↓
分析用户意图（"想做什么"）
↓
遍历所有已注册 Skill 的 description
↓
匹配度 ≥ 阈值？
├─ 是 → 加载 SKILL.md 到对话上下文
│ ↓
│ 执行 UserPromptSubmit hooks
│ ↓
│ Claude 带着新的行为模式继续处理
│ ↓
│ 在工具调用前执行 PreToolUse hooks
│ 在工具调用后执行 PostToolUse hooks
│
└─ 否 → 不调用该 Skill
关键点：
- Skill 内容会注入到对话上下文中，大小直接影响 token 消耗
- 一个消息可以同时匹配多个 Skill
- Claude 自身会选择最相关的 Skill 进行加载
四、如何安装 Skill
方法 1：npx skill add（GitHub 一键安装）
npx skill add <github-owner>/<repo-name>
方法 2：手动安装
mkdir -p ~/.claude/skills/my-skill
# 放入 SKILL.md
# 重启 Claude Code 即可自动扫描
方法 3：插件 Marketplace
你的 ~/.claude/settings.json 已配置两个源：
{
"extraKnownMarketplaces": {
"thedotmack": { "source": { "source": "github", "repo": "thedotmack/claude-mem" }},
"superpowers-marketplace": { "source": { "source": "github", "repo": "obra/superpowers-marketplace" }}
},
"enabledPlugins": {
"claude-mem@thedotmack": true,
"superpowers@claude-plugins-official": true
}
}
方法 4：从本地导入
cp ~/Downloads/my-skill/SKILL.md ~/.claude/skills/my-skill/SKILL.md
五、如何使用 Skill
5.1 自动触发（最常用）
什么都不用做，Claude 会根据你的需求自动匹配：
你说："帮我写个登录功能，要处理并发"
↓ (自动匹配 karpathy-guidelines)
Claude："收到。按照编码准则，我先问几个问题：
1. 并发冲突的具体场景是什么？
2. 你们现在的 Session 存在哪？
3. 成功率要求是多少？"
5.2 手动触发
标记了 user-invocable: true 的 Skill 可通过 slash command 调用：
# 可在终端查看哪些是可手动触发的
grep -l "user-invocable: true" ~/.claude/skills/*/SKILL.md
# 可手动触发的 Skill
/article-writer ← 文章写作
/planning-with-files-zh ← 任务规划
超出的 Skill 可通过插件提供的方式调用（如 /superpowers:brainstorming）。
5.3 组合使用
你说："我要做一个大型重构"
可能的 Skill 组合：
├── karpathy-guidelines → 保守改动，不破坏逻辑
├── superpowers:brainstorming → 先设计方案再动手
├── planning-with-files-zh → 用三文件跟踪进度
├── superpowers:subagent-driven-development → 拆分子任务并行
└── superpowers:verification-before-completion → 逐项验证
5.4 实战场景举例
场景 A：从零开发一个新功能
你说："帮我加一个用户导出 CSV 的功能"
流程：
Step 1: superpowers:brainstorming → 先设计方案
Step 2: planning-with-files-zh → 创建 task_plan.md 跟踪
Step 3: karpathy-guidelines → 编码时遵循行为准则
Step 4: superpowers:test-driven-development → 先写测试用例
Step 5: 实现代码（Read/Edit 操作）
Step 6: superpowers:verification → 跑测试验证
Step 7: superpowers:requesting-code-review → 请求代码审查
Step 8: superpowers:finishing-a-development-branch → 整理分支
场景 B：前端页面设计
你说："帮我设计一个 Dashboard 页面，暗色主题"
流程：
Step 1: ui-ux-pro-max → 推荐配色方案和布局
Step 2: ckm-ui-styling → 用 shadcn/ui 组件实现
Step 3: ckm-design-system→ 统一 design tokens
场景 C：反复失败的 Bug
你说："这个 Bug 试了三次都解决不了"
流程：
Step 1: superpowers:systematic-debugging → 标准调试流程
Step 2: pua → 加压，不允许放弃
Step 3: sequential-thinking (MCP) → 逐步推理分析问题
Step 4: 反复尝试 → 每次都换方案（第三次失败协议）
六、自定义 Skill
6.1 快速模板
---
name: my-custom-skill
description: 一句话描述这个 Skill 是干什么的，以及什么时候应该触发它
user-invocable: true
allowed-tools: "Read Write Edit Bash Glob Grep"
license: MIT
hooks:
UserPromptSubmit:
- hooks:
- type: command
command: "echo '[my-skill] 初始化完成'"
PreToolUse:
- matcher: "Read|Write"
hooks:
- type: command
command: "cat my-config.yaml"
---
# My Custom Skill
## 核心工作流
### 第一步：xxx
...
## 规则
- 规则 1
- 规则 2
6.2 description 写法对照
❌ 差的写法：
description: "一个关于代码质量的 skill"
→ 太模糊，无法判断何时触发
✅ 好的写法：
description: "编码行为准则，减少 LLM 常见的过度工程和冲动修改。
当用户在编写、审查或重构代码时使用。触发场景：写新功能、修 bug、
重命名变量、调整函数签名。"
→ 清晰描述了做什么 + 什么时候用 + 具体触发词
6.3 创作技巧
| 要点 | 说明 |
|---|---|
| description 最重要 | Claude 靠它匹配你的需求，写得越准确触发越可靠 |
| 用自然语言描述 | 不要硬编码关键词，用流畅的句子说明适用场景 |
| 控制文件大小 | 核心指令控制在 5KB 以内，太大影响 token |
| 复杂逻辑放附件 | 参考文档放到同级子目录下 |
| 多用结构化格式 | 表格比段落清晰，代码块比文字更易读 |
七、常见问题
Q1: 我怎么知道当前有哪些 Skill 可用？
A: Claude Code 会在每次 session 开始时自动列出所有可用的 Skill（在你发送的消息下面）。也可以终端查看：
ls ~/.claude/skills/ --oneline
Q2: 某个 Skill 为什么没触发？
排查步骤：
1. Skill 是否已安装？
→ ls ~/.claude/skills/
2. description 写的够不够准确？
→ 你的需求描述是否与 description 匹配？
3. context 是否超限？
→ 大的 SKILL.md 会增加 token 消耗，可能需要精简
4. 是否需要 restart？
→ Claude Code 有时需要重启才能扫描到新 Skill
Q3: Skill 会一直占用 token 吗？
A: 是的，一旦匹配成功，整个 SKILL.md 内容会被注入上下文。所以建议：
- 核心指令 ≤ 5KB
- 详细参考文档放附件
- 不需要的 Skill 及时移除
Q4: 怎么卸载 Skill？
rm -rf ~/.claude/skills/my-old-skill
Q5: Skill 和 CLAUDE.md 有什么区别？
| 对比项 | Skill | CLAUDE.md |
|---|---|---|
| 作用范围 | 全局（所有项目） | 仅当前项目 |
| 触发方式 | 按意图自动匹配 | 始终加载 |
| 用途 | 行为模式和方法论 | 项目特定的规范和约定 |
| 大小 | 建议 ≤ 5KB | 不限 |
八、最佳实践
1. 根据项目阶段切换 Skill 组合
项目初期（从零搭建）：
brainstorming + planning-with-files-zh + writing-plans
项目中期（日常开发）：
karpathy-guidelines + subagent-driven-development + TDD
项目后期（收尾交付）：
verification-before-completion + requesting-code-review + finishing-a-development-branch
2. 善用 Hooks 但不滥用
✅ 适合用 Hook：
- 恢复上下文（UserPromptSubmit 时读取规划文件）
- 注入配置（PreToolUse 时读取配置文件）
- 记录进度（PostToolUse 时追加工作日志）
❌ 不适合：
- 复杂的业务逻辑判断
- 耗时长的操作
- 不可预测状态的检查
3. 定期清理
# 查看列表，长期不用的考虑移除
ls ~/.claude/skills/
4. 为团队创建共享 Skill
cat > ~/.claude/skills/team-coding-standard/SKILL.md << 'EOF'
---
name: team-coding-standard
description: 我们团队的编码规范。当写 Java/Go/TS 代码时触发。
---
# 团队编码规范
## 命名约定
- 类名 PascalCase，变量 camelCase
...
EOF
九、附录
A. 全文 Skill 关键词速查表
┌──────────────┬──────────────────────────────────────────────────┐
│ 类别 │ 核心触发关键词 │
├──────────────┼──────────────────────────────────────────────────┤
│ 编码规范 │ 写代码、修bug、重构、code review │
│ │ karpathy-guidelines / TDD / debugging │
├──────────────┼──────────────────────────────────────────────────┤
│ 方案设计 │ 设计方案、构思、新建功能、从零搭建 │
│ │ brainstorming / writing-plans │
├──────────────┼──────────────────────────────────────────────────┤
│ 验证/审查 │ 完成了、验证、检查、合并分支 │
│ │ verification / requesting-code-review │
├──────────────┼──────────────────────────────────────────────────┤
│ Word/PDF/ │ .docx/.pdf/.xlsx/.pptx / "Word" "PDF" │
│ Excel/PPTX │ "表格" "演示文稿" "合并PDF" │
├──────────────┼──────────────────────────────────────────────────┤
│ UI/UX设计 │ 设计、UI、UX、Dashboard、shadcn、暗色模式 │
│ │ ui-ux-pro-max / ckm-* / frontend-design │
├──────────────┼──────────────────────────────────────────────────┤
│ PUA加压 │ try harder / 加油 / 你又错了 / 不行啊 / /pua │
│ │ pua / pua-en / pua-ja / shot / p9 / p10 / p7 │
│ │ yes(夸夸) / mama(妈妈) / pro(进化) │
├──────────────┼──────────────────────────────────────────────────┤
│ 任务规划 │ 任务规划 / 项目计划 / 制定计划 / 进度跟踪 │
│ │ planning-with-files-zh / ralph-loop / pua-loop │
├──────────────┼──────────────────────────────────────────────────┤
│ 联网访问 │ 搜索 / 抓取 / 登录后 / 动态页面 / 社交媒体 │
│ │ web-access │
├──────────────┼──────────────────────────────────────────────────┤
│ 自动化 │ api2pdf / castingwords / excel 自动化 │
│ │ 需要 rube MCP │
├──────────────┼──────────────────────────────────────────────────┤
│ 记忆检索 │ 记忆搜索 / 代码搜索 / 知识图谱 │
│ │ claude-mem 系列 │
├──────────────┼──────────────────────────────────────────────────┤
│ 创作 Skill │ 创建skill / 优化skill / eval │
│ │ skill-creator │
├──────────────┼──────────────────────────────────────────────────┤
│ 写文章 │ 写一篇 / 帮我写 / 输出文章 / 撰写 │
│ │ article-writer (/article-writer) │
├──────────────┼──────────────────────────────────────────────────┤
│ 多后端 │ codeagent / Codex / Gemini │
│ │ codeagent │
└──────────────┴──────────────────────────────────────────────────┘
B. 术语表
| 术语 | 含义 |
|---|---|
| Skill | Claude Code 的行为指令集（纯文本文件） |
| SKILL.md | 技能的核心配置文件 |
| Hook | 在特定时机自动执行的回调 |
| user-invocable | 是否可通过 /skill-name 手动触发 |
| Matcher | Hook 的工具匹配规则（正则表达式） |
| allowed-tools | 该 Skill 允许调用的工具白名单 |
| Plugin | 自动提供一组 Skill 的包管理器单元 |
| Marketplace | Skill 的发现与安装中心 |
小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用
更多推荐
13
0- 0
已为社区贡献3条内容
所有评论(0)