73 lines
3.4 KiB
Markdown
73 lines
3.4 KiB
Markdown
# 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) |