SuperAPI AI 工具集

map-out

通用与其它

查看项目

更新于 10-16 07:12

技能介绍

用途

map-out 用于定位一个主题所处的位置,以及应当在哪个层级上行动。它通过沿四条轴移动来实现这一点:部分与整体、目的与手段、种类与个案,以及同一层级上的同类项。

主要能力

该技能围绕一组思维动作展开,包括:

  • select-level:选择层级
  • situate:定位目的
  • decompose:分解
  • compose:组合
  • instantiate:实例化
  • generalize:泛化
  • survey-peers:考察同类项

使用方式

流程分为三个阶段。

阶段 0:评估

从请求和对话中读出思考所缺乏的内容,并以匹配的动作开场。当多行都符合时,取最上面的一行。进行时不宣布所选项。

判断依据包括:缺乏层级(在时间压力下,淹没于细节或过于抽象而无法行动)时以 select-level 开场;缺乏目的(没人能说清它是为了什么或为何重要)时以 situate 开场;缺乏部分(被当作一个整体处理)时以 decompose 开场;缺乏整体(手中只有碎片,不知道它们合起来是什么)时以 compose 开场;缺乏依据(一个主张、原则或计划没有具体个案)时以 instantiate 开场;缺乏迁移(看起来是新的,已知的都不适用)时以 generalize 开场;缺乏备选(在这一层级只看到一个选项)时以 survey-peers 开场。

阶段 1:动作

从 references/ 读取该动作的文件,针对主题回答其编号问题,并将每个动作的输出带入下一个动作。

阶段 2:定位与扩展

每个动作之后,说明主题在该动作触及的每条轴上现在所处的位置:它所属的整体、它服务的目的、它所属的类别、它旁边的同类项。当一个动作同时移动了两条轴时,说明是哪两条。

然后检查到目前为止产生的所有内容,并在某行触发时进行扩展。当多行触发时,取最上面的一行。扩展条件包括:两个动作在哪个层级重要上存在分歧时用 select-level;某个部分或机制的目的无人说明时用 situate;命名了一个整体却从未切分为部分时用 decompose;命名了部分却未说明它们合起来是什么时用 compose;一个主张或原则没有具体个案时用 instantiate;一个个案没有命名类别时用 generalize;在一个层级上只有一个选项而其他选项可能存在时用 survey-peers。

引用以扩展。只有引用触发它的句子,才算该行触发。

在不动点停止。当最后一个动作没有添加任何可引用为新内容的东西时,收敛,即使某行触发。

上限为五。一次运行最多包含五个动作。

以流畅的散文写作,展示推理形成的过程:每个动作发现了什么,以及为何引向下一步。动作名称和表格标签不出现在输出中。将每个主张与主题材料挂钩,或标记为假设。

阶段 3:收敛

以以下内容收尾:主题所处的位置(它所属的整体、它服务的目的、它所属的类别、它最近的同类项);应当行动的层级,以及在那里行动使什么成为可能;每个动作在画面中改变了什么;什么仍然悬而未决。

上下文加载

评估阶段不从 references 加载任何内容;动作、定位与扩展阶段只加载当前动作的文件;收敛阶段加载 assets/playback.md。

记录

记录存放在存储中,路径为 ${CLAUDE_PLUGIN_DATA}/records/,并在镜像文件夹 ${user_config.records_mirror} 中保留一份副本。

当存储路径不是绝对路径时,此处不存在存储。仍然构建记录,并在回复末尾以 jsonl 块的形式、以其文件名呈现,供用户保存。

当镜像路径为空或仍是占位符时,跳过镜像。否则,在运行的最后一一行之后,将记录文件以相同名称复制到镜像中。

任一文件夹缺失时创建它。

每条记录按本节末尾模板的形式写入:所示文件名,然后每行一个 JSON 对象,每个事件一行,按事件发生的顺序,替换每个方括号中的值。运行产生某种 kind 就写该 kind,未产生的 kind 省略。时间取自 UTC 时钟,例如文件名用 date -u +%Y%m%dT%H%M%SZ。topic 为两到六个小写单词,用连字符连接。answer 的 q 命名它所回答的问题或未决项。

追加行;绝不更改或删除一行。

当多行共享同一 id 时,最新的胜出。链接的 id 是其 from、to 和 rel。"retired": true 移除该条目。

要恢复一次运行,读取其文件,当只有镜像持有它时先从镜像复制,然后追加一行带 "resumed": true 的 run 行。

回答记录问题的智能体将其 answer、skip 和 open 行追加到同一文件,并在 by 中署名。

在一次运行结束时,以 assets/playback.md 的形式回放记录:保存到的路径,然后是回复尚未展示的每个部分。绝不展示原始行。

记录主题;每个动作之后的位置作为 note,其中不含动作名称;每个收尾项作为 result;每件悬而未决的事作为 open 行。

文件名格式:map-out_[开始时间, UTC, YYYYMMDDTHHMMSSZ]_[topic].jsonl

记录行格式包括 run、note、result、open 四种 kind,各自带有 at 时间戳及相应字段。

适用场景

适用于需要厘清一个主题在整体、目的、类别和同类项中的位置,并决定在哪个层级采取行动的思考任务。

限制

一次运行最多包含五个动作。当最后一个动作没有添加可引用为新内容时即收敛。存储与镜像路径的可用性会影响记录是写入文件还是仅在回复中呈现。