Agent.Space 博客

Claude Code Skills 指南,安装范围与安全检查

用一个可检查的 SKILL.md 示例理解 Claude Code Skills,选择项目或个人范围,审核第三方脚本,并分清技能指令、工具权限和 MCP 配置。

Claude Code skill 是针对某类工作的可复用指令包,可以让项目规范或检查流程更容易调用。安装后仍须判断指令是否可信,工具权限也要另外管理。

有用的目标是让一项重复任务更稳定,并弄清这些指令会要求 Agent 做什么。技能数量本身说明不了效果。

选择够用的范围

Claude Code 支持个人与项目技能目录。只属于某个代码项目的要求,可以放在项目内;确实需要跨项目共用的指令,再考虑个人范围。查找和配置方式以官方 Skills 指南为准。

添加之前,先看同样的要求是否已经在项目规范或另一项 skill 中。两个包都试图决定测试、提交和部署流程时,容易产生冲突。

建议让影响较大的工作流程各有一处明确规则。例如,代码审查 skill 可以报告问题,不应自行接管是否发布改动的决定。

从一个小示例开始

下面是原创的手动审查清单示例。阅读并确认后,可以放在项目支持的路径中,例如 .claude/skills/review-change/SKILL.md。

markdown
---name: review-changedescription: Review a proposed patch against the task requirements.disable-model-invocation: true---
Review the supplied diff without editing files.Identify correctness risks and missing acceptance evidence.Distinguish confirmed defects from questions.Do not commit, push, deploy, or change account settings.Return actionable findings with file references.

使用 /review-change 手动调用。手动调用设置控制的是触发方式,不能把它解释成沙箱,或保证任何工具动作都在技术上无法执行。

这个示例的职责容易检查,有输入、限定动作和预期输出。实际使用时,按项目调整验收标准,比添加泛泛的专家身份描述更有帮助。

启用第三方技能前检查整个包

除了简介,还要检查被引用的脚本与其他文件,尤其是联网地址、凭证处理、安装命令、大范围文件操作,以及提交和部署指令。

会下载并执行其他脚本的 skill,需要比纯文字清单更谨慎的信任判断。没弄清之前,不要拿敏感项目测试。技能文件和随包提交的示例都不应包含密钥。

也要查看技能声明的权限和客户端实际设置,不能因为文字写了“安全”就默认安全。替换有重叠的项目规则前,先保留可恢复副本。

测试输出是否正确

可以准备一个包含已知问题与正常改动的小型测试差异,检查它是否指出问题、没有捏造缺陷,也没有编辑文件。这是建议的测试方法,并非已经在你的环境执行过的结果。

找不到 skill 时,检查路径、文件名、元数据和当前客户端的发现规则。触发过于频繁时,缩小描述或要求手动调用。忽略项目限制时,先解决冲突,不要继续叠加新的技能包。

Skills 与 MCP 分别解决什么

Skills 说明工作方法,MCP 集成提供工具或数据。一个流程可以同时使用两者,但安装指令不会自动配置工具服务,接入工具也不会自动定义何时应该使用。Claude Code MCP 指南介绍另一部分配置。

共享项目中,把技能与任务资料一起维护,修改时像其他项目规则一样审阅。先看在 Agent.Space 使用 Claude Code和工作区如何组织文件与会话,不要假定托管环境与本机的技能发现方式完全相同。确认支持后,再从一个有限任务开始。