SuperAPI AI 工具集

thinking-map-territory

通用与其它

查看项目

更新于 10-15 18:10

技能介绍

Map Territory 是一个用于处理“地图”与“实地”冲突的思维技能。文档、测试、图表、指标、注释和心智模型都是地图;运行中的代码和实际数据才是实地。当二者不一致时,应验证实地并更新模型,绝不要强迫现实去匹配描述。

用途

当观察到的行为与文档、测试期望、图表、注释、仪表盘或先前假设矛盾时使用。当关于系统的主张依赖二手来源而非当前代码或数据时使用。当测试通过但生产或手动行为错误时使用。当你准备在检查实际发生什么之前先推理原因时使用。当决策依赖模型、模式或指标是否仍然最新时使用。

主要能力

该技能提供一套结构化的核对流程,帮助区分“地图”与“实地”,避免仅凭文档或假设进行推理。流程包括:命名地图,即说明所信任的具体表示,引用原始主张而非转述;命名实地检查,即指定能证实或证伪该主张的观察,如代码路径、运行时值、查询、复现、近期变更或实时指标;验证来源与新鲜度,确认地图的作者、生成器、最后更新时间,以及它是否可能相对于部署、配置或数据变更而过时,优先使用当前一手来源而非摘要;观察实地,读取真实代码路径、运行或插桩、查询真实数据或复现行为,不要仅凭签名或名称预测;记录差异并更新,如果实地与地图矛盾,对于已发布行为以实地为准,记录差距、修订模型,然后决定修复代码、地图还是两者,并记录未被地图覆盖的路径,这些可能是下一个故障点;在问题解决后停止,一旦主张被具体观察确认或推翻,就停止重复检查同一路径。

使用方式

该技能以流程和输出模板的形式使用。输出包含以下字段:Map(主张、来源、新鲜度)、Territory check(检查、运行或查询了什么)、Observation(具体结果,而非解释)、Delta(一致、地图错误或实地不完整)、Updated model(修正后的理解)、Action(修复代码、更新地图或无决策影响)、Uncovered(没有地图覆盖的路径)。验证时,如果仅从地图推理而没有实地观察、信任过时的二手来源,或强迫代码匹配错误文档而不检查任何一方,则应判定为失败。当矛盾已解决或与决策无关时停止。过度应用防护:在编辑地图、地图是生成式真相来源,或差距无法改变下一步行动时,不要重新验证整个系统。

适用场景

适用于观察行为与文档、测试期望、图表、注释、仪表盘或先前假设矛盾;关于系统的主张依赖二手来源而非当前代码或数据;测试通过但生产或手动行为错误;准备在检查实际发生前先推理原因;决策依赖模型、模式或指标是否仍然最新等场景。

限制

不适用于以下情况:地图正是被要求编辑的产物(文档、图表、规格),该产物就是任务实地;同一路径本次会话已经验证过,应复用该观察;地图是权威且生成式的(代码生成类型、派生模式)且没有声称漂移;差异无法改变决策,记录后继续即可;在确认实地后需要比较竞争性因果假设,应切换到科学方法;安全漏洞构造应使用红队方法,本技能只解决模型与观察之间的冲突。