Communitygithub.com

nattergabriel/reseed

用于管理和跨项目分发 AI 代理技能的命令行工具

reseed 是什么?

reseed 是一个 CLI 工具,旨在帮助开发者和 AI 代理(如 Claude Code、Cursor、Copilot 等)管理个人技能库,并在不同项目之间轻松分发和同步技能。其核心功能包括:从 GitHub 安装技能到本地库、将技能从库复制到项目目录、检查项目已安装的技能状态,以及同步更新技能。它遵循 Agent Skills 规范,技能目录通常位于项目的 `.agents/skills/` 或 `.claude/skills/` 下。该工具支持交互式 TUI 界面(供用户直接运行)和完全的命令行操作,非常适合需要跨多个项目复用和版本控制 AI 代理技能的工作流。注意,GitHub API 存在匿名请求频率限制,批量安装时可设置 `GITHUB_TOKEN` 环境变量来提升配额。

兼容平台✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add nattergabriel/reseed

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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 命令就可以针对新库正常工作了。

相关技能