catalog/repos/ahgraber--skills.md

3.4 KiB
Raw Permalink Blame History

AI智能体技能库

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

Agent Skills智能体技能

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

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

使用方式

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

安装

使用 skills.sh CLI 安装技能:

# 安装前列出可用技能
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-codecodex 等)
-s, --skill <skills...> 按名称安装指定技能
-l, --list 列出可用技能但不安装
-y, --yes 跳过确认提示

其他命令:

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

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

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

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

延伸阅读