Fable Discover 是一个面向代码仓库调查的技能,目标是在任何人确定设计或动手编辑之前,先建立对陌生代码路径的最小可靠认知模型。它把“发现”定义为减少不确定性,而非大量阅读文件:调查应让下一位接手者拥有足够证据做决策,不必重新摸索仓库,同时在探索变成无目的的考古之前停下。
适用场景包括:入口点、归属或执行流程未知;请求涉及不熟悉的包或子系统;生成代码、插件、运行时配置、队列、任务或依赖注入可能改变真实执行路径;用户只描述行为而不清楚实现位置;此前对仓库的假设被证据推翻。已在目标文件内明确边界编辑、仅做外部 API/版本调研、或仅运行现有检查时,不应启用本技能。
使用方式分阶段进行。先框定 2 至 7 个会实质改变计划的未知问题,并标记哪些是关键问题;再读项目说明与清单文件,确定工作区/包根、构建测试命令、生成目录、宿主与插件清单、源码与分发入口、配置来源和归属边界;接着从可观测入口沿具体符号或事件追踪到目标行为,逐跳记录文件/符号、可达理由、输入输出契约、副作用与确定程度;静态证据不足时才做安全的只读运行时观察;证据与现有模型矛盾时立即更新模型;当每个关键问题都有证据结论或明确未解决并说明后果时停止。
技能给出若干决策规则:外部时效性问题转交研究类技能,编辑范围已明确则转交执行类技能,多组件协调转交规划类技能;发现生成代码时先找生成器或事实来源;导入链消失时检查注册表、事件总线、依赖注入、插件发现、反射、代码生成与运行时配置;测试与运行时不一致时记录两条路径。不变式包括默认只读、关键结论必须有具体证据、推断须标注、生成产物未经证明不得当作权威来源。
技能还列出失败类型(搜索遗漏、假路径、环境歧义、源码与构建产物不一致、关键未知悬而未决)与反模式(为上下文通读整个包、以文件名当架构、以 grep 频率当重要性、仅凭导入链断定执行、忽视构建与插件注册、给假设不加标注、计划已足够安全仍继续调查)。最终产出包含目标、关键问题、实测事实、执行路径、配置运行时说明、生成/插件边界、未解决问题及后果、建议下一技能的紧凑证据包。