reseed:AI 代理技能管理器
reseed 管理个人技能库,并将技能安装到项目中。技能是包含 SKILL.md 文件的目录,遵循 Agent Skills 规范。它们位于每个项目的技能目录(默认 .agents/skills/,或 Claude Code 的 .claude/skills/)中,可被 30 多种代理读取(Claude Code、Cursor、Copilot、Codex、Gemini CLI 等)。
你的主要工作在项目侧:检查已安装的技能、添加必要的技能以及保持同步。当用户希望从 GitHub 拉取技能到其库中时,你也可以运行 reseed install,但除此之外,请让用户自行管理库的结构和内容。
注意:不带参数的 reseed 会打开交互式 TUI。这是供用户在其自己的终端中运行的,不适合你使用。如果他们想以可视化方式浏览库,请告诉他们自己运行 reseed。对于其他所有操作,请使用下面的 CLI 命令。
快速参考
reseed # 交互式 TUI(供用户运行,不是给你用的)
reseed init <path> # 创建新库(首次设置)
reseed status # 显示此项目中已安装的技能
reseed list -l # 显示用户库中的技能(附描述)
reseed add <技能或包...> # 将技能/包从库复制到项目中
reseed add --all # 添加库中的所有技能
reseed remove <技能...> # 从项目中移除技能
reseed sync # 从库重新复制已安装的技能(获取更新)
reseed install <用户/仓库> # 从 GitHub 获取技能到库中
工作原理
- 用户拥有一个库:其机器上存储所有技能的目录。它可以包含包(相关技能的命名分组)。
reseed add将技能从库复制到项目的技能目录。这些是真实的文件副本,而非符号链接,因此它们会出现在 git 中,团队中的每个成员都能获取到。reseed sync重新复制同时存在于项目和库中的技能,拉取任何更新。不在库中的技能将被保留,包括孤儿技能:如果某个技能在添加到项目后从库中删除,sync不会删除过时的副本。如需删除,请使用reseed remove。- 没有项目清单。同步通过文件夹名称进行匹配。
典型工作流
0. 确认目标目录
在运行项目侧命令之前,检查 reseed 的目标目录:
reseed config dir
如果输出为 .agents/skills (default),但用户使用的是 Claude Code(从 .claude/skills/ 读取),建议运行 reseed config dir .claude/skills 一次以切换全局默认值。运行前请确认,因为它会更改用户级配置。如果用户不想更改默认值,则改为在每个命令中传递 --dir .claude/skills:
reseed --dir .claude/skills add commit
如果 reseed config dir 已经输出正确的路径,则无需覆盖。直接运行下面的命令即可。
1. 检查已有内容
reseed status
如果技能目录尚不存在,也没关系。当你添加技能时,reseed 会自动创建它。
2. 查看可用内容
reseed list -l
这将显示用户库中所有技能和包及其描述。在建议添加内容之前,请使用此命令了解可用的技能。
3. 将技能添加到项目
reseed add commit review python-base # 在一个命令中混合技能和包
reseed add --all # 或者直接添加所有内容
你可以在单次 reseed add 命令中传递任意数量的技能和包,reseed 会自动将包展开为单个技能。选择与项目技术栈和需求匹配的技能。
4. 保持技能更新
reseed sync
当用户希望将最新版本的技能拉取到项目中时运行此命令。
从 GitHub 安装技能
install 和 add 执行不同的操作:
reseed install从 GitHub 获取技能到用户的库中。它接受用户/仓库[/路径][@版本]引用,而非 URL。reseed add将技能从库复制到项目中。它接受本地技能或包名称。
reseed install user/repo # 仓库中的所有技能
reseed install user/repo/path/to/skills # 特定目录下的技能
reseed install user/[email protected] # 固定到某个版本标签
reseed install user/repo --pack mypack # 将它们分组到一个包中
安装后,使用 reseed add 将它们导入项目。
GitHub 的公共 API 每小时只允许大约 60 次未认证请求,因此连续快速运行多个安装可能会触发速率限制。如果 reseed install 因速率限制错误而失败,建议在环境中设置 GITHUB_TOKEN 以进行身份验证。
当 reseed 未安装时
如果找不到 reseed,请引导用户执行安装命令:
curl -fsSL https://raw.githubusercontent.com/nattergabriel/reseed/main/install.sh | sh
在 Windows 上,他们可以从最新发布下载二进制文件。
当尚无库时
如果 reseed 已安装但命令因“库未初始化”而失败,用户需要创建一次库:
reseed init ~/skills # 或任何他们偏好的路径
之后,CLI 命令就可以针对新库正常工作了。