跳至内容

软件技术分享

关于电子游戏的方方面面

  • 游戏产业
    • 行业杂谈
    • 开发者采访
  • 游戏设计
    • 专题学习
    • 设计制作
  • 游戏热点
    • 游戏评测
    • 攻略与资料
    • 流行游戏
  • 工具指南
  • AI
    • AI新闻
    • 使用心得
  • 沙雕应用
  • 游戏7×24小时
  • 关于妙游社

Claude Code Skill 装了不生效,先查三件事

作者 2026年11月18日 09:17

我随手把技能目录命名成 my-skill-v1,里面 SKILL.md 的 name 字段写的却是 code-review,装完怎么都不对,折腾了小半天才定位到是命名不一致。

这篇整理的是作者从 beta 期就一路装过、跑过、在真实项目里用过的 17 个 Claude Code Skill。下面挑装和用最容易踩的地方讲。(原文有删节)

Skill 到底固化了什么

普通 Prompt 是一次性的。你问「这段代码有什么问题」,它看完答完对话就结束,下次同样的事还得重新说一遍,表述稍微变一点,输出还会飘。

Skill 把一组执行流程固化成一个文件包,里面有任务拆解步骤、工具调用规则、输出模板和质检项。Claude Code 先读 SKILL.md 的 description 字段,判断当前任务匹配哪个技能,再按里面的流程一步步走。

作者挂了代码评审 Skill 之后,评审报告从随想变成了固定格式的问题清单加修改建议,稳定性和可复用性完全是另一个级别。

Skill 和 MCP 分工在哪

把插件生态比作厨房,MCP 解决的是能不能碰到外部工具,比如查数据库、操作浏览器、调第三方 API;Skill 解决的是拿到工具之后怎么干活。

两者是配合关系。Skill 配置里有一个 allowed-tools 字段,声明这个技能运行期间允许调用哪些工具,其中就包括 MCP Server 暴露出来的能力。一个「运营周报」Skill,可以先通过 MCP 拉数据库里的业务数据,再按固定模板生成周报。

三条安装路径,按环境挑

终端最通用。机器上有 Node.js 18 以上,执行 npm install -g @anthropic-ai/claude-code,装完敲 claude –version,看到版本号就成了。Windows 下 CMD 和 Git Bash 都能跑,终端编码偶尔乱码,把代码页切到 UTF-8 就行。

主力在 VSCode 的就再装官方扩展。在 settings.json 里指定 claude-code.path 指向全局的 claude,插件模式会跟着当前工作区走,打开哪个项目就加载哪个项目的 .claude/skills,在多项目之间切换省事。

不熟命令行的可以用桌面版,走官方渠道下载安装包。作者实测遇到下载失败,多是网络波动或本地安全软件拦截。市面上打着「加速下载」「一键破解」旗号的包别碰,这类东西风险极高。

装完没生效,先查这三件事

这一条作者踩得最久。

第一看目录位置。全局技能放 ~/.claude/skills/,项目级的放项目根目录下的 .claude/skills/。层级放错,它就不在对应的加载范围里。

第二看 SKILL.md 的文件名和大小写是否准确。

第三看 YAML frontmatter 有没有语法错误。按作者的说法,这三处的出错概率占九成以上。

还有一个容易忽略的点。Claude Code 加载技能时会检查目录名和 SKILL.md 里的 name 字段是否一致。不一致虽然理论上也能加载,但触发和调用的成功率会明显下降。作者就是把目录命名成 my-skill-v1、name 写成 code-review,卡在这儿半天。

验证有没有加载,有三种问法

打开交互界面输入 / 看命令列表,已加载的技能会列在里面。也可以直接问一句「你现在加载了哪些技能」,装对了它会报出技能名和功能描述。第三种是半自动的:直接触发它的使用场景,比如说「用代码评审技能检查一下当前改动」,看它的行为是否按技能文件里定义的流程走。

自己写一个,从单个 SKILL.md 起步

标准目录结构里核心只有一个 SKILL.md,prompts/、scripts/、assets/ 都是可选的加分项。作者的建议是先写单个 SKILL.md,跑通了再拆 prompts 和 scripts。

