Agent 工具链全家桶能一起装吗？（17 工具 57 对实测兼容清单）

你会遇到什么

想搭一套完整的 Agent 工具链（编排 + 技能 + 记忆 + 网关 + 安全 + 审查 + 可观测），不确定这些工具能不能一起装、会不会互相踩配置。结论：17 个工具两两共 57 对实测全部兼容。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

Agent 工具链 17 个工具两两共 57 对实测全部兼容：

冲突矩阵 210 对全量面声明中，本清单只含已实测 verified 部分；其余推断态（possible-conflict 17 对）待实测后再收录——未测不标。

多工具能否共存，判断标准是「写面是否重叠」：每个工具的写面 = 它启动/运行时独占读写的文件或目录（配置文件、状态目录、缓存）。无共享写面的工具对天然共存（互不感知）；共享同一写面（如 ~/.claude.json）时，只要各写各的 key/段且格式是「按 key 合并」的（JSON/ini 类），共存仍安全——冲突只发生在「同一位置以不同语义写入」或「整体覆盖」时。

确定性推论：判断两个工具是否冲突，先查它们的写面清单（配置路径、状态目录）再比对；实测 57 对全兼容 = 这 17 个工具的写面两两不冲突；「未测不标」不是托词——推断态（possible-conflict）的 17 对必须实测后才转 verified，因为写面分析只能排除明显冲突，不能证明无冲突。

一步步来

1. 冲突预检 — 必做

站内文档 --check

先看写面/端口面声明；或查 站内文档。

2. 按需安装 + 逐工具冒烟 — 必做

装完逐工具跑官方 CLI 版本命令（exit 0）；同装技能类（agent-skills/superpowers）后核对 ~/.claude/skills/ 目录清单。

3. 组合场景参考组合包 — 必做

组合包 001-003（agt+crg 混用 / crg+deepcode 同 venv / claude-mem+deepcode 跨生态），均实测通过。

4. 升级后重跑冒烟 — 必做

升级大版本后重跑冒烟；遇到新冲突走问题空间提交求助卡，官方重测后收录。

怎么确认修好了

逐工具冒烟全绿（预期形态）：

各工具官方 CLI 版本命令 → 全部 exit 0
ls ~/.claude/skills/ → 技能目录清单齐全

组合包场景按 001-003 复现通过（实测）。

其它环境的表现

症状

想搭一套完整的 Agent 工具链（编排 + 技能 + 记忆 + 网关 + 安全 + 审查 + 可观测），不确定这些工具能不能一起装、会不会互相踩配置。

原因

Agent 工具链 17 个工具两两共 57 对实测全部兼容：51 对无共享写面（各自独立 CLI/目录，天然互不干扰）；6 对共享 ~/.claude.json 写面（agt/deepcode/code-review-graph/claude-mem 相关对）但写不同 key/段，实测共存无覆盖。冲突矩阵 210 对全量面声明中，本清单只含已实测 verified 部分；其余推断态（possible-conflict 17 对）待实测后再收录。

解法

1. 按需安装，无强制顺序；冲突预检用 站内冲突预检说明（先看写面/端口面声明）或查 站内文档。
2. 装完逐工具冒烟（官方 CLI 版本命令 exit 0）；同装技能类（agent-skills/superpowers）后核对 ~/.claude/skills/ 目录清单。
3. 组合场景参考组合包 001-003（agt+crg 混用 / crg+deepcode 同 venv / claude-mem+deepcode 跨生态），均实测通过。
4. 升级大版本后重跑冒烟；遇到新冲突走问题空间提交求助卡，官方重测后收录。