Paks

面向 AI Agent 技能的包管理器,让技能在 Claude Code、Codex 等编码代理之间创建、安装、发布与共享。

源仓库
stakpak/paks
Star 数
★ 66
最近更新
4 个月前
License
Apache-2.0
主语言
TypeScript

30 秒速览

运行形态
命令行工具
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
Rust 2024 editionNode.js 18+pnpm 8+Shell / 命令行网络访问本地文件系统
典型场景
团队希望把内部编码规范、部署流程写成技能,并让使用 Claude Code 与 Cursor 的开发者安装同一版本。
不适合
  • 需要图形化界面管理技能的团队(Registry 网页端仅有本地开发端口)
  • 不熟悉命令行、希望零配置安装的用户
  • 希望技能在未安装 Paks 的环境中直接运行的团队
官网
paks.stakpak.dev ↗ 来自 GitHub 仓库设置
维护状态
近半年有提交最近提交 2026-07-04最新版本 v0.1.18(2026-01-21)

这个 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 参数 > 项目配置 > 全局配置 > 内置默认。

  1. 团队希望把内部编码规范、部署流程写成技能,并让使用 Claude Code 与 Cursor 的开发者安装同一版本。
  2. DevOps 工程师需要把 Kubernetes 部署步骤打包成技能,通过 paks install kubernetes-deploy --agent stakpak 分发。
  3. 个人开发者从 GitHub 仓库分享技能,接收方直接粘贴浏览器 URL 完成安装。
  4. 技能作者用 paks create 与 paks validate --strict 在发布前规范结构并做版本迭代。
  5. 项目把 .paks/config.toml 提交到版本库,统一整个仓库的默认代理与安装作用域。
  6. 需要管理多代理技能目录的用户用 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
42/ 100 五分制 2.1 / 5
信任安全 10/29
可靠稳定 5/14
适用触发 9/18
规范维护 8/18
有效结果 7/13
证据核验 3/8
查看各维度的扣分理由
信任安全10 / 29 · 1.7/5

安装命令会写入用户目录(如 ~/.claude/skills)并可从远程 registry/git 拉取技能,属于外部副作用;remove 有 --yes 跳过确认,publish 有 --skip-validation,说明存在确认机制但可被绕过。登录 token 通过 --token 参数传入,存在命令行泄露风险,未见敏感数据处理说明。依赖使用 reqwest/rustls 等常见库,但无审计或锁定说明。回滚仅靠 --force 重装,无版本回退或备份机制。来源归属仅 README 提及 Stakpak,无签名或校验。整体偏薄,扣分明显。

可靠稳定5 / 14 · 1.8/5

README 与 main.rs 的命令集基本一致,但 README 中 install 的 --version 选项在 main.rs 的 Install 子命令中未出现,存在文档与代码不一致。依赖版本用宽松范围(如 clap=4),无 Cargo.lock 证据。失败信息在源码样本中不可见,无法确认错误提示质量。

适用触发9 / 18 · 2.5/5

面向多 AI 编码代理(Claude Code、Cursor、Copilot 等),场景覆盖创建/安装/发布/校验,受众清晰。但能力边界(如安装的技能是否执行脚本、allowed-tools 实验性字段)未说明,触发精度依赖 SKILL.md 描述,样本中无具体技能示例。环境适配有 Homebrew、二进制、源码三种方式,较完整。

规范维护8 / 18 · 2.2/5

README 信息架构清晰,含安装、快速开始、CLI 参考、配置。安装说明详尽。但 Cargo.toml 中 workspace.package license 写为 MIT,而 LICENSE 文件与 README 徽章为 Apache-2.0,存在许可证不一致。无 CHANGELOG 文件,版本号 0.1.18 但无变更记录。维护责任仅指向 Stakpak 与 Discord,发布者未经验证。无已知限制章节。

有效结果7 / 13 · 2.7/5

CLI 输出支持 table/json/yaml,validate 有 strict 模式,publish 有 dry-run,输出可用性较好。作为技能包管理器有明确边际价值。但成本收益受限于 registry 默认指向 localhost:3001(开发环境),生产可用性存疑。

证据核验3 / 8 · 1.9/5

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 子命令中缺失,文档与代码不一致。
证据充分度:低 评估于 2026年11月16日 审查版本 117ae7725035
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/paks.svg?lang=zh)](https://followagents.com/zh/agents/paks)
<a href="https://followagents.com/zh/agents/paks"><img src="https://followagents.com/badge/paks.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.1.18
    发布说明摘录
    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 查看 ↗
  2. v0.1.16
    发布说明摘录
    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 查看 ↗
  3. v0.1.15
    发布说明摘录
    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 需要付费吗?
Paks 以 Apache-2.0 许可开源,README 未提及任何付费计划;成本主要来自你选择的代理本身以及可能的模型调用费用。
安装技能会写到哪里?
由 --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 的 GitHub 仓库填写的官网是 https://paks.stakpak.dev。这个链接由仓库作者设置;源码在 GitHub(stakpak/paks)。
Paks 开源吗?
开源。源码在 GitHub(stakpak/paks),许可证是 Apache-2.0。
Paks 安全吗?
FollowAgents 的 FARS 评审(2026年11月16日)给 Paks 的“信任与安全”打了 10/29 分。评审检查的 8 项安全措施没有完全缺失的。
Paks 还在维护吗?
更新变慢了:GitHub 上最近一次提交是 2026-07-04,在最近半年内,但不在最近 30 天内。最新版本是 v0.1.18(2026-01-21)。
Paks 是谁开发的?
Paks 由 GitHub 账号 stakpak 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念