cc-tree 径向树探索引擎
为 Claude Code 提供可审计的树状思考：每个节点都带证据、禁止拖延式叶子、只在真正收敛时停止。
- Star 数
- ★ 94
- 最近更新
- 5 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 67/100 · 存在缺口
30 秒速览
- 可在哪里用
- 平台专用Claude Code
- 开始前需要
- 典型场景
- 研究人员要在弱透镜探测暗物质子结构这类开放问题上穷举方向，需要一份带证据的候选清单而不是三段式提纲
- 主要局限
- 运行时完全绑定 Claude Code 插件机制，没有其他宿主或模型提供方的适配路径
- 源码审查
- 67/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
cc-tree 是一个 Claude Code 插件，把头脑风暴、对抗式批评、设计空间探索和代码审计统一到一个径向树探索引擎里。运行时是一份 Markdown 技能 skills/tree/SKILL.md 加上四个预设（brainstorm / attack / design / code-audit），用户通过 /cc-tree:tree、/cc-tree:brainstorm、/cc-tree:attack、/cc-tree:design、/cc-tree:code-audit 和 /cc-tree:tree-chain 调用。每轮扩展强制跑满 12 种框架（first-principles、inversion、red team 等），每个子节点必须填满 12 个字段并按 5 个维度打分，得到 advances / kept / pruned / blocked 的判定。运行会把每个节点即时写入 --out 目录下的 tree.md、tree.json 和主交付物（shortlist.md、confirmed.md、options.md 或 findings.md），中断后可用同样的 --out 续跑。仓库侧的 Python 工具（标准库、运行时不会被加载）负责校验清单、技能、预设、命令、交叉引用和中英文对齐，并重新生成并 diff 那张径向树示意图。它本身不携带模型，质量取决于你在 Claude Code 中使用的模型。
一次运行从单一根节点（主题、文档、代码或设计提示）出发，先按预设的 §2 配方构建根，可用 --glossary 或 §2.0 术语盘问锚定项目术语；随后对每个待扩展节点跑 12 种框架，生成每个框架一个子节点，按 evidence、no hedging、no defer 的 12 字段推导，再按 5 个维度（0–3 分）打分：≥11 为 advances 并再次展开，8–10 为 kept，≤7 为 pruned，未验证为 blocked（INCOMPLETE_FORBIDDEN 会阻止终止直到补齐）；余弦相似度 ≥0.85 的兄弟节点合并。只有 6 个收敛条件同时成立才结束，触发上限则报 WIDTH_CAP_REACHED / DEPTH_CAP_REACHED / ROUNDS_EXHAUSTED 而非 CONVERGED。输出目录包含 tree.md、tree.json、glossary-anchors.md、主交付物、次要交付物、REPORT.md 以及超长节点拆出的 nodes/<id>.md。tree-chain 按 --stages 依次运行多个预设，并用 --top-k 在阶段间传递候选；--seed-from 可以把上一轮的 primary.md 作为深度 1 的种子。
- 研究人员要在弱透镜探测暗物质子结构这类开放问题上穷举方向，需要一份带证据的候选清单而不是三段式提纲
- 审稿人或工程师要批判性检查一篇论文、一份提案或一段论证，希望每条质疑都标注 CONFIRMED / MARGINAL / REFUTED 并引用原文
- 架构师在内部管理工具的鉴权流程等设计题上比较多个选项的权衡、可逆性与成本，最终得到 RECOMMENDED 短名单
- 安全或后端开发者在 /src/api/upload.py 这类文件上做威胁建模与跨文件契约检查，找出 linter 看不到的问题并附 file:line 与修复建议
- 需要把头脑风暴、设计、对抗审查串成流水线的团队，用 tree-chain 把每阶段前 K 名自动传给下一阶段
- 希望整套推理过程可回放、可中断续跑的团队，用 tree.json 作为事实来源做后续审计
如何安装或部署这个 Agent？
在已安装并登录的 Claude Code 中依次执行：
claude plugin marketplace add skymanbp/cc-tree
claude plugin install cc-tree@cc-tree安装后重启 Claude Code 使插件加载；之后用下面的命令升级：
claude plugin update cc-tree可选：在本地仓库路径上执行 claude plugin validate <path-to-this-repo> 做校验。运行本身不需要 Python，但如需复现 CI 的校验，需要 Python 3.11 或 3.13。
如何使用这个 Agent？
先给一次带范围的尝试（封顶不等于收敛）：
/cc-tree:brainstorm "topic" --width 20 --depth 2 --no-online再按场景选命令：
/cc-tree:brainstorm "ways to detect dark-matter substructure with weak lensing"
/cc-tree:attack ./paper.tex --field physics --lang zh
/cc-tree:design "auth flow for our internal admin tool"
/cc-tree:code-audit ./src/api/upload.py
/cc-tree:tree <root> --preset ./my-custom-preset.md串联多个预设：
/cc-tree:tree-chain "..." --stages brainstorm,design,attack --top-k 3结果默认写入 tree-out/，预设命令写入 <preset>-out/，链式运行写入 chain-out/，每轮带 <UTCdate>__<slug>/ 子目录。中断后用同样的 --out 重新调用即可从最后一个完成的节点继续。
这个 Agent 有哪些优点和局限？
- 引擎与预设分离：四个预设共用同一套循环，自定义预设只需一个带 CI 校验 frontmatter 的 .md 文件，且不允许削弱通用规则
- 强制 12 种框架与 §F1–§F8 八道质量闸门，明确禁止 defer / future work / TODO 类叶子，并合并余弦 ≥0.85 的伪发散兄弟节点
- 收敛是可检验的 6 条件合取，上限默认无穷且触发时明确报 WIDTH_CAP_REACHED 等状态，不会把“想不出点子”伪装成收敛
- 每个节点填满 12 字段即落盘到 tree.md / tree.json，进程被杀或上下文溢出后可用相同 --out 续跑
- 仓库自带 tools/validate_plugin.py 七组检查、三个自测套件与示意图再生成 diff，并在 Python 3.11 与 3.13 上逐 PR 运行
- 支持 --lang 多语言输出与 field-profile 领域加权，machine token 与文件名保持英文，中英文档对不齐会让 CI 失败
- 运行时完全绑定 Claude Code 插件机制，没有其他宿主或模型提供方的适配路径
- 不附带模型也不提供输出质量基准，答案质量取决于用户自己的 Claude 模型设置，仓库只度量自身一致性
- 默认无上限：丰富的根话题可能跑数小时并消耗大量 token，官方建议第一遍先封顶
- CI 只校验仓库一致性，不校验单次运行是否遵守 §11 清单，运行内合规靠报告自审
- 子代理并行只节省实际耗时而非 token，主代理仍需重新验证子代理返回的每一条引用
- 翻译新鲜度由 CI 强制，但翻译质量仍是人工判断；--no-online 会把证据收窄到本地来源
这个 Agent 与同类方案有什么区别？
README 明确将其与学术 Tree-of-Thoughts 做了区分，并说明它是 skymanbp/sci-paper 中 brainstorm 与 paper-attack-tree 两个技能的领域无关抽取版。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| cc-tree 径向树探索引擎 当前 | 67 · 存在缺口 | — | ★ 94 | 5 天前 | Python | Claude Code |
| Ponytail | 50 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 173k | 5 天前 | JavaScript | Codex · Claude Code |
| CoCo Super Intelligence | 69 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 926 | 今天 | Python | Codex · Claude Code |
| 工作流插件：Claude Workflow V2 | 50 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 1.4k | 21 天前 | Python | Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：CI 工作流显式声明 permissions: contents: read，最小权限做得较好；运行产物写入 --out 目录且 .gitignore 化，可回滚/可恢复（增量写入、同 --out 续跑）；每个节点要求 file:line 或 URL 证据，来源归属较强。扣分：README 明确说明默认无上限、可运行数小时并消耗大量 token，且 §F6 禁止中途提示，用户确认环节薄弱；--no-online 与 §3.X 联网交叉核验的数据流向未在可见文件中说明；对敏感数据处理（如 code-audit 读取源码、可能外发到模型/网络）无专门说明；外部副作用（写文件、联网）缺乏显式确认门。
证据显示：validate_plugin.py 七组检查、三套自测（含负例与诊断断言）、CI 在 3.11/3.13 双版本运行，自洽性证据充分；失败信息有明确诊断字符串（如 WIDTH_CAP_REACHED、INCOMPLETE_FORBIDDEN）。扣分：运行时依赖 Claude Code 模型与插件市场，依赖可用性仅靠 README 断言；运行时（Markdown 提示）本身的失败处理无法静态验证，故未给满分。
证据显示：四个预设覆盖头脑风暴/对抗批评/设计空间/代码审计，§1.3 明确“不是什么”，能力边界写得清楚；--lang、--field、--preset 自定义路径提供环境适配。扣分：触发精度依赖命令与 flag 文档，未见对误触发/越界输入的防护说明；环境适配仅限 Claude Code 插件生态，跨环境支持有限。
证据显示：文档索引、架构图、仓库地图、已知限制（§9.2）、MIT 许可证齐全，信息架构与限制说明做得好。扣分：安装说明仅两条命令加“重启”，缺少故障排查；版本号在 README 快照中出现（0.7.4）但 CHANGELOG 内容未在证据中展示，版本化证据偏薄；发布者身份未经验证，维护责任归属不明确，故 maintenance_responsibility 仅 1。
证据显示：输出结构清晰（tree.md/tree.json/REPORT.md/主交付物），示例展示 BEFORE/AFTER 与逐条证据，输出可用性尚可。扣分：README 自承无输出质量基准，质量取决于模型；默认无上限导致成本可能很高，成本收益证据不足，故 cost_benefit 仅 1。
证据显示：每个节点要求 file:line/URL 证据，示例引用可追溯；CI 交叉引用检查（225 链接、9 示例引用）提供跨源一致性证据；§4 明确区分“结构验证”与“语义质量”，事实与推断分离较好。扣分：README 中的验证快照为自述，未在证据中独立复现；语义正确性明确不在 CI 覆盖范围。
- 默认无上限且禁止中途提示，长跑可能消耗大量 token 与时间；首次使用请显式设置 --width/--depth/--rounds 上限。
- code-audit 会读取源码，联网交叉核验（§3.X）的数据流向未在可见文件中说明；处理敏感代码前请确认 --no-online 与模型数据策略。
- 发布者身份未经验证，维护责任与更新路径不明确；安装前请自行审查插件内容。
- CI 只验证仓库自洽性，不验证运行输出质量；README 中的验证快照为自述，未经独立复现。