Claude Code 隐藏玩法：Skills 插件机制详解 + 必装推荐

三木檾
15 阅读4分钟

一、Skills 是什么？

Claude Code 的 Skills 是可复用的指令包——本质上是一个文件夹，里面有一个 SKILL.md，告诉 Claude 如何处理某一类任务。

和内置的 /compact、/help 不同，Skills 是你（或社区）自己写的，可以随时添加、修改，并且跨项目复用。

加载效率设计

Skills 采用渐进式加载：

  • 会话启动时，每个 skill 只加载描述文本（上限 1536 字符）
  • 只有 Claude 判断当前任务需要用到某个 skill，才加载完整内容
  • scripts/、references/ 等辅助文件按需加载

所有 skill 的描述共享约 1% 的上下文窗口作为预算，超出后最少使用的 skill 会被静默丢弃。精装比滥装更重要。

二、安装方式

目录结构

# 全局安装（所有项目可用）
~/.claude/skills/<skill-name>/SKILL.md

# 项目级安装（仅当前项目可用）
.claude/skills/<skill-name>/SKILL.md

最小示例

mkdir -p ~/.claude/skills/my-skill

<!-- ~/.claude/skills/my-skill/SKILL.md -->
---
name: my-skill
description: 用一句话描述这个 skill 的用途，Claude 靠这句话决定要不要加载它
---

## 指令

在这里写你的 Prompt，支持：
- 普通 Markdown 文本
- !`git diff HEAD`  ← 反引号命令，发送前会先执行，结果内联进来
- $ARGUMENTS       ← 用户调用时传入的参数

调用方式

/my-skill          # 手动触发
/my-skill arg1     # 带参数触发

描述写得好的 skill，Claude 也会在合适时机自动触发，无需手动调用。

安装后即时生效

编辑 skill 文件后无需重启，Claude Code 实时监听文件变更。

三、聚合索引

不知道装什么时，先从这几个入口找。

hesreallyhim/awesome-claude-code

社区维护最活跃的综合列表，涵盖 skills、agents、hooks、MCP 配置等全品类。

awesome-skills.com

分类清晰，每个 skill 标注是否执行代码、是否发送外部请求、是否需要凭证，适合安装前做安全评估。

travisvn/awesome-claude-skills

专注 skills，适合想深入理解 skill 写法的开发者。

rohitg00/awesome-claude-code-toolkit

agents、commands、plugins、hooks、MCP 配置一网打尽，适合按需取用。

四、推荐插件

通用必装：superpowers

obra/superpowers

在 Claude Code 生态里热度最高，由 Jesse Vincent（Prime Radiant）打造，定位是一套完整的 AI 编程方法论：

  • 20+ 个实战验证的 skill，涵盖 TDD、调试、子 agent 协作、分支收尾等核心工作流
  • 内置 subagent-driven-development 模式：把任务拆给多个子 agent 并行处理，Claude 可以无干预工作数小时
  • 配套 superpowers-marketplace，提供社区插件扩展

安装方式参考仓库 README：github.com/obra/superp…

中文社区版：jnMetaCode/superpowers-zh

14 个核心 skill 完整汉化 + 6 个国内原创 skill，支持 Claude Code、Cursor、Windsurf 等多款工具。

superpowers 内置 Skills

superpowers 安装后自带以下 skills，覆盖了日常开发的核心工作流：

Skill用途
test-driven-development强制 RED-GREEN-REFACTOR 循环，不写测试不允许写实现代码
finishing-a-development-branch分支收尾：验证测试、生成 PR 或合并、清理 worktree
subagent-driven-development把任务拆给多个子 agent 并行执行，带两阶段 review
executing-plans按批次推进任务，每批完成后设置人工检查点
systematic-debugging系统化调试流程
using-git-worktrees自动创建隔离 worktree，不污染主分支
brainstorming头脑风暴与方案设计
dispatching-parallel-agents编排多个并行 agent
requesting-code-review发起 code review
receiving-code-review处理 code review 反馈

其他社区 skill 可在聚合索引中按需查找。

五、自己写 Skill 的时机

如果你在多个对话里反复粘贴同一段 Prompt，就该把它变成 Skill。

常见场景：

  • 项目特有的 Code Review 检查清单
  • 团队约定的提交信息格式
  • 固定的数据库查询 / API 调试流程
  • 周报 / 日报模板生成

六、安全提醒

Skills 可以执行任意 shell 命令，安装时务必：

  1. 只从有 star、有历史记录、有 README 的公开仓库安装
  2. 安装前读一遍 SKILL.md，看有没有可疑的外部请求或数据上传
  3. 项目 skill 放 .claude/skills/，个人全局 skill 放 ~/.claude/skills/，做好隔离

七、快速上手清单

# 1. 创建第一个 skill
mkdir -p ~/.claude/skills/my-review
# 编辑 SKILL.md，写入你最常用的 Review Prompt

# 2. 从社区安装
# 找到对应 GitHub 仓库，复制 skill 目录到 ~/.claude/skills/

# 3. 验证安装
# 在 Claude Code 里输入 /my-review，或直接描述任务看 Claude 是否自动触发

八、延伸阅读

avatar
文章
阅读
粉丝