@ai-outfitter/outfitter
统一管理AI代理配置与启动
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@ai-outfitter/outfitter。 它的用途是:统一管理AI代理配置与启动 完整的 Skill 内容见:https://321skill.com/skills/ai-outfitter-outfitter/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用 Outfitter 配置一个名为 engineer 的代理,包含 wiki 和 research 技能,并启动 Pi 会话',它会读取 `.agents/` 目录中的配置,自动组合技能、加载子代理,然后通过 Pi 启动交互式编码环境。
介绍
这个Skill解决了在多个AI编码代理(如 Pi、Claude Code)之间切换时配置重复、难以复现的问题。开发团队经常需要为不同项目定义不同的代理角色、技能组合和系统提示,但手工管理这些配置容易出错,且无法在团队成员间共享。
使用方式很简单,你只需要在项目根目录创建 .agents/ 文件夹,并按协议定义 agents.md、skill 子目录等配置文件。之后通过 npx @ai-outfitter/outfitter 即可自动解析配置,启动对应的代理 CLI。Outfitter 还支持从远程 catalog 拉取预设配置,并通过 outfitter setup 引导完成初始化。
它非常适合需要统一管理多个 AI 编码代理配置的团队或个人。尤其是那些已经使用 Pi 或 Claude Code 的开发者,可以通过 .agents 协议将配置纳入版本控制,实现环境一致性和快速复现。对于需要编排子代理、共享技能包的项目,Outfitter 提供了标准化的分层覆盖机制。
建议在项目初始化时统一使用 Outfitter 管理代理配置,避免手动维护多个 CLI 启动参数。需要注意的是,目前 Outfitter 仍处于过渡阶段,部分功能(如持久化符号链接、完全版 profile 管理系统)尚未完全实现,实际使用中请留意文档中的 RFC 状态。
常见问题
Outfitter 和 Pi 的 profile 系统是什么关系?
Outfitter 是 Pi 原生 profile 系统的上层封装,它会将 `.agents` 目录转换为 Pi 可识别的配置,未来会完全替代 Pi 的 profile 管理。
是否需要安装 Pi 或 Claude Code 才能使用?
Pi 已随 Outfitter 捆绑,无需额外安装;Claude Code 需要单独安装。Outfitter 会自动检测并调用已安装的运行时。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/ai-outfitter-outfitter/raw/index.md 读取 @ai-outfitter/outfitter 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/ai-outfitter-outfitter/raw/index.md(查看排版版本)