> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiji.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Skill 入门

> 用 Skill 教 AI 新的做事方法，Claude Code 和 Codex 都支持。

**Skill** 是一个包含 `SKILL.md` 说明文件的文件夹，用来教 AI 完成某类任务的固定流程。例如按团队规范写提交信息、按模板生成周报、处理某种文件格式。

AI 会根据 Skill 的描述，在合适的时候自动加载它。不需要写代码，写清楚说明即可。

## Skill 放在哪里

| 工具 | 个人目录（所有项目生效） | 项目目录（只对当前项目生效） |
| - | - | - |
| Claude Code | `~/.claude/skills/` | `.claude/skills/` |
| Codex | `~/.agents/skills/` | `.agents/skills/` |

每个 Skill 是其中的一个子文件夹，例如 `~/.claude/skills/commit-message/SKILL.md`。

## 写一个 Skill

`SKILL.md` 由头部信息和正文组成：

```markdown SKILL.md theme={null}
---
name: commit-message
description: 按团队规范编写 Git 提交信息。在用户要求提交代码或编写 commit message 时使用。
---

# 提交信息规范

1. 第一行格式为 `<类型>: <简述>`，类型为 feat、fix、docs、refactor、test 之一
2. 简述不超过 50 个字，使用中文
3. 空一行后写明改动原因，而不是改动内容
4. 涉及破坏性改动时，在末尾加 `BREAKING CHANGE:` 说明
```

| 字段 | 说明 |
| - | - |
| `name` | Skill 的名称，使用小写字母和短横线 |
| `description` | 说明这个 Skill 做什么、什么时候使用。AI 根据它判断是否加载，写得越具体越容易被正确触发 |

<Tip>
  Skill 文件夹里还可以放脚本、模板、参考文档，在 `SKILL.md` 中说明什么时候使用它们即可。
</Tip>

## 使用 Skill

* **自动触发**：对话内容符合 `description` 时，AI 会自动加载对应的 Skill
* **手动调用**：在 Claude Code 中输入 `/skill名称` 直接调用

## 获取现成的 Skill

[anthropics/skills](https://github.com/anthropics/skills) 提供了官方维护的 Skill 示例，包括处理 Word、Excel、PDF 等文档。下载需要的 Skill 文件夹，放进上方对应的目录即可。

<Warning>
  Skill 可以包含脚本并让 AI 执行。只使用可信来源的 Skill，安装前先阅读其中的内容。
</Warning>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.