用途:在不熟悉的子系统、接手他人工作,或用户要求“帮我定位/这里是什么情况”时,快速建立整体认知。单一视角只能看到局部,zoom-out 同时覆盖结构、知识与历史,避免画面被单一视角扭曲。
主要能力:先并行展开多个独立角度,每个角度只回答一个问题——结构(调用方、依赖、模块边界、入口点、行为实际所在位置);已记录知识(知识库、指南、参考文档中的架构、模式、综合研究);决策历史(为何形成现状、先前选择、被否决方案、发现的约束,无相关历史时可跳过);领域概念(知识库词汇页、项目指南、上下文文档中的术语)。每个探索需限定具体路径或主题目标,一次只覆盖一个角度,价值在于独立覆盖。
使用方式:若尚未加载 /qi-layer,先加载它。随后按上述角度分别探索,再综合成一张定位地图,而非四份拼接的堆砌。地图应包含:这是什么(用途与边界,两三句话);结构(重要模块与接口及其连接方式,若形态是空间性的可用 mermaid 图);为何如此(解释现状的决策与约束);词汇(精确讨论所需术语);未决线索(暴露的缺口、债务或未解决问题)。
限制与注意:当发现相互矛盾时,应解决矛盾而非并列列出——代码是事实基准,不一致的文档视为过时并注明。地图应保持紧凑,目标是让读者能够导航该区域,而不是一份详尽记录。资料未提供具体安装命令、收费或平台信息。