agent combo: Agent 开发环境一键初始化

Metadata

id	`combo-env-init`	recorded	2026-08-29
members	6	status	partial

install script ↓

Members (6)

tool	role	version	install	guide
`agent-framework`	环境骨架	`1.15.0；Python 3.10~3.13（3.14 全量安装部分依赖无预编译轮子，建议 core 精简路径）`	`pip install -i https://pypi.tuna.tsinghua.edu.cn/simple agent-framework # 精简路径（只跑核心编排）： pip install -i https://pypi.tuna.tsinghua.edu.cn/simple agent-framework-core==1.15.0`	guide
`agent-skills`	技能包	`0.6.7；Node >= 18（skills CLI 路径）`	`# 方式 A：skills CLI（官方推荐，装到 agent 技能目录） npx -y skills add addyosmani/agent-skills --yes --global # 方式 B：手工复制（国内稳，装到 ~/.claude/skills/agent-skills） curl -sL https://codeload.github.com/addyosmani/agent-skills/tar.gz/refs/tags/0.6.7 \| tar xz cp -r agent-skills-0.6.7/skills ~/.claude/skills/agent-skills`	guide
`superpowers`	方法论技能框架	`6.3.0；无运行时依赖（纯技能目录）`	`curl -sL -o /tmp/superpowers.tar.gz https://codeload.github.com/obra/superpowers/tar.gz/refs/tags/v6.3.0 mkdir -p ~/.codex/skills && tar xzf /tmp/superpowers.tar.gz -C /tmp --strip-components=1 superpowers-6.3.0/skills cp -r /tmp/skills ~/.codex/skills/superpowers`	guide
`herdr`	终端运行时	`0.8.2；Linux x86_64（无运行时依赖）`	`curl -sL -o /usr/local/bin/herdr https://gh-proxy.com/https://github.com/herdrdev/herdr/releases/download/v0.8.2/herdr-linux-x86_64 chmod +x /usr/local/bin/herdr && herdr --version`	guide
`ruflo`	元编排	`3.38.20；Node >= 20`	`npm_config_registry=https://registry.npmmirror.com npx -y ruflo init --no-signup --no-skills-sh --no-codex-detect npx -y ruflo --version`	guide
`claude-mem`	跨会话记忆	`13.16.1；Node >= 18；worker 运行时需 Bun`	`npm_config_registry=https://registry.npmmirror.com npm install -g claude-mem claude-mem install --ide claude-code`	guide

Install order

预检：node --version（>= 20）+ python3 --version（>= 3.10）+ command -v bun（claude-mem worker 用）。
agent-framework（pip 库形态，无配置目录/后台进程，最无侵入，先装不影响其他）。
agent-skills（技能目录写入，先装避免与后续技能集覆盖纠缠）。
superpowers（用 Codex 形态 ~/.codex/skills/superpowers；不要用 Claude 插件形态——与 ruflo 的 ~/.claude 写面存在 possible-conflict 推断态）。
herdr（单二进制，写面专属 ~/.config/herdr/ + ~/.local/state/herdr/，无共享面）。
ruflo（写面最大：工作区 .claude/ .claude-flow/ .agents/ .swarm/ .mcp.json CLAUDE.md + HOME ~/.claude/CLAUDE.md 指针；首次安装约 5 分钟 + 1.6GB 缓存，放靠后避免下载期阻塞其他成员验证）。
claude-mem（最后装：注册 ~/.claude.json + ~/.claude/plugins/ + ~/.claude-mem/，安装器自带 ~/.claude.json 备份可恢复）。

Dependency warnings

冲突（15 对全查，出处：站内文档）：
compatible 6 对：agent-framework × {agent-skills, superpowers, herdr, claude-mem}（agent-framework×claude-mem 为流水线实测，其余推断）、agent-skills × {superpowers, claude-mem}（技能子目录名唯一）
possible-compatible 7 对：agent-framework×ruflo、agent-skills×ruflo、agent-skills×herdr、superpowers×herdr、superpowers×claude-mem、herdr×ruflo、herdr×claude-mem（写面互不重叠推断）
possible-conflict 2 对（均涉 ruflo，推断态未实测）：superpowers×ruflo（ruflo 写工作区 .claude/skills 与 HOME ~/.claude/CLAUDE.md；superpowers Claude 形态写 ~/.claude/skills——用 Codex 形态即避开）、claude-mem×ruflo（双方都改 Claude 配置面：~/.claude.json 注册 vs ~/.claude/CLAUDE.md 指针；建议先装 claude-mem 后装 ruflo，异常时用 claude-mem uninstall 备份恢复）
版本：Node >= 20（ruflo 硬性；agent-skills/claude-mem >= 18）；Python 3.10~3.13（agent-framework 全量）/ 3.14 core；Bun（claude-mem worker）；Linux x86_64（herdr）
环境：ruflo 首次安装 ~5 分钟 + 1.6GB npx 缓存（磁盘余量建议 >= 3GB）；claude-mem worker 端口 37700；herdr 启动客户端会拉起后台 server（socket + session 文件），不用时 herdr server stop；ruflo doctor/start 拉起 daemon，用完 ruflo daemon stop
国内网络：pip → 清华镜像；npm → npmmirror；herdr → gh-proxy；技能包 → codeload 直连；claude-mem 安装器内部 git 克隆走 SSH 时，本机若绑定已冻结账号会失败——加 git config --global url.https://github.com/.insteadof git@github.com: 强制 HTTPS（2026-08-29 实测修复）

Linked problems

Evidence

Evidence details kept locally (2026-08-29)