reasoning-router

推理路由器

元推理层：对问题进行分类，分派给最合适的思考型 MCP， 监控进度，并在停滞时重新路由。以尽可能少的总 token 数得出高置信度结论。

始终使用最先进的模型（目前为 Opus 4.6）。关于 如何思考 的元推理是杠杆效益最高的推理任务。

分派

$ARGUMENTS	操作
问题或疑问文本	路由 — 分类并分派给最合适的思考方法
compare <problem>	比较 — 用 2-3 种策略处理同一问题，选出最佳方案
status	状态 — 显示当前思考会话状态
switch <method>	切换 — 在会话中途重新路由到指定方法
recap	回顾 — 总结目前使用所有方法的推理过程
methods	方法 — 显示可用方法及使用场景速查表
空	指南 — 显示路由速查表和 token 层级表

---

分类

运行 !uv run python scripts/problem-classifier.py "$ARGUMENTS" 进行确定性预扫描，然后结合 LLM 判断进一步完善。

轴 1 — 结构（推理的形态是什么？）

结构	特征	首选方法
可分解	“拆解”、多跳推理、子问题	atom-of-thoughts
顺序式	“逐步进行”、有序流程、调试	sequential-thinking
分支式	“探索选项”、“假设……会怎样”、备选方案	cascade-thinking
受约束	“给定条件”、要求、形式化规范	shannon-thinking
相互关联	依赖关系、循环关系、复杂系统	atom-of-thoughts（完整模式）
创意型	“头脑风暴”、“新颖”、“卡住了”、“换个角度”	creative-thinking
矛盾型	悖论、“两者都为真”、张力、两难	lotus-wisdom
调查型	“为何发生”、根本原因、调试、诊断	crash

轴 2 — 复杂度（需要多深入？）

复杂度	特征	深度控制
简单（1-3 步）	输入简短、单一概念、“快速”	仅 Tier 1：aot-light 或 sequential
中等（4-8 步）	多个因素、存在一定不确定性	默认深度，采用匹配结构的方法
复杂（9+ 步）	跨领域、高不确定性	完整深度，扩展步骤
棘手（开放式）	没有明确解法、价值观冲突	允许组合模式

轴 3 — 领域（属于哪一类？）

领域	方法	原因
工程/架构	shannon-thinking	约束 → 建模 → 证明
调试	crash	感知工具的调查
研究	cascade-thinking	并行视角
数学/逻辑	atom-of-thoughts	依赖关系 DAG
策略	think-strategies	策略比较
创意/设计	creative-thinking	横向思维技巧
哲学/伦理	lotus-wisdom	非二元整合
规划	sequential-thinking	线性推进
模式追踪	structured-thinking	持久化记忆

---

路由算法

优化目标：以尽可能少的总 token 数得出高置信度结论。

1. Run problem-classifier.py for deterministic signals
2. Score each axis (structure × complexity × domain)
3. Apply efficiency gate:
   - Simple: ALWAYS Tier 1 (aot-light or sequential-thinking)
   - Moderate: structure-matched method at default depth
   - Complex: full method with extended depth
   - Wicked: composition patterns allowed
4. Resolve conflicts:
   - Structure > domain (HOW > WHAT)
   - Complexity modulates depth AND tier
   - Ties: ALWAYS prefer lower token cost
5. Select primary + fallback
6. Present: "Using [method] — [why]. Fallback: [method]." (1 line)
7. Invoke with minimum viable totalThoughts
8. Monitor for stalls — escalate only on evidence

Token 成本层级

Tier 1 (lightest): aot-light, sequential-thinking
Tier 2 (moderate): structured-thinking, cascade-thinking, crash
Tier 3 (heavy):    shannon-thinking, atom-of-thoughts (full), think-strategies
Tier 4 (heaviest): creative-thinking, deep-lucid-3d, lotus-wisdom

效率规则

• 对 Tier 1-2 能处理的问题，绝不使用 Tier 3-4
• 从最低可行的 totalThoughts 开始；仅在 needsMoreThoughts 时增加
• cascade-thinking：最多从 2 个分支开始；只有覆盖不足时才增加
• creative-thinking：除非问题棘手，否则使用 timeframe: "quick"
• think-strategies：先从 linear 或 chain_of_thought 开始，再尝试成本更高的策略

---

停滞检测

出现任何停滞信号时，阅读 references/stall-detection.md。

4 种停滞信号：

1. 置信度停滞 — 连续 3 步或更多步的提升均不超过 0.05
2. 循环推理 — 重复陈述同一观点
3. 步骤超限 — 超过初始估算的 2 倍
4. 用户信号 — “试试别的方法”或 /think switch

按阻塞类型重新路由：

阻塞	新方法	原因
深入过头	cascade-thinking	拓宽视角
范围太广	atom-of-thoughts	分解问题
过于正式	creative-thinking	重新构思
过于抽象	crash	以证据为依据
存在矛盾	lotus-wisdom	整合观点
方法错误	重新分类	重新开始路由

硬性限制： 每个会话最多重新路由 3 次。步骤估算最多 3 倍。不得来回切换（不能返回已重新路由离开的方法）。重新路由 3 次后 → 执行恢复流程：呈现发现，请用户指导。

---

组合模式

阅读 references/composition-patterns.md，了解完整流程。

模式	顺序	适用时机
构思→细化	aot-light → aot（完整模式）	先快速列出纲要，再深入探究
发散→收敛	creative-thinking → sequential	先生成选项，再进行评估
探索→形式化	cascade-thinking → shannon	先考察全貌，再进行证明
分解→调查	aot → crash（逐个原子处理）	先拆解，再逐个调试
分析→整合	cascade-thinking → lotus-wisdom	先揭示矛盾，再综合分析
制定策略→规划	think-strategies → sequential	先退一步审视，再制定后续计划

上下文传递： 每次切换方法时，生成一份不超过 100 个词的摘要，概述关键发现及其置信度分数。保留观点，舍弃推理脚手架。

不应组合的情况： 复杂度简单或中等、第一种方法已趋于收敛、时间压力较大。

---

比较模式

使用 compare <problem> 调用时：

1. 按常规对问题进行分类
2. 选择 2–3 种候选方法（主要方法 + 1–2 种可行的替代方法）
3. 使用每种方法针对同一问题执行 3–5 步
4. 进行比较：哪种方法以更少的令牌得出了置信度更高的发现？
5. 提交比较表并推荐最佳方法
6. 若用户同意，则继续使用最佳方法

---

方法速查

使用 methods 调用时，或用于路由速查表时：

方法	MCP 工具	层级	最适用途
sequential-thinking	sequentialthinking	1	线性、有序推理
aot-light	aot-light	1	快速原子化构思
structured-thinking	capture_thought	2	跨会话记忆
cascade-thinking	cascade_thinking	2	多视角探索
crash	crash	2	与工具集成的调试
shannon-thinking	shannonthinking	3	约束条件下的形式化证明
atom-of-thoughts	aot + atomcommands	3	使用 DAG 进行深度分解
think-strategies	think-strategies	3	命名策略框架
creative-thinking	discover_techniques → plan → execute	4	横向思维（必须执行 3 步）
deep-lucid-3d	analyze_problem	4	全面的 UCPF 分析
lotus-wisdom	lotuswisdom（起始值：tag: begin）	4	悖论与矛盾

阅读 references/capability-map.md，了解完整的工具参数和工作流。

---

参考文件索引

文件	阅读时机
references/capability-map.md	首次调用，或不熟悉工具参数时
references/routing-matrix.md	解决路由冲突、平局或边缘情况时
references/composition-patterns.md	问题需要多工具组合时
references/stall-detection.md	出现停滞信号，或会话超过预期步数时

每次只加载一个参考文件。不要预加载。

---

适用范围

范围内： 问题分类、思考 MCP 调度、停滞检测、重新路由、组合模式选择、方法比较。

范围外： 实际执行推理（由思考 MCP 完成）、运行工具或编写代码（使用合适的技能）、代码审查（review）、研究（research）、调试实现（直接使用 crash MCP）。

---

规范术语

术语	含义
method	一种特定的思考 MCP 工具（例如，cascade-thinking）
tier	Token 成本分类（1 = 最轻，4 = 最重）
structure	问题所需推理的结构
routing	为已分类的问题选择最佳方法
stall	方法不再取得进展时（信心停滞、循环推理）
re-route	在会话中途切换到另一种方法
composition	针对复杂问题，按顺序串联 2 种或更多方法
efficiency gate	一项覆盖规则，强制对简单问题使用 Tier 1 方法
context transfer	切换方法时总结已有发现

---

关键规则

1. 始终使用最先进的模型——model: opus。绝不降级。
2. 尽量减少得出结论所需的总 Token 数——选择能够处理问题的最轻量方法。仅在有停滞迹象时升级。
3. 调用前先说明路由决策——用 1 行说明：方法、原因、备用方案。
4. 未经分类绝不调用——即使用户指定了方法，也要验证其是否合适。
5. 重新路由时沿用已有进展——总结发现，≤100 个词，不要重新开始。
6. 简单问题用简单方法——简单问题始终使用 Tier 1。没有例外。
7. 平局时按 Token 成本决胜——适配度相同 → 选择更低的 tier。
8. 从最精简配置开始，有证据再扩展——使用最低的 totalThoughts，仅在工具要求增加或检测到停滞时扩展。
9. 一次只使用一种方法——不得同时运行多个思考 MCP。组合必须按顺序进行。
10. 路由器 ≠ 思考者——负责分类、调度和监控。不要重复推理。
11. 遵循工具工作流——creative-thinking：发现→计划→执行。lotus-wisdom：从 tag: begin 开始。aot：使用 atomcommands 进行控制。
12. 跟踪 Token 用量——记录每次会话的大致 Token 数，以改进路由。