agent combo: 开发链路治理栈（agent-governance-toolkit + code-review-graph + herdr）

Metadata

id	`combo-governance-stack`	recorded	2026-08-29
members	3	status	verified

install script ↓

Members (3)

tool role version install guide

tool	role	version	install	guide
`agent-governance-toolkit`	策略门禁与合规检查	`[4.1.0, 4.1.0]（manifest 锁定单版本；CLI = agt，meta 包形态；本组合只用 CLI 面）`	`pip install agent-governance-toolkit --index-url https://pypi.tuna.tsinghua.edu.cn/simple agt --version # 预期输出: agt, version 4.1.0`	guide
`code-review-graph`	代码关联图谱	`[2.3.8, 2.3.8]（manifest 锁定；Python >= 3.10）`	`pip install -i https://pypi.tuna.tsinghua.edu.cn/simple code-review-graph==2.3.8 code-review-graph --version # 预期输出: code-review-graph 2.3.8`	guide
`herdr`	会话与工作区监督	`[0.8.2, 0.8.2]（manifest 锁定；Linux x86_64 单二进制，无运行时依赖）`	`curl -sL -o herdr https://gh-proxy.com/https://github.com/herdrdev/herdr/releases/download/v0.8.2/herdr-linux-x86_64 chmod +x herdr && ./herdr --version # 预期输出: herdr 0.8.2`	guide

agent-governance-toolkit

策略门禁与合规检查

[4.1.0, 4.1.0]（manifest 锁定单版本；CLI = agt，meta 包形态；本组合只用 CLI 面）

pip install agent-governance-toolkit --index-url https://pypi.tuna.tsinghua.edu.cn/simple
agt --version   # 预期输出: agt, version 4.1.0

guide

code-review-graph

代码关联图谱

[2.3.8, 2.3.8]（manifest 锁定；Python >= 3.10）

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple code-review-graph==2.3.8
code-review-graph --version   # 预期输出: code-review-graph 2.3.8

guide

herdr

会话与工作区监督

[0.8.2, 0.8.2]（manifest 锁定；Linux x86_64 单二进制，无运行时依赖）

curl -sL -o herdr https://gh-proxy.com/https://github.com/herdrdev/herdr/releases/download/v0.8.2/herdr-linux-x86_64
chmod +x herdr && ./herdr --version   # 预期输出: herdr 0.8.2

guide

Install order

先 agt（pip，纯 CLI，无后台进程）——策略门禁最先就位，后续安装动作都在门禁视野内。
再 crg（pip，纯 CLI）——与 agt 同 venv 共装实测兼容；不要执行 crg install 注册子命令（避免写 ~/.claude.json 等注册面）。
最后 herdr（独立二进制）——重件放最后，避免前面安装被其后台 server 干扰；status/config check 不拉起 server（实测）。

Dependency warnings

冲突：agt×crg compatible（verified 2026-08-28，组合包实测 001，CLI 面）；agt×herdr compatible（verified）；crg×herdr compatible（verified）——3/3 对子 verified，出处：站内文档 + 实测记录（本地留存）。未实测面：三者的 Claude Code 插件/MCP 注册形态（本机 Claude 未登录），保持矩阵 possible-conflict/possible-compatible 推断态。
版本：agt [4.1.0,4.1.0]；crg [2.3.8,2.3.8]（Python >= 3.10）；herdr [0.8.2,0.8.2]（Linux x86_64）。
环境：crg build 写工作区 .code-review-graph/；herdr 完整客户端写 ~/.config/herdr/ + ~/.local/state/herdr/ 且可能拉起后台 server（端口按需，与其它条目无固定端口冲突，推断）；agt CLI 面无配置目录写入。
国内网络：pip 两件走清华镜像（PyPI 直连超时）；herdr 二进制走 gh-proxy（GitHub 直连慢）。最容易卡的一步 = herdr 二进制下载，命令已内置 gh-proxy。

Linked problems

Evidence

Evidence details kept locally