agpm

基于Git的AI编码助手包管理器,实现依赖锁定与可复现安装。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:agpm。
它的用途是:基于Git的AI编码助手包管理器,实现依赖锁定与可复现安装。
完整的 Skill 内容见:https://321skill.com/skills/agpm/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请帮我初始化一个AGPM项目并安装一个Rust专家智能体。”,它会引导你创建 `agpm.toml` 文件并执行 `agpm install` 命令,从指定的社区仓库拉取并安装配置好的 Rust 专家智能体,让你在编码时能直接调用其专业知识。

介绍

AGPM 是一款专为 Claude Code、OpenCode 等 AI 编码助手设计的包管理器,旨在解决 AI 辅助开发中资源(如智能体、代码片段、命令)依赖管理混乱、安装不可复现的问题。它采用类似 Cargo 的锁文件机制,确保每次安装都能获得完全一致的资源版本,避免了因依赖版本漂移导致的工具行为不一致。

使用上,开发者只需在项目根目录创建 agpm.toml 清单文件,声明所需资源及其来源(支持任意 Git 仓库),然后运行 agpm install 即可。AGPM 会自动解析并安装所有依赖,包括传递性依赖,并将确切的版本信息锁定在 agpm.lock 文件中。

该工具非常适合需要团队协作或希望在不同项目间复用和标准化 AI 助手配置的开发者。无论是前端、后端还是全栈工程师,只要在项目中深度集成 AI 编码助手,都能通过 AGPM 提升工具链的稳定性和可维护性。

需要注意的是,该项目目前处于 Beta 阶段,生产环境使用需谨慎。其“技能”(Skills)等部分功能仍为 Alpha 状态,建议先在小规模或非核心项目中进行试用和评估。

核心特点

与同类工具相比,AGPM 的核心区别在于其完全去中心化的 Git 分发模式和严格的锁文件机制,确保了依赖安装的可复现性;同时,它原生支持七种资源类型(包括智能体、代码片段、MCP 服务器等),并提供了基于 BPE 的近似 Token 计数功能,便于开发者进行资源消耗跟踪。

注意事项

该项目尚处于 Beta 阶段,部分功能(如 OpenCode 支持、Skills)为 Alpha,不适合直接用于对稳定性要求极高的核心生产环境。

常见问题

AGPM 支持哪些 AI 编码工具?

目前主要支持 Claude Code,并对 OpenCode 提供 Alpha 版本支持,也支持通过自定义工具进行扩展。

AGPM 如何保证安装的可复现性?

通过生成并锁定依赖版本的 `agpm.lock` 文件,类似 npm 的 package-lock.json 或 Cargo 的 Cargo.lock,确保每次安装结果一致。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/agpm/raw/index.md 读取 agpm 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。