Claude Code skill 是针对某类工作的可复用指令包,可以让项目规范或检查流程更容易调用。安装后仍须判断指令是否可信,工具权限也要另外管理。
有用的目标是让一项重复任务更稳定,并弄清这些指令会要求 Agent 做什么。技能数量本身说明不了效果。
选择够用的范围
Claude Code 支持个人与项目技能目录。只属于某个代码项目的要求,可以放在项目内;确实需要跨项目共用的指令,再考虑个人范围。查找和配置方式以官方 Skills 指南为准。
添加之前,先看同样的要求是否已经在项目规范或另一项 skill 中。两个包都试图决定测试、提交和部署流程时,容易产生冲突。
建议让影响较大的工作流程各有一处明确规则。例如,代码审查 skill 可以报告问题,不应自行接管是否发布改动的决定。
从一个小示例开始
下面是原创的手动审查清单示例。阅读并确认后,可以放在项目支持的路径中,例如 .claude/skills/review-change/SKILL.md。
使用 /review-change 手动调用。手动调用设置控制的是触发方式,不能把它解释成沙箱,或保证任何工具动作都在技术上无法执行。
这个示例的职责容易检查,有输入、限定动作和预期输出。实际使用时,按项目调整验收标准,比添加泛泛的专家身份描述更有帮助。
启用第三方技能前检查整个包
除了简介,还要检查被引用的脚本与其他文件,尤其是联网地址、凭证处理、安装命令、大范围文件操作,以及提交和部署指令。
会下载并执行其他脚本的 skill,需要比纯文字清单更谨慎的信任判断。没弄清之前,不要拿敏感项目测试。技能文件和随包提交的示例都不应包含密钥。
也要查看技能声明的权限和客户端实际设置,不能因为文字写了“安全”就默认安全。替换有重叠的项目规则前,先保留可恢复副本。
测试输出是否正确
可以准备一个包含已知问题与正常改动的小型测试差异,检查它是否指出问题、没有捏造缺陷,也没有编辑文件。这是建议的测试方法,并非已经在你的环境执行过的结果。
找不到 skill 时,检查路径、文件名、元数据和当前客户端的发现规则。触发过于频繁时,缩小描述或要求手动调用。忽略项目限制时,先解决冲突,不要继续叠加新的技能包。
Skills 与 MCP 分别解决什么
Skills 说明工作方法,MCP 集成提供工具或数据。一个流程可以同时使用两者,但安装指令不会自动配置工具服务,接入工具也不会自动定义何时应该使用。Claude Code MCP 指南介绍另一部分配置。
共享项目中,把技能与任务资料一起维护,修改时像其他项目规则一样审阅。先看在 Agent.Space 使用 Claude Code和工作区如何组织文件与会话,不要假定托管环境与本机的技能发现方式完全相同。确认支持后,再从一个有限任务开始。
