---
author: OOMOL
author_url: https://oomol.com/zh-cn/about/
datePublished: 2026-11-11
title: Claude Code Skills：安装、创建与验证
description: 添加 Claude Code Skills，编写最小 SKILL.md，检查输出，并按任务区分本地指令与外部应用能力。
lang: zh-CN
canonical_url: https://oomol.com/zh-cn/blog/claude-code-skills/
markdown_url: https://oomol.com/zh-cn/blog/claude-code-skills.md
---

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

## 创建一个项目 Skill

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

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

```markdown
---
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 目录](/zh-cn/skills/)挑选，按需[在 Claude Code 中配置 OOMOL](/zh-cn/install/claude-code/)，也可直接进入 [OOMOL Chat](https://console.oomol.com/overview)使用。
## Skills、MCP 与插件如何配合

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

下一步可以用 [Jira](/zh-cn/integrations/jira/)读取一条 Issue，或用 [GitHub](/zh-cn/integrations/github/)检查一个 PR，在结果旁保留来源标识。选择调用方式时可参考 [MCP 与 API](/zh-cn/blog/mcp-vs-api/)。
