# AI智能体技能库

`AI智能体` `技能管理` `Claude` `自动化` `CLI工具`

# Agent Skills（智能体技能）

[Agent Skills](https://agentskills.io/home) 是由指令、脚本和资源组成的文件夹——通常用于编码程序性知识——智能体可以发现并使用它们来更准确、高效地完成任务。

- `skill.md` 是核心文件，描述该技能的功能、使用时机以及完成任务所需的程序性知识。
- 技能目录中可能包含按照 `skill.md` 指令执行所需的其他文档、脚本或资源。
- 包含 Python 脚本的技能使用 `uv` 管理依赖；你必须先安装 `uv`。

## 使用方式

如果底层智能体判断某个技能可能有用（基于技能的 `description` 字段，调整描述即可调整触发相关性），技能可以被自动调用。许多智能体也支持通过 `/-命令` 的方式强制调用技能。

## 安装

使用 [skills.sh](https://skills.sh) CLI 安装技能：

```bash
# 安装前列出可用技能
npx skills add ahgraber/skills --list

# 交互式安装所有技能（提示选择）
npx skills add ahgraber/skills -g

# 将指定技能安装到用户作用域（全局）
npx skills add ahgraber/skills --skill good-prose --skill mcp-research -g

# 安装到指定智能体
npx skills add ahgraber/skills --skill good-prose -a claude-code -a codex -g

# 安装到当前项目（而非全局）
npx skills add ahgraber/skills --skill code-review
```

**CLI 选项：**

| 参数 | 用途 |
| --- | --- |
| `-g, --global` | 安装到用户目录（对所有项目全局生效） |
| `-a, --agent <agents...>` | 指定目标智能体（`claude-code`、`codex` 等） |
| `-s, --skill <skills...>` | 按名称安装指定技能 |
| `-l, --list` | 列出可用技能但不安装 |
| `-y, --yes` | 跳过确认提示 |

**其他命令：**

```bash
npx skills list          # 显示已安装的技能
npx skills remove <name> # 卸载某个技能
npx skills update        # 更新所有已安装的技能
```

## 仓库说明

部分技能系列使用符号链接（symlink）来减少重复组件的版本漂移。贡献者在克隆本仓库后应启用符号链接检出：`git config core.symlinks true`。符号链接与 git 在 macOS/Linux 上配合最佳；在 Windows 上，符号链接行为可能因 `core.symlinks` 设置和用户权限而出现问题。

**关于 optimize-skills**：此技能需要系统中安装 [`graphviz`](https://www.graphviz.org/download/)。

**关于 mcp-research**：此技能假设 context7、exa 和/或 jina MCP 服务器可用。

**关于 sdd 技能系列**：`skills/sdd/references` 是共享 SDD 文件的唯一来源。`skills/sdd-*` 中的副本通过符号链接实现，以减少漂移。

**关于 spec-kit 技能系列**：`skills/spec-kit/scripts` 和 `skills/spec-kit/references` 是共享 Spec Kit 文件的唯一来源。`skills/spec-kit-*` 中的副本通过符号链接实现，以减少漂移。

## 延伸阅读

- [Claude Agent Skills：第一性原理深度解析](https://leehanchung.github.io/blogs/2025/10/26/claude-skills-deep-dive/)
- [OpenAI Codex 中的技能](https://blog.fsck.com/2025/12/19/codex-skills/)
- [用 Agent Skills 为智能体装备真实世界能力 \\ Anthropic | Claude](https://claude.com/blog/equipping-agents-for-the-real-world-with-agent-skills)
- [为 Claude 构建技能的完整指南 | Claude](https://claude.com/blog/complete-guide-to-building-skills-for-claude)