有项目级需求就别放全局,放项目根目录的 .claude/skills/,跟着 git 一提交,团队其他人拉下来自动就能用,适合把团队级的标准流程沉淀下来。

那 17 个技能里,开发提效类的用得最勤。skill-247 把大重构拆成批次,每批跑完自己检查、写进度再继续;1m-context 遇到超长文件先切片摘要和索引,再按需深入具体段落;prompt-ultra 把模糊需求改写成含角色、目标、约束、步骤和输出格式的完整模板。

一分钟速查

常见问题

问:Skill 和 MCP 是什么关系?

答:MCP 解决能不能碰到外部工具,Skill 解决拿到工具之后怎么干活。Skill 用 allowed-tools 声明运行期能调哪些工具,里面就包括 MCP Server 暴露的能力。

问:装到全局还是项目里?

答:自己常用、跨项目都要的放 ~/.claude/skills/;团队共享、要跟着仓库走的放项目的 .claude/skills/。

问:技能目录里带脚本跑不起来?

答:检查脚本有没有执行权限,Linux 和 macOS 上偶尔要手动 chmod +x。

问:怎么算装对了?

答:输入 / 看列表,或者直接问它加载了哪些技能,装对了会报出技能名和功能描述。

来源与编译

本文转载自CSDN(weixin_29061531) 《Claude Code Skill 实战:17个亲测高效技能包与安装指南》,原文链接:https://blog.csdn.net/weixin_29061531/article/details/169758116。版权归原作者所有,如需删除请联系我们。

相关阅读

  • Codex 越改越乱,一个 Thread 只做一件事
  • Grok Bot 剪口播,三段提示词连原片都不碰
  • Unity 收购 Synty:六万多件低多边形素材将进入还在筹备测试的 Spark
  • Claude 防封偏方,1693 条记录验一遍
  • DeepSeek:直出 3D,它写完了看不出哪儿不对
  • Codex 能跑不等于对,架构并发别放手

浏览更多「AI」文章 ›

  • Skill 到底固化了什么
  • Skill 和 MCP 分工…
  • 三条安装路径,按环境挑
  • 装完没生效,先查这三件事
  • 验证有没有加载,有三种问法
  • 自己写一个,从单个 SKIL…
  • 一分钟速查
  • 常见问题
  • 来源与编译

文章导航

上一篇Grok Bot 剪口播,三段提示词连原片都不碰
下一篇Codex 越改越乱,一个 Thread 只做一件事

相关文章

Codex 越改越乱,一个 Thread 只做一件事 Codex 越改越乱,一个 Thread 只做一件事 Grok Bot 剪口播,三段提示词连原片都不碰 Grok Bot 剪口播,三段提示词连原片都不碰 Unity 官方收购博文配图:低多边形酒吧台球场景,台面中央为 Unity 与 Synty 标志 Unity 收购 Synty:六万多件低多边形素材将进入还在筹备测试的 Spark

沙雕应用推荐

AI 依赖症鉴定 AI 依赖症鉴定 12 道题。看看你有多离不开 AI,最后给你一张报告。 去玩一下 ↗

评测设计产业杂谈

软件技术分享

关于电子游戏的方方面面

栏目

  • 游戏产业
  • 游戏设计
  • 游戏热点
  • 工具指南
  • AI
  • 沙雕应用
  • 游戏7x24小时
  • 关于妙游社

本站

  • 首页
  • 隐私政策
  • 联系我们
  • 关于妙游社
  • 工具指南专题
  • 文章 RSS

关注公众号

沙漏社公众号二维码

© 2026 软件技术分享

沪ICP备19032461号-1

目录

×
  • Skill 到底固化了什么
  • Skill 和 MCP 分工在哪
  • 三条安装路径,按环境挑
  • 装完没生效,先查这三件事
  • 验证有没有加载,有三种问法
  • 自己写一个,从单个 SKILL.md 起步
  • 一分钟速查
  • 常见问题
  • 来源与编译
→ 目录