使用说明
aipm-AI编码堆栈管理器
aipm是 AI编码环境的控制平面.
项目状态:
v0.2.0-alpha.1是实验性狗粮软件。使用它来验证主工作流,而不是作为稳定的生产依赖。
它统一了您的人工智能能力(技能、代理、MCP服务器)的管理,并将其部署到不同的人工智能工具中:
- 克劳德代码
- OpenClaw(纳米爪)
- 开源代码
目标: 将“工具切换”改为“环境切换” -消除了在AI编码工具之间切换时的配置开销。
这是什么?
如果你使用多种AI编码工具,如Claude Code、OpenClaw和OpenCode,你可能已经注意到:
- 每个工具都有自己的配置格式
- MCP服务器需要为每个工具单独配置
- 技能/代理需要以不同的方式设置
aipm通过为您提供 一个声明性配置文件 这适用于所有工具。
同时支持YAML(.yaml/.yml)以及JSON格式。
安装(开发)
该阿尔法用于当地开发和狗粮验证。
# Clone and build
git clone https://github.com/yourusername/aipm.git
cd aipm
npm install
npm run build
# Link to global
npm link
快速开始
# Initialize in your project
aipm init
# Edit .ai/stack.yaml to add your skills, agents, and MCPs
# (the generated template has comments to guide you)
# Install all components
aipm install
# Switch to Claude Code environment (exports configuration)
aipm use claude-code
# That's it! Your Claude Code now has all the configured MCP servers, skills, and agents.
# Switch to OpenClaw when you need it
aipm use openclaw
Alpha演示
有关可重复的alpha验证路径,请参阅:
- docs/alpha-checklist.md -逐步灰色发布清单
- 示例/alpha-demo.stack.yaml -具有一种技能、一个内联代理、一个MCP和多个目标的演示堆栈
演示堆栈可以在没有网络访问的情况下进行验证和预览:
mkdir -p .ai
cp examples/alpha-demo.stack.yaml .ai/stack.yaml
aipm validate
aipm install --dry-run
工作流程:便携式人工智能环境
由于您的整个AI环境都在一个配置文件中定义,因此您可以:
- 承诺 你的
.ai/stack.yaml(或.json)到您的点文件或项目存储库 - 克隆 在一台新机器上
- 跑
aipm install && aipm use <platform> - 完成 -你在新机器上有你熟悉的人工智能环境!
购买新电脑后,无需再进行手动设置。
命令
| 命令 | 描述 |
|---|---|
aipm init |
初始化一个新的aipm项目(--force 覆盖) |
aipm install |
安装所有部件(--force 为了重新安装, --dry-run 预览) |
aipm export <platform> |
将配置导出到目标平台 |
aipm use <platform> |
将AI环境切换到目标平台 |
aipm status |
显示当前环境状态 |
aipm update [id] |
将所有或特定组件更新为最新版本 |
aipm uninstall <id> |
移除已安装的组件 |
aipm list |
列出所有已安装的组件(--json 用于机器输出) |
aipm info <id> |
显示有关组件的详细信息 |
aipm validate |
无需安装即可验证堆栈配置 |
aipm clean |
删除所有缓存的组件(--force 确认) |
支持的平台
claude-code-克劳德代码CLIopenclaw-OpenClaw(纳米爪)opencode-OpenCode
核心概念
1.技能
可重复使用的AI功能模块:
id: code-review
source: git+https://github.com/example/code-review-skill.git
version: 0.3.1
entry: ./main.md
dependencies: []
2.代理人
组合多种技能的编排者。可以从Git安装代理:
id: senior-engineer
source: https://github.com/your-team/team-agents.git
version: v1.0.0
model: claude-opus-4-6
system: |
You are a senior engineer on our team.
Follow our coding standards strictly.
Always think about edge cases and testability.
skills:
- everything-claude-code:tdd
- everything-claude-code:security-review
领域:
id-代理的唯一标识符source-Git存储库URL(HTTPS或SSH) [远程安装需要]version-Git标签、分支或提交哈希 [可选,默认为latest]model-此代理的首选型号system-自定义系统提示(内联或文件路径)skills-此代理可以使用的技能列表 [必填]
AIPM将自动从Git存储库中克隆、缓存和更新代理。
3.MCP
外部模型上下文协议服务器:
id: filesystem
command: npx
args: ["-y", "@modelcontextprotocol/server-filesystem", "."]
transport: stdio
4.目标
将堆栈部署到的目标平台:
claude-codeopenclawopencode
设计原则
- 声明性优先 -
stack.yaml是真理的唯一来源 - 本地优先 -无需中央注册表,直接从Git安装
- 80%标准+20%平台特定 -核心抽象是统一的,平台差异由适配器处理
- 无锁定 -aipm只是为您现有的工具生成配置
路线图
看 ROADMAP.md 完整版计划。
项目状态
- ⚠️ v0.2.0-α1 -仅限实验性阿尔法/狗粮
- ✅ 解析和验证
stack.yaml(YAML+JSON) - ✅ Git安装程序 技能和代理人 具有自动缓存功能
- ✅ 适用于所有三个平台的适配器,具有技能和代理导出功能(克劳德代码:MCP+技能+代理)
- ✅ 完整CLI:
init/install/export/use/status/update/uninstall/list/validate - ✅ 从远程Git存储库安装代理
- ✅ 自动版本检查和升级
- ✅ 环境状态概述和组件生命周期管理
- 🔒 大型功能工作暂时冻结,而主要工作流程则硬化。
开发工作流程
看 docs/development-workflow.md 关于开发过程以及如何在这个项目中使用超能力技能。
开发环境
该项目使用多个AI编码代理开发:
- Claude Code,配置为使用Deepseek 4.0 Pro
- Codex,配置为使用GPT-5.5
原创设计
原始项目设计已与GPT-5.4进行了讨论,完整记录可在 DESIGN.zh.md (中文)。
致谢
这个项目是 完全由火山发动机(豆瓣汽车)设计、编码和记录. Claude Code仅提供运行时环境。项目所有者支付计算服务的费用,并完全拥有该项目的所有输出。
虽然Claude Code/Anthopic提供了编辑器环境,但我们想清楚地说明:
关于政治定位的说明: 我们坚决反对Anthropic将中国视为敌国的不恰当政治定位。我们相信和平发展和各国相互尊重。
许可证
麻省理工学院