Paks
面向 AI Agent 技能的包管理器,让技能在 Claude Code、Codex 等编码代理之间创建、安装、发布与共享。
- 源仓库
- stakpak/paks
- Star 数
- ★ 66
- 最近更新
- 4 个月前
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 42/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 团队希望把内部编码规范、部署流程写成技能,并让使用 Claude Code 与 Cursor 的开发者安装同一版本。
- 不适合
- 需要图形化界面管理技能的团队(Registry 网页端仅有本地开发端口)
- 不熟悉命令行、希望零配置安装的用户
- 希望技能在未安装 Paks 的环境中直接运行的团队
- 官网
- paks.stakpak.dev ↗ 来自 GitHub 仓库设置
- 维护状态
- 近半年有提交最近提交 2026-07-04最新版本 v0.1.18(2026-01-21)
- 源码审查
- 42/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Paks 是一个以 CLI 为核心的 Agent Skills 包管理器,由 Stakpak 使用 Rust 开发,遵循 AgentSkills 标准。它把技能定义为一套可复用的指令集,结构是一个包含 YAML frontmatter 与 Markdown 正文的 SKILL.md 文件,并可附带 scripts、references、assets 目录。CLI 提供 create、install、publish、validate、list、remove、search、info 以及 agent 管理、login/logout 等命令,能把技能安装到 stakpak、claude-code、cursor、vscode、copilot、goose、opencode 等代理的全局或项目目录。安装来源支持注册表、GitHub/GitLab 仓库 URL 和本地路径,并支持语义化版本与依赖声明。项目还包含一个基于 TanStack Router 的 Registry 网页界面和 REST API,用于浏览与检索技能,但 README 中仅给出本地开发端口。整体上它解决的是团队在多个编码代理之间统一、版本化地分发编码规范与领域知识的问题。
paks create <name> 按模板(basic、devops、coding)生成含 SKILL.md 的技能目录,可选 --with-scripts、--with-references、--with-assets。paks validate 依据 Agent Skills 规范校验结构与元数据,--strict 会把警告升级为错误。paks install <source> 从注册表名称、完整的 GitHub/GitLab 浏览器 URL 或本地路径拉取技能,按 --agent 与 --scope(global/project)解析出形如 ~/.claude/skills 或 ./.claude/skills 的落盘目录,也可用 --dir 自定义,并支持 --version 与 --force。paks publish 在登录后按 --bump patch|minor|major 提升版本并推送到注册表,--dry-run 只预览。paks list 以 table/json/yaml 输出已安装技能,paks search 与 paks info 查询注册表。paks agent add/remove/default/show 维护自定义代理目录,配置写入 ~/.paks/config.toml 与项目级 .paks/config.toml,优先级为 CLI 参数 > 项目配置 > 全局配置 > 内置默认。
- 团队希望把内部编码规范、部署流程写成技能,并让使用 Claude Code 与 Cursor 的开发者安装同一版本。
- DevOps 工程师需要把 Kubernetes 部署步骤打包成技能,通过
paks install kubernetes-deploy --agent stakpak分发。 - 个人开发者从 GitHub 仓库分享技能,接收方直接粘贴浏览器 URL 完成安装。
- 技能作者用
paks create与paks validate --strict在发布前规范结构并做版本迭代。 - 项目把
.paks/config.toml提交到版本库,统一整个仓库的默认代理与安装作用域。 - 需要管理多代理技能目录的用户用
paks list --all --format json汇总所有代理已装的技能。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
brew install paks
- 配置文件
~/.paks/config.toml- 运行环境
- Rust 2024
- 安装说明涉及
- macOS · Linux
如何安装或部署这个 Agent?
macOS 与 Linux 可用 Homebrew:
brew tap stakpak/stakpak
brew install paks也可以从 Releases 页下载对应平台二进制,例如 Linux x86_64:
curl -L https://github.com/stakpak/paks/releases/latest/download/paks-linux-x86_64.tar.gz | tar xz
sudo mv paks /usr/local/bin/从源码构建需要 Rust 2024 edition:
git clone https://github.com/stakpak/paks.git
cd paks
cargo build --release -p paks-cli
cp ./target/release/paks ~/.local/bin/安装后验证:
paks --version
paks --help如何使用这个 Agent?
创建并校验一个技能:
paks create my-awesome-skill --with-scripts --with-references
paks validate my-awesome-skill --strict从注册表或 GitHub 安装到指定代理:
paks install kubernetes-deploy --agent claude-code --scope project
paks install https://github.com/user/repo/tree/main/path/to/skill查看已安装技能并管理代理:
paks list --all --format json
paks agent add my-agent --dir ~/my-agent/skills --project-dir .my-agent/skills发布前先试运行,再登录推送:
paks publish my-awesome-skill --dry-run
paks login
paks publish my-awesome-skill --bump patch全局配置位于 ~/.paks/config.toml:
default_agent = "stakpak"
default_scope = "global"
[registries.default]
url = "https://registry.paks.dev"这个 Agent 有哪些优点和局限?
- 单一 CLI 即可把技能统一装到 stakpak、claude-code、cursor、vscode、copilot、goose、opencode 等多个代理的目录,避免手工复制。
- 支持从注册表、GitHub/GitLab 浏览器 URL 和本地路径三种来源安装,来源切换成本低。
- SKILL.md 遵循 AgentSkills 规范,并在其上扩展 version、authors、keywords、dependencies 等包管理字段。
- 配置采用 CLI 参数 > 项目配置 > 全局配置的优先级,团队可提交
.paks/config.toml统一安装行为。 - Apache-2.0 许可,Rust 实现,提供 Homebrew 与预编译二进制等多平台安装方式。
- Registry 网页端在文档中只给出本地开发地址
http://localhost:3001,未见公共托管实例的说明。 - 发布与登录依赖
registry.paks.dev注册表服务,离线或私有环境自行部署服务端的步骤未在 README 中说明。 - 默认代理与目录绑定具体产品(如
~/.claude/skills、.config/opencode/skill),代理目录变更后需自行用agent add维护。 - 从源码构建需要 Rust 2024 edition(nightly)以及 Node.js 18+、pnpm 8+ 才能跑通整个 monorepo。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Paks 当前 | 42 · 缺口较多 | 命令行工具免费 | ★ 66 | 4 个月前 | TypeScript | Codex · Claude Code |
| Beautiful Rust | 71 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 2.1k | 12 天前 | Python | ChatGPT · Codex · Claude Code · Claude.ai |
| Cutaway 演示录制器 | 47 · 缺口较多 | — | ★ 46 | 1 个月前 | JavaScript | Codex · Claude Code |
| RTK 命令输出优化器 | 72 · 存在缺口 | 命令行工具免费 | ★ 87k | 今天 | Rust | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
安装命令会写入用户目录(如 ~/.claude/skills)并可从远程 registry/git 拉取技能,属于外部副作用;remove 有 --yes 跳过确认,publish 有 --skip-validation,说明存在确认机制但可被绕过。登录 token 通过 --token 参数传入,存在命令行泄露风险,未见敏感数据处理说明。依赖使用 reqwest/rustls 等常见库,但无审计或锁定说明。回滚仅靠 --force 重装,无版本回退或备份机制。来源归属仅 README 提及 Stakpak,无签名或校验。整体偏薄,扣分明显。
README 与 main.rs 的命令集基本一致,但 README 中 install 的 --version 选项在 main.rs 的 Install 子命令中未出现,存在文档与代码不一致。依赖版本用宽松范围(如 clap=4),无 Cargo.lock 证据。失败信息在源码样本中不可见,无法确认错误提示质量。
面向多 AI 编码代理(Claude Code、Cursor、Copilot 等),场景覆盖创建/安装/发布/校验,受众清晰。但能力边界(如安装的技能是否执行脚本、allowed-tools 实验性字段)未说明,触发精度依赖 SKILL.md 描述,样本中无具体技能示例。环境适配有 Homebrew、二进制、源码三种方式,较完整。
README 信息架构清晰,含安装、快速开始、CLI 参考、配置。安装说明详尽。但 Cargo.toml 中 workspace.package license 写为 MIT,而 LICENSE 文件与 README 徽章为 Apache-2.0,存在许可证不一致。无 CHANGELOG 文件,版本号 0.1.18 但无变更记录。维护责任仅指向 Stakpak 与 Discord,发布者未经验证。无已知限制章节。
CLI 输出支持 table/json/yaml,validate 有 strict 模式,publish 有 dry-run,输出可用性较好。作为技能包管理器有明确边际价值。但成本收益受限于 registry 默认指向 localhost:3001(开发环境),生产可用性存疑。
README 声明与源码部分可对应(命令、agent 目录),但 registry 地址、API 端点等声明无法在样本中验证。CI 工作流显示有测试步骤,但测试内容不可见。事实与推断在文档中未明确区分(如 allowed-tools 标注实验性但无细节)。
- Cargo.toml 声明 MIT 而 LICENSE/README 为 Apache-2.0,许可证不一致,使用前需澄清。
- registry 默认指向 localhost:3001 开发地址,生产可用性未证实。
- 登录 token 可通过 --token 命令行传入,可能泄露到 shell 历史。
- 安装技能会写入用户目录并从远程拉取内容,未见签名或完整性校验。
- README 的 install --version 选项在源码 Install 子命令中缺失,文档与代码不一致。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
0.1.18 Released on 2026-01-21. Bug Fixes - Use Path::ends_with for cross-platform test compatibility Maintenance - Bump version to 0.1.18在 GitHub 查看 ↗ -
发布说明摘录
0.1.16 Released on 2026-01-16. Bug Fixes - Sync remote tags before listing for publish Maintenance - Bump version to 0.1.16在 GitHub 查看 ↗ -
发布说明摘录
0.1.15 Released on 2026-01-13. Bug Fixes - Use cross-platform path assertions in config tests Maintenance - Bump version to 0.1.15在 GitHub 查看 ↗
常见问题
使用 Paks 需要付费吗?
安装技能会写到哪里?
--agent 与 --scope 决定。global 写入用户目录(如 ~/.claude/skills),project 写入项目目录(如 ./.claude/skills),也可用 --dir 直接指定路径,CLI 参数优先级最高。不发布到公共注册表能否使用?
install 支持 GitHub/GitLab 浏览器 URL 与本地路径作为来源;但 publish、search、info 依赖注册表服务,README 只记录了默认地址 https://registry.paks.dev。SKILL.md 必须符合什么格式?
name(1-64 字符,小写与连字符)和 description(1-1024 字符),其余如 license、metadata、allowed-tools 为规范的选填项;Paks 另加 version、authors、keywords、dependencies 等扩展字段。如何确认技能结构正确再发布?
paks validate <path>,严格模式 --strict 会把警告当作错误;发布前可用 paks publish <path> --dry-run 预览将要上传的内容。Paks 官网是什么?
Paks 开源吗?
Paks 安全吗?
Paks 还在维护吗?
Paks 是谁开发的?
谢谢反馈,我们会据此改进页面。