很多朋友最近大概率被同一件事刷了屏GitHub 上各种skills仓库突然火了起来一堆人开始往 Claude Code 里装“技能包”。作为一个从 Claude Code 早期版本就开始折腾的老用户我忍不住想聊清楚一件事——Claude Code 的技能到底怎么装、怎么用、怎么玩出花来而不是照着 README 敲两行命令就完事。先说结论Claude Code 的“技能Skills”本质上就是一组有固定结构的提示词工程文件它把某类任务的执行方法、检查清单、注意事项打包成一个目录让 Claude 在做同类事情时不用每次都临时摸索而是直接调用这套成熟流程。你可以把它理解成给 Claude 配了一本“工作手册”遇到对应场景就翻开照着做。这篇内容就围绕“如何安装技能”展开从环境准备、安装方式、自定义开发一直讲到常见问题排查希望能帮你少踩几个我踩过的坑。1. Claude Code 和“技能”到底解决什么问题1.1 先搞懂 Claude Code 是什么Claude Code 是 Anthropic 推出的终端命令行编程助手它跑在本地终端里可以读取你的代码仓库、执行命令、修改文件、运行测试然后把你需要用自然语言描述的开发任务变成一系列实际动作。换句话说你平时在 IDE 里靠插件和手动操作完成的活儿在终端里用对话就能驱动。但这东西和普通的“聊天式代码助手”有个非常明显的区别它不是一个只能“给建议”的问答机器人而是真的能动手。它能读取项目结构、搜索文件、执行 Shell 命令、在编辑器里改代码整个过程你来审核、它来执行。正因为这种“能动手”的特性它才非常适合挂载技能包——因为技能包的本质就是告诉它“在某种场景下按照什么步骤、什么标准、什么顺序去做事”。拿我自己的实际体验举例我常用 Claude Code 处理仓库里的重复性重构任务比如把某个模块的错误处理从 return null 改成抛出统一异常。在没有技能包之前每次我都得把格式要求、边界情况、注意事项重新描述一遍偶尔还会漏掉某些细节。后来我把这套重构流程写成了一个技能现在只需要说一句“按重构技能处理 payment 模块”它就会自动按我设定的步骤推进效率差别非常明显。1.2 “技能”在 Claude Code 里到底指什么关于“技能”这个概念社区里最容易出现理解偏差。我见过不少人把 Claude Code 的技能和 Cursor 里的 Rules、或者是传统 IDE 里的代码模板混为一谈其实它们虽然有相似之处但底层逻辑完全不同。在 Claude Code 的语境下一个“技能”通常是一个独立的目录里面包含SKILL.md这是核心文件用 Markdown 编写描述这个技能是干什么的、在什么时候启用、有哪些执行步骤和约束规则。一些辅助文件可能是参考数据、示例代码、模板文件、检查清单等等帮助 Claude 在执行技能时能有更充分的上下文。关键点在于技能不是一段写死的代码而是一套“可被模型理解和执行的指令集”。它利用了 Claude 这类大模型对自然语言的理解能力把流程化的任务通过描述性文本固化下来。这样做的收益很直接不需要每次重新描述需求省时间。执行标准统一避免每次结果参差不齐。容易分享一个技能目录拷给别人就能用。如果你写过 OpenAI 的 Function Calling 或者搞过 Agent 的 Prompt 工程你会发现 Claude Code 的 Skill 思路在其中有很多相似的影子只是更产品化、更开箱即用。对我来说理解这层逻辑是安装和开发技能的前提。否则你很容易把技能当成“插件”以为装上就有魔法等到它不生效的时候又不知道从哪里排查。2. 安装前的准备工作与基础安装2.1 环境要求与前置准备在安装 Claude Code 和技能之前先确认你的环境是否满足基本条件。我踩过的最大坑就是环境不匹配导致后面的步骤连环报错所以这里专门列一个检查清单Node.js 版本Claude Code 官方提供 npm 安装方式Node.js 建议 18 或更高版本。如果你还在用 14、16 这种老版本建议先升级否则安装过程中容易报引擎不兼容的错误。操作系统官方支持 macOS、Linux、WindowsWindows 建议使用 WSL 或 Git Bash 环境原生 cmd/PowerShell 下体验会差一些。我自己在 Windows 上折腾过一段时间最终还是切到了 WSL 里跑原因后面说。网络环境需要能正常访问 npm 和 Anthropic 的 API 服务这是基础前提。API 凭据你要准备好 Anthropic API Key或者有 Claude Pro/Max 订阅账号并完成登录授权。首次启动时它会引导你完成登录。这里多说一句 Windows 原生环境的问题Claude Code 在 Windows 下能跑但一些技能脚本如果依赖 bash 命令在 cmd 和 PowerShell 里经常出幺蛾子。我遇到过某次装了一个依赖 Shell 管道的技能在 PowerShell 下调了半天没反应切到 WSL 后秒好。所以如果你打算长期使用我非常推荐在 WSL 环境里跑。2.2 安装 Claude Code 的几种方式Claude Code 的安装方式比较常规最主流的是通过 npm 安装npm install -g anthropic-ai/claude-code装完后在终端输入claude就能启动交互式界面。首次启动会引导你完成登录和授权流程基本是全自动的。不想用 npm 的话还可以用官方安装脚本curl -fsSL https://claude.ai/install.sh | bash这个方式适合想图省事的情况本质还是帮你把 npm 包装上只是省掉了手动敲命令这一步。如果你更希望以桌面客户端的方式使用Anthropic 也推出了 Claude Code 的桌面版从官网下载对应操作系统的安装包安装即可。桌面版的本质是给终端版套了一层图形界面外壳核心能力和终端版一致但日常操作更直观适合不习惯命令行的人。卸载方式同样很简单npm uninstall -g anthropic-ai/claude-code这个命令会把 Claude Code 从全局依赖里移除配置文件和本地数据比如对话历史、技能目录不会自动删除如果你也想清理干净需要手动删除对应的配置目录。2.3 基础配置与模型连接安装完成后第一件事是确认它能正常连接模型。运行claude后它会检查你的登录状态。如果你提前设置过环境变量它也会自动读取。常见的配置项目有这么几个ANTHROPIC_API_KEY直接设置 API Key 环境变量适合脚本化调用。ANTHROPIC_MODEL指定默认使用的模型版本默认是 Claude 系列最新的 Sonnet 或 Opus具体取决于你的账号权限。CLAUDE_CONFIG_DIR配置文件存放目录技能目录的根路径也在这里默认是~/.claude。配置完成后建议先跑一个最简单的对话测试一下比如让它“读一下当前目录结构”确认它能正常工作再往下进行。注意技能安装之前建议先确认 Claude Code 基础功能完整可用。因为很多技能安装过程中的报错其实是基础配置没到位而不是技能本身的问题。3. 安装技能Skills的完整实操3.1 技能的存放位置与管理方式一旦 Claude Code 正常工作下一步就是安装技能。这里先科普一个核心概念技能目录skills directory。Claude Code 会从特定位置扫描技能目录每个技能以子文件夹的形式存在。默认的技能根目录在~/.claude/skills对应官方文档中的 plugin 配置不过自定义技能也支持放在项目本地比如.claude/skills。我自己常用的管理思路是“全局技能 项目技能”双层结构全局技能~/.claude/skills/放一些跨项目通用的能力比如“代码审查”“提交信息规范”“重构流程”任何项目都能用。项目技能.claude/skills/放当前项目专属的流程比如“数据库迁移流程”“本项目的部署规范”跟着仓库走。这两层技能是并存关系Claude 在执行任务时会同时考虑它们不会互相覆盖。具体的优先级规则我后面讲。3.2 从 GitHub 技能库安装技能现在社区已经有大量现成的技能库GitHub 上搜claude skills就能找到一堆。安装方式没有统一的包管理器最通用的做法就是 git clone 或直接下载 ZIP然后把对应目录放到技能目录里。我以安装一个 GitHub 上的技能为例子完整操作如下# 1. 进入技能根目录 cd ~/.claude/skills # 2. 克隆技能仓库 git clone https://github.com/example/some-claude-skill.git克隆完成后检查一下目录结构确保它符合 Claude Code 能识别的格式。一个标准的技能目录应该是这样的some-claude-skill/ ├── SKILL.md ├── reference/ │ └── details.md └── scripts/ └── helper.py最关键的就是SKILL.md必须存在且命名准确。如果你发现仓库里没有这个文件说明它可能不是标准的 Claude Code 技能或者是老旧格式装进去很可能不生效。装好之后重启 Claude Code然后用自然语言测试这个技能是否被识别。你可以直接问“你现在有哪些技能”或者用与技能相关的关键词触发它。如果技能正常加载Claude 会按SKILL.md里的规则响应。这里分享一个经验很多“技能安装”所谓的失败其实是目录结构不对。比如有人把技能根目录直接放到了~/.claude/skills里导致 Claude 把整个仓库当成了一个技能无法识别内部文件。正确做法是每一个技能占一层子目录结构是skills/skill-name/SKILL.md不是skills/SKILL.md。3.3 手写一个自定义技能社区技能库虽然多但真正贴合自己工作的大概率还得自己写。好在自定义技能的难度很低本质上就是写 Markdown。一个最小可用的技能目录只需要一个SKILL.md文件。比如我写一个“代码提交信息规范化”技能--- name: commit-message description: 根据代码变更内容生成符合 Conventional Commits 规范的提交信息。 --- # Commit Message 规范化 当用户要求生成提交信息或需要提交代码时使用本技能。 ## 执行步骤 1. 读取 git diff分析变更内容。 2. 根据变更类型确定 typefeat/fix/docs/style/refactor/perf/test/build/ci/chore。 3. 使用祈使句不超过 50 个字符。 4. 如果有 breaking change在正文中注明。 5. 输出完整的 git commit 命令供用户确认。 ## 注意事项 - 不要修改用户的代码。 - 如果变更同时包含多个类型按主要变更选择 type。 - 拿不准类型时优先使用 refactor。把以上内容保存为~/.claude/skills/commit-message/SKILL.md重启后这个技能就生效了。SKILL.md里最核心的是 YAML Front Matter 里的name和description尤其是description。Claude Code 判断什么时候启用哪个技能很大程度上靠这个描述字段和用户意图做匹配。所以描述要写得明确、关键词丰富忌讳太笼统。比如“处理代码”这种描述就没什么用而“根据 git 变更生成 Conventional Commits 规范的提交信息”就很清晰。其实如果你不想自己从零开始写完全可以找一个现成的技能照着它的格式改一改把内容替换成自己的流程——这是我最推荐的上手路径。4. 实战中使用技能的正确姿势4.1 技能调用与上下文管理安装完技能后最大的疑问通常变成技能到底怎么“被调用”是像函数一样输入名字吗还是要写特殊命令从我的实测来看Claude Code 的技能触发机制比大部分人想象的更“自然语言化”。你不需要skill-name这种显式的调用语法当然某些版本支持类似的显式触发但并不是必须直接说你的需求Claude 会根据当前对话和技能描述自动匹配。举例来说假设我安装了“数据库迁移”技能我可以直接说“帮我把 orders 表加一个 status 字段”Claude 如果判断这个需求命中“数据库迁移”的描述就会自动应用这个技能的执行步骤而不会先去改代码。不过这里有个容易被忽视的点技能触发取决于上下文匹配而不是你说了就一定会触发。如果你发现技能没生效最常见的原因是描述写得太泛或者当前需求关联度不够高。这种情况下你可以主动在对话里点名技能比如说“使用数据库迁移技能处理 orders 表变更”引导作用非常明显。4.2 组合技能完成真实任务单个技能解决单一场景但真实开发往往是多个场景叠加。Claude Code 支持多个技能协同工作这比一个个独立调用有意思得多。举一个我刚才实际跑通的场景。我开发一个小工具库时提交了一个新功能分支想把变更推到远端并发起合并请求。过程中我同时使用了三个技能“代码审查”技能先扫描本次变更的 diff找出潜在问题并自动修复。“测试生成”技能为新增函数补充单测。“提交信息规范”技能生成符合格式的 commit message。整个流程我没有重新描述任何步骤规则只是依次说“审查一下当前改动”“为新函数补个测试”“生成提交信息”Claude 自动匹配到了对应技能并按照各自的流程执行。这个体验的关键点是技能之间没有强耦合它们是“按需激活”的。只要你把每个技能的边界描述清楚Claude 在复杂的多环节任务中也能自动判断何时套用哪个流程。4.3 记忆技能与长期使用在 Claude Code 的生态里除了普通的任务型技能还有一类被叫做“记忆技能”的东西引起了不少关注。所谓记忆技能就是让 Claude 跨会话记住你的偏好、项目背景、常用决策而不是每次对话都从零开始。我自己的用法是维护一个“项目背景记忆”技能里面记录了当前项目的一些固定信息项目的技术栈和关键依赖。命名规范比如常量用 UPPER_CASE组件用 PascalCase。已知技术债和注意事项。发布流程和回滚策略。这些内容放在SKILL.md里描述写成“需要了解项目背景或做出技术决策时使用”。之后每次新开会话只要涉及项目细节Claude 就会自动读取这份背景信息不用我再反复重复。这种做法比硬塞一个超大的 CLAUDE.md 更灵活因为这个背景只在相关场景下才会被加载日常简单对话不会被无关历史影响。如果你刚开始用我建议先建一个自己的项目背景记忆技能把平时最容易重复交代的东西写进去很快就能体会到差异。5. 常见问题与排查技巧5.1 技能不生效怎么办技能没反应在我收到的反馈里是最常见的问题没有之一。按照我自己排查的经验优先级从高到低应该是下面这样问题特征可能原因解决思路技能完全没被识别目录结构不对SKILL.md位置错误检查是否为技能名/SKILL.md的层级聊天中从来不主动触发description写得太泛匹配不到改写描述加入触发场景关键词装完技能后没变化没重启 Claude Code重启会话或进程多个技能同时命中描述内容重叠给每个技能增加更明确的边界描述对于第一条我再强调一下检查路径是最快的方式。很多技能仓库会把源码放在src/或者有子目录嵌套如果你只把整个仓库直接拷到skills下SKILL.md并没有出现在技能根目录下Claude 就没法识别。查看 Claude Code 是否识别到技能可以在对话中直接问它“你现在能用哪些技能”如果列出来的结果里没有你刚装的技能大概率就是上面表中的前两行问题。5.2 安装过程中常见坑装技能本身不复杂但网络上分享的技能质量参差不齐我给大家几个判断标准。看更新时间一年以上没更新的技能仓库大概率是旧版格式兼容性存疑。看 SKILL.md 的 Front Matter没有name和description字段的多半不是正规技能。看依赖脚本如果技能引用了外部脚本或者 Python 包要注意有没有写明安装依赖。我之前装过一个技能里面调用了requests库我环境里偏偏没装结果技能每次跑到一半就崩了。装完技能后我也建议大家养成一个习惯先小成本验证再大规模使用。比如装完一个代码审查技能先拿一个小文件试运行而不是直接丢一个几百行的大仓库进去跑。等确认输出符合预期再放心用。5.3 卸载技能与清理痕迹技能卸载比较容易直接删除对应目录即可rm -rf ~/.claude/skills/commit-message删除后重启 Claude Code技能就消失了。没有什么注册表之类的残留问题。如果你有这个强迫症想确认技能真的被移除了用前面说的方法在对话中问一句“你现在有哪些技能”就行。还有个小细节如果你用桌面版客户端删除技能后需要退出重进一下桌面版不会像终端版那样每次启动都重新扫描。6. 从使用到维护技能生态的下一步装技能只是入门真正让技能发挥价值的是持续维护。我自己的习惯是每过一段时间就审视一下现有技能哪个技能最近完全没被触发过如果是描述有问题改描述如果确实是流程过时了删掉。哪个任务连续手动操作了好几次说明这个场景值得固化成新技能。发现某个技能和其他技能开始重复合并它们明确边界。这种“从使用到维护”的节奏能让技能库始终贴合真实工作流。别忘了技能的核心价值不是“装得越多越好”而是“在正确场景下稳定复用”。一个精准描述、边界清晰的技能胜过十个泛泛而谈的模板。最后如果你刚开始折腾不要追求一上来就装几十个技能。先挑一个你日常最高频、最重复、最不想要动脑的任务把它写成技能用起来再慢慢扩展。慢慢试下来你会发现真正不能被替代的不是技能本身而是你对这些任务的理解和沉淀被完整地保存了下来。 Claude Code技能安装与使用全攻略：从环境准备到自定义开发
很多朋友最近大概率被同一件事刷了屏GitHub 上各种skills仓库突然火了起来一堆人开始往 Claude Code 里装“技能包”。作为一个从 Claude Code 早期版本就开始折腾的老用户我忍不住想聊清楚一件事——Claude Code 的技能到底怎么装、怎么用、怎么玩出花来而不是照着 README 敲两行命令就完事。先说结论Claude Code 的“技能Skills”本质上就是一组有固定结构的提示词工程文件它把某类任务的执行方法、检查清单、注意事项打包成一个目录让 Claude 在做同类事情时不用每次都临时摸索而是直接调用这套成熟流程。你可以把它理解成给 Claude 配了一本“工作手册”遇到对应场景就翻开照着做。这篇内容就围绕“如何安装技能”展开从环境准备、安装方式、自定义开发一直讲到常见问题排查希望能帮你少踩几个我踩过的坑。1. Claude Code 和“技能”到底解决什么问题1.1 先搞懂 Claude Code 是什么Claude Code 是 Anthropic 推出的终端命令行编程助手它跑在本地终端里可以读取你的代码仓库、执行命令、修改文件、运行测试然后把你需要用自然语言描述的开发任务变成一系列实际动作。换句话说你平时在 IDE 里靠插件和手动操作完成的活儿在终端里用对话就能驱动。但这东西和普通的“聊天式代码助手”有个非常明显的区别它不是一个只能“给建议”的问答机器人而是真的能动手。它能读取项目结构、搜索文件、执行 Shell 命令、在编辑器里改代码整个过程你来审核、它来执行。正因为这种“能动手”的特性它才非常适合挂载技能包——因为技能包的本质就是告诉它“在某种场景下按照什么步骤、什么标准、什么顺序去做事”。拿我自己的实际体验举例我常用 Claude Code 处理仓库里的重复性重构任务比如把某个模块的错误处理从 return null 改成抛出统一异常。在没有技能包之前每次我都得把格式要求、边界情况、注意事项重新描述一遍偶尔还会漏掉某些细节。后来我把这套重构流程写成了一个技能现在只需要说一句“按重构技能处理 payment 模块”它就会自动按我设定的步骤推进效率差别非常明显。1.2 “技能”在 Claude Code 里到底指什么关于“技能”这个概念社区里最容易出现理解偏差。我见过不少人把 Claude Code 的技能和 Cursor 里的 Rules、或者是传统 IDE 里的代码模板混为一谈其实它们虽然有相似之处但底层逻辑完全不同。在 Claude Code 的语境下一个“技能”通常是一个独立的目录里面包含SKILL.md这是核心文件用 Markdown 编写描述这个技能是干什么的、在什么时候启用、有哪些执行步骤和约束规则。一些辅助文件可能是参考数据、示例代码、模板文件、检查清单等等帮助 Claude 在执行技能时能有更充分的上下文。关键点在于技能不是一段写死的代码而是一套“可被模型理解和执行的指令集”。它利用了 Claude 这类大模型对自然语言的理解能力把流程化的任务通过描述性文本固化下来。这样做的收益很直接不需要每次重新描述需求省时间。执行标准统一避免每次结果参差不齐。容易分享一个技能目录拷给别人就能用。如果你写过 OpenAI 的 Function Calling 或者搞过 Agent 的 Prompt 工程你会发现 Claude Code 的 Skill 思路在其中有很多相似的影子只是更产品化、更开箱即用。对我来说理解这层逻辑是安装和开发技能的前提。否则你很容易把技能当成“插件”以为装上就有魔法等到它不生效的时候又不知道从哪里排查。2. 安装前的准备工作与基础安装2.1 环境要求与前置准备在安装 Claude Code 和技能之前先确认你的环境是否满足基本条件。我踩过的最大坑就是环境不匹配导致后面的步骤连环报错所以这里专门列一个检查清单Node.js 版本Claude Code 官方提供 npm 安装方式Node.js 建议 18 或更高版本。如果你还在用 14、16 这种老版本建议先升级否则安装过程中容易报引擎不兼容的错误。操作系统官方支持 macOS、Linux、WindowsWindows 建议使用 WSL 或 Git Bash 环境原生 cmd/PowerShell 下体验会差一些。我自己在 Windows 上折腾过一段时间最终还是切到了 WSL 里跑原因后面说。网络环境需要能正常访问 npm 和 Anthropic 的 API 服务这是基础前提。API 凭据你要准备好 Anthropic API Key或者有 Claude Pro/Max 订阅账号并完成登录授权。首次启动时它会引导你完成登录。这里多说一句 Windows 原生环境的问题Claude Code 在 Windows 下能跑但一些技能脚本如果依赖 bash 命令在 cmd 和 PowerShell 里经常出幺蛾子。我遇到过某次装了一个依赖 Shell 管道的技能在 PowerShell 下调了半天没反应切到 WSL 后秒好。所以如果你打算长期使用我非常推荐在 WSL 环境里跑。2.2 安装 Claude Code 的几种方式Claude Code 的安装方式比较常规最主流的是通过 npm 安装npm install -g anthropic-ai/claude-code装完后在终端输入claude就能启动交互式界面。首次启动会引导你完成登录和授权流程基本是全自动的。不想用 npm 的话还可以用官方安装脚本curl -fsSL https://claude.ai/install.sh | bash这个方式适合想图省事的情况本质还是帮你把 npm 包装上只是省掉了手动敲命令这一步。如果你更希望以桌面客户端的方式使用Anthropic 也推出了 Claude Code 的桌面版从官网下载对应操作系统的安装包安装即可。桌面版的本质是给终端版套了一层图形界面外壳核心能力和终端版一致但日常操作更直观适合不习惯命令行的人。卸载方式同样很简单npm uninstall -g anthropic-ai/claude-code这个命令会把 Claude Code 从全局依赖里移除配置文件和本地数据比如对话历史、技能目录不会自动删除如果你也想清理干净需要手动删除对应的配置目录。2.3 基础配置与模型连接安装完成后第一件事是确认它能正常连接模型。运行claude后它会检查你的登录状态。如果你提前设置过环境变量它也会自动读取。常见的配置项目有这么几个ANTHROPIC_API_KEY直接设置 API Key 环境变量适合脚本化调用。ANTHROPIC_MODEL指定默认使用的模型版本默认是 Claude 系列最新的 Sonnet 或 Opus具体取决于你的账号权限。CLAUDE_CONFIG_DIR配置文件存放目录技能目录的根路径也在这里默认是~/.claude。配置完成后建议先跑一个最简单的对话测试一下比如让它“读一下当前目录结构”确认它能正常工作再往下进行。注意技能安装之前建议先确认 Claude Code 基础功能完整可用。因为很多技能安装过程中的报错其实是基础配置没到位而不是技能本身的问题。3. 安装技能Skills的完整实操3.1 技能的存放位置与管理方式一旦 Claude Code 正常工作下一步就是安装技能。这里先科普一个核心概念技能目录skills directory。Claude Code 会从特定位置扫描技能目录每个技能以子文件夹的形式存在。默认的技能根目录在~/.claude/skills对应官方文档中的 plugin 配置不过自定义技能也支持放在项目本地比如.claude/skills。我自己常用的管理思路是“全局技能 项目技能”双层结构全局技能~/.claude/skills/放一些跨项目通用的能力比如“代码审查”“提交信息规范”“重构流程”任何项目都能用。项目技能.claude/skills/放当前项目专属的流程比如“数据库迁移流程”“本项目的部署规范”跟着仓库走。这两层技能是并存关系Claude 在执行任务时会同时考虑它们不会互相覆盖。具体的优先级规则我后面讲。3.2 从 GitHub 技能库安装技能现在社区已经有大量现成的技能库GitHub 上搜claude skills就能找到一堆。安装方式没有统一的包管理器最通用的做法就是 git clone 或直接下载 ZIP然后把对应目录放到技能目录里。我以安装一个 GitHub 上的技能为例子完整操作如下# 1. 进入技能根目录 cd ~/.claude/skills # 2. 克隆技能仓库 git clone https://github.com/example/some-claude-skill.git克隆完成后检查一下目录结构确保它符合 Claude Code 能识别的格式。一个标准的技能目录应该是这样的some-claude-skill/ ├── SKILL.md ├── reference/ │ └── details.md └── scripts/ └── helper.py最关键的就是SKILL.md必须存在且命名准确。如果你发现仓库里没有这个文件说明它可能不是标准的 Claude Code 技能或者是老旧格式装进去很可能不生效。装好之后重启 Claude Code然后用自然语言测试这个技能是否被识别。你可以直接问“你现在有哪些技能”或者用与技能相关的关键词触发它。如果技能正常加载Claude 会按SKILL.md里的规则响应。这里分享一个经验很多“技能安装”所谓的失败其实是目录结构不对。比如有人把技能根目录直接放到了~/.claude/skills里导致 Claude 把整个仓库当成了一个技能无法识别内部文件。正确做法是每一个技能占一层子目录结构是skills/skill-name/SKILL.md不是skills/SKILL.md。3.3 手写一个自定义技能社区技能库虽然多但真正贴合自己工作的大概率还得自己写。好在自定义技能的难度很低本质上就是写 Markdown。一个最小可用的技能目录只需要一个SKILL.md文件。比如我写一个“代码提交信息规范化”技能--- name: commit-message description: 根据代码变更内容生成符合 Conventional Commits 规范的提交信息。 --- # Commit Message 规范化 当用户要求生成提交信息或需要提交代码时使用本技能。 ## 执行步骤 1. 读取 git diff分析变更内容。 2. 根据变更类型确定 typefeat/fix/docs/style/refactor/perf/test/build/ci/chore。 3. 使用祈使句不超过 50 个字符。 4. 如果有 breaking change在正文中注明。 5. 输出完整的 git commit 命令供用户确认。 ## 注意事项 - 不要修改用户的代码。 - 如果变更同时包含多个类型按主要变更选择 type。 - 拿不准类型时优先使用 refactor。把以上内容保存为~/.claude/skills/commit-message/SKILL.md重启后这个技能就生效了。SKILL.md里最核心的是 YAML Front Matter 里的name和description尤其是description。Claude Code 判断什么时候启用哪个技能很大程度上靠这个描述字段和用户意图做匹配。所以描述要写得明确、关键词丰富忌讳太笼统。比如“处理代码”这种描述就没什么用而“根据 git 变更生成 Conventional Commits 规范的提交信息”就很清晰。其实如果你不想自己从零开始写完全可以找一个现成的技能照着它的格式改一改把内容替换成自己的流程——这是我最推荐的上手路径。4. 实战中使用技能的正确姿势4.1 技能调用与上下文管理安装完技能后最大的疑问通常变成技能到底怎么“被调用”是像函数一样输入名字吗还是要写特殊命令从我的实测来看Claude Code 的技能触发机制比大部分人想象的更“自然语言化”。你不需要skill-name这种显式的调用语法当然某些版本支持类似的显式触发但并不是必须直接说你的需求Claude 会根据当前对话和技能描述自动匹配。举例来说假设我安装了“数据库迁移”技能我可以直接说“帮我把 orders 表加一个 status 字段”Claude 如果判断这个需求命中“数据库迁移”的描述就会自动应用这个技能的执行步骤而不会先去改代码。不过这里有个容易被忽视的点技能触发取决于上下文匹配而不是你说了就一定会触发。如果你发现技能没生效最常见的原因是描述写得太泛或者当前需求关联度不够高。这种情况下你可以主动在对话里点名技能比如说“使用数据库迁移技能处理 orders 表变更”引导作用非常明显。4.2 组合技能完成真实任务单个技能解决单一场景但真实开发往往是多个场景叠加。Claude Code 支持多个技能协同工作这比一个个独立调用有意思得多。举一个我刚才实际跑通的场景。我开发一个小工具库时提交了一个新功能分支想把变更推到远端并发起合并请求。过程中我同时使用了三个技能“代码审查”技能先扫描本次变更的 diff找出潜在问题并自动修复。“测试生成”技能为新增函数补充单测。“提交信息规范”技能生成符合格式的 commit message。整个流程我没有重新描述任何步骤规则只是依次说“审查一下当前改动”“为新函数补个测试”“生成提交信息”Claude 自动匹配到了对应技能并按照各自的流程执行。这个体验的关键点是技能之间没有强耦合它们是“按需激活”的。只要你把每个技能的边界描述清楚Claude 在复杂的多环节任务中也能自动判断何时套用哪个流程。4.3 记忆技能与长期使用在 Claude Code 的生态里除了普通的任务型技能还有一类被叫做“记忆技能”的东西引起了不少关注。所谓记忆技能就是让 Claude 跨会话记住你的偏好、项目背景、常用决策而不是每次对话都从零开始。我自己的用法是维护一个“项目背景记忆”技能里面记录了当前项目的一些固定信息项目的技术栈和关键依赖。命名规范比如常量用 UPPER_CASE组件用 PascalCase。已知技术债和注意事项。发布流程和回滚策略。这些内容放在SKILL.md里描述写成“需要了解项目背景或做出技术决策时使用”。之后每次新开会话只要涉及项目细节Claude 就会自动读取这份背景信息不用我再反复重复。这种做法比硬塞一个超大的 CLAUDE.md 更灵活因为这个背景只在相关场景下才会被加载日常简单对话不会被无关历史影响。如果你刚开始用我建议先建一个自己的项目背景记忆技能把平时最容易重复交代的东西写进去很快就能体会到差异。5. 常见问题与排查技巧5.1 技能不生效怎么办技能没反应在我收到的反馈里是最常见的问题没有之一。按照我自己排查的经验优先级从高到低应该是下面这样问题特征可能原因解决思路技能完全没被识别目录结构不对SKILL.md位置错误检查是否为技能名/SKILL.md的层级聊天中从来不主动触发description写得太泛匹配不到改写描述加入触发场景关键词装完技能后没变化没重启 Claude Code重启会话或进程多个技能同时命中描述内容重叠给每个技能增加更明确的边界描述对于第一条我再强调一下检查路径是最快的方式。很多技能仓库会把源码放在src/或者有子目录嵌套如果你只把整个仓库直接拷到skills下SKILL.md并没有出现在技能根目录下Claude 就没法识别。查看 Claude Code 是否识别到技能可以在对话中直接问它“你现在能用哪些技能”如果列出来的结果里没有你刚装的技能大概率就是上面表中的前两行问题。5.2 安装过程中常见坑装技能本身不复杂但网络上分享的技能质量参差不齐我给大家几个判断标准。看更新时间一年以上没更新的技能仓库大概率是旧版格式兼容性存疑。看 SKILL.md 的 Front Matter没有name和description字段的多半不是正规技能。看依赖脚本如果技能引用了外部脚本或者 Python 包要注意有没有写明安装依赖。我之前装过一个技能里面调用了requests库我环境里偏偏没装结果技能每次跑到一半就崩了。装完技能后我也建议大家养成一个习惯先小成本验证再大规模使用。比如装完一个代码审查技能先拿一个小文件试运行而不是直接丢一个几百行的大仓库进去跑。等确认输出符合预期再放心用。5.3 卸载技能与清理痕迹技能卸载比较容易直接删除对应目录即可rm -rf ~/.claude/skills/commit-message删除后重启 Claude Code技能就消失了。没有什么注册表之类的残留问题。如果你有这个强迫症想确认技能真的被移除了用前面说的方法在对话中问一句“你现在有哪些技能”就行。还有个小细节如果你用桌面版客户端删除技能后需要退出重进一下桌面版不会像终端版那样每次启动都重新扫描。6. 从使用到维护技能生态的下一步装技能只是入门真正让技能发挥价值的是持续维护。我自己的习惯是每过一段时间就审视一下现有技能哪个技能最近完全没被触发过如果是描述有问题改描述如果确实是流程过时了删掉。哪个任务连续手动操作了好几次说明这个场景值得固化成新技能。发现某个技能和其他技能开始重复合并它们明确边界。这种“从使用到维护”的节奏能让技能库始终贴合真实工作流。别忘了技能的核心价值不是“装得越多越好”而是“在正确场景下稳定复用”。一个精准描述、边界清晰的技能胜过十个泛泛而谈的模板。最后如果你刚开始折腾不要追求一上来就装几十个技能。先挑一个你日常最高频、最重复、最不想要动脑的任务把它写成技能用起来再慢慢扩展。慢慢试下来你会发现真正不能被替代的不是技能本身而是你对这些任务的理解和沉淀被完整地保存了下来。