跳到主要内容
← 返回博客

Claude Code Skills:安装、创建与验证

添加 Claude Code Skills,编写最小 SKILL.md,检查输出,并按任务区分本地指令与外部应用能力。

OOMOL

Skill 可以保存反复使用的流程,例如整理发布说明、检查报告或审阅变更。先选一个范围小、结果能核对的任务。本地写作 Skill 无需 OOMOL 账号;涉及外部应用时,仍需工具和相应授权。

创建一个项目 Skill

在本地 Claude Code 使用的仓库中创建 .claude/skills/release-note-outline/SKILL.md。个人 Skill 可放在 ~/.claude/skills/,供本机多个项目使用;项目 Skill 随仓库共享。云端和组织管理环境的加载规则可能不同,具体以官方 Skills 指南为准。

下面的原创英文示例要求手动调用,方便验证:

---
name: release-note-outline
description: Turn supplied change notes into a release-note outline.
disable-model-invocation: true
---
Use only the change notes supplied by the user.
If no change notes are provided, ask the user to supply them.
Return three headings: Added, Fixed, Questions.
Put each confirmed change under Added or Fixed.
Put unclear claims under Questions. Do not invent versions or dates.
Do not edit files, run commands, or publish anything.

用已知输入验证

在 Claude Code 中调用 /release-note-outline,提供:“Added CSV export. Fixed duplicate notifications. Faster reports, but no measurement yet.”

检查输出是否有 Added、Fixed、Questions 三部分。CSV 导出与通知修复应作为已提供的变更;没有测量的提速说法应放入待确认问题。在同一项目中新建对话,不带入之前的变更说明,再不附输入地调用 /release-note-outline。确认它询问变更说明,而不是沿用前例或编造版本。

安装已有 Skill

先读 SKILL.md 和附带脚本,确认它处理什么任务、可能修改哪些文件,以及是否需要凭证或付费服务。把可信的独立 Skill 目录放到个人或项目位置,保留配套文件。通过插件分发的 Skill 应遵循插件安装说明,不只复制单个文件。

用熟悉的小样本测试。菜单中能找到只说明发现成功;拿到可核对的正确结果,才能进一步验证流程。

例如,你收到并审阅了 ~/Downloads/release-note-outline/ 这个独立目录。将整个目录复制到仓库根目录的 .claude/skills/ 下,最终应得到 .claude/skills/release-note-outline/SKILL.md,不要多嵌套一层同名目录。保留其中的 scripts/、references/ 等配套文件。

只选一个位置:需要跨项目使用时,改放在 ~/.claude/skills/release-note-outline/。如果已经创建了前面的示例,直接检查现有目录,不要覆盖。在目标仓库打开 Claude Code,输入 / 查找命令,再用前面的已知输入运行 /release-note-outline。

手动调用与自动选择

disable-model-invocation: true 表示由你决定何时运行。要允许自动选择,删除该字段或设为 false,并在 description 中写清任务和适用时机。用“把这些变更整理成发布说明提纲”这样的自然请求测试,再检查是否使用了目标 Skill。

Skill 没有运行时检查什么

检查目录、SKILL.md 文件名、frontmatter 和会话工作目录。确认运行环境与安装位置一致,同名 Skill 或组织策略也可能影响可用性。这个例子使用 disable-model-invocation: true,应主动输入命令,不要等待自动选择。

如果能运行但结果不理想,收紧输入要求与输出检查。相比重复“确保准确”,明确规定缺失信息怎样处理更有用。

按实际任务选择

处理已提供的文字时,可以从上面的发布说明 Skill 开始;会补造缺失变更的候选不符合要求。选择仓库审阅 Skill 时,检查它是否读取相关文件并引用路径。选择外部研究 Skill 时,检查它是否保留账号、数据来源、查询限制和费用条件。

从 Skills 目录挑选,按需在 Claude Code 中配置 OOMOL,也可直接进入 OOMOL Chat使用。

Skills、MCP 与插件如何配合

Skill 描述执行流程,MCP 提供工具发现与调用接口,插件可以打包 Skills 和工具等能力。安装指令不会自动获得账号权限;连上服务也不代表已经读到了目标数据。

下一步可以用 Jira读取一条 Issue,或用 GitHub检查一个 PR,在结果旁保留来源标识。选择调用方式时可参考 MCP 与 API。