SuperAPI AI 工具集

intuition-pumps

通用与其它

查看项目

更新于 10-15 15:16

技能介绍

Intuition Pumps 是一个围绕丹尼特式“直觉泵”(intuition pumps)与思维工具构建的技能,面向难题求解、推理卡壳、论证构建等场景。其核心是一个渐进式披露的路由器,覆盖 77 张独立的直觉泵工具卡:用户先通过结构化索引找到合适的工具,然后只加载被选中的那一张卡片,而不是一次性载入全部内容。

主要能力与机制

该技能以 references/tool-index.json 作为路由索引,以 references/tools/ 下的单张工具卡(NNN-*.md)作为实际内容单元。每张工具卡被视为独立的维护单元与验收目标。技能设有状态守卫:在路由、应用或教学某个工具之前,会检查索引文件是否存在;在应用或教学某个被选中的工具之前,还会检查对应的工具卡是否存在。若索引缺失,会说明技能已安装但路由不可用;若选中的卡片缺失或不完整,会按 id 与标题报告被阻塞的工具卡,且不会凭记忆编造缺失卡片,也不会批量创建缺失卡片。

参考加载规则

在点名调用时,以及用户从路由菜单中选定某个工具后,只读取 references/tools/ 下对应的单张工具卡。路由菜单本身是刻意的例外:它必须逐张读取五张候选卡片,以便在请用户选择前解释它们的名称。技能明确要求不加载全部工具卡,不凭索引单独合成卡片,也不在正常使用请求中补全缺失卡片。

工具身份披露

任何对用户可见的工具,在被应用、推荐为下一步或作为相邻选项提供之前,都必须先加以解释。命令名本身并不自解释,因此不能只输出一个带功能理由的裸命令。对每个可见工具,需读取其卡片中的“身份”“名称与思想实验”“原书机制转译”部分,并给出一个紧凑的身份块,包含:工具命令与卡片标题;原书标题(若卡片提供英文原名则一并保留);书中名字的背景(原书里的具体故事、思想实验、比喻或术语画面);名字为何与该工具动作匹配(从书中画面到技能操作的对应关系);以及这次工具实际要做什么、为何适合当前问题。“名称与思想实验”不能被一句用途副标题替代,至少要让人明白名字指的画面、画面暴露的思考陷阱,以及使用者要对哪个变量、命题或机制动手。路由菜单因同时显示五个工具,必须逐张独立读取这五张候选卡片后再输出,每张卡说明可控制在 2-4 句,但不能省略名字背景。点名调用、进度模式和相邻推荐使用完整身份块;智能体自救仅在需要向用户披露所用工具时使用轻量身份块。

书籍上下文参考

仅当用户询问原书结构、需要书籍级分类或维护工具卡时,才读取 references/book-structure.md;仅当评估是否在 77 张编号卡片之外新增工具时,才读取 references/appendix-pump-candidates.md。原书的八个部分作为次级分类层,路由仍使用 tool-index.json、taxonomy.md 和当前问题形态。未经单独议题且缺乏足够源材料形成完整卡片时,不得将附录候选提升为活跃工具。

入口模式

点名调用:当用户以短命令、编号、完整标题或别名指定工具时,在索引中查找该工具,只读取匹配的单张卡片,先给出身份块,再将其应用于当前问题;仅当相邻工具会实质性改变下一步时推荐,且不超过两个,并以同样的紧凑身份块解释每个可见的相邻工具。

学习模式:当用户要求学习、理解、练习或教授某个具名工具(包括“学习 /工具名”这类提示)时,在索引中查找并只读取匹配的单张卡片,按“工具身份(原书标题/英文原名、名字背景、名称与动作的对应关系)、名称与思想实验、工具机制、适用场景、操作方法、练习、误用检查”的结构讲解;除非用户明确要求应用,否则不将其套用到用户的实时问题上。若用户想为当前问题学习工具但未指定,则先运行路由菜单,再只教授所选工具。

路由菜单:当用户因不知道用哪个工具而请求推荐时,读取索引,对当前问题类型分类,选出恰好五个候选,然后逐张独立读取这五张匹配卡片,按“1 个建议先用 + 4 个可选探索”推荐,使用 references/routing-review.md 中定义的五个槽位,为每个候选给出身份块、理由和明确的不适用边界,然后停下等待用户选择,除非用户要求进度模式。若所选卡片尚不存在,菜单仍可从索引推荐候选,但必须披露在对应卡片议题实现前应用会被阻塞。

进度模式:当用户说“我卡住了”“帮我想想”“直接处理”或类似表达时,生成同样的五候选路由菜单,必要时再次读取“建议先用”的卡片以获取应用上下文,在应用前展示其身份块,只应用这一个工具,并保留其余四个已解释候选作为切换路径。若“建议先用”卡片缺失,不得编造,报告被阻塞的卡片议题并在推荐菜单后停止。

智能体自救:仅在智能体出现明确卡壳信号时使用,例如反复尝试没有新证据、概念边界不稳定、解释中存在魔法步骤、推理路径循环无进展、提出的区分不断崩塌。不得仅因任务复杂就触发自救。其行为是路由到一个合适的工具,只读取该工具卡,轻量应用,并且仅当它改变推理路径、置信度、权衡或下一步行动时才披露该工具,披露时给出紧凑身份块而非仅命令名。完整自救规则见 references/self-rescue.md。

不可协商事项

不注册 77 个 UI 原生斜杠命令;不把 77 张工具卡放进 SKILL.md;不批量生成工具卡;不把模板填充的卡片视为完整;每张工具卡都作为独立的维护单元与验收目标。

推荐记录

仅当用户要求记录、复盘或沉淀时,才记录推荐元数据,使用 references/usage-log-template.md,不记录私密思维链或完整推理轨迹;若写日志文件不合适,则输出一个紧凑的记录块。

适用场景与限制

该技能适用于需要借助结构化思维工具处理难题、推理卡壳、论证构建、概念澄清等场景,尤其适合希望按需加载、避免上下文过载的使用方式。其限制在于:路由依赖索引与卡片文件的存在,缺失时只能报告阻塞而不能编造;不提供批量生成或补全卡片的能力;工具卡内容需以实际文件为准,本介绍未提供具体 77 张卡片的清单与细节。