用途:在开始实现前,尤其是面对不熟悉的代码库、集成不完全理解的系统、高风险或复杂任务、或预感存在隐藏陷阱时,先做一次盲点排查,识别可能影响实现或导致架构决策失误的未知未知项。
主要能力:按步骤定义范围、搜索上下文、识别陷阱、提出关键问题并输出结构化报告。搜索上下文时使用 git 历史、代码注释、错误处理模式等,例如: git log --oneline --all -20 -- path/to/module/ git log --all --grep="auth|oauth|provider" --oneline rg -i "TODO|FIXME|HACK|XXX" path/to/module/ rg "catch|throw|error" path/to/module/ -A 3
识别陷阱分为技术、架构、业务三类:技术如边界情况、性能、错误处理、测试要求;架构如现有抽象、集成点、数据流、状态管理;业务如隐含需求、功能开关、向后兼容、安全合规。随后生成可能改变方案的问题,并输出包含已检查来源、关键发现、待确认问题和推荐做法的报告。
使用方式:先明确任务范围与当前理解程度,再广泛搜索 git 历史、代码、注释、测试和文档,寻找以往类似工作的模式,定位错误处理与 TODO/FIXME,提出聚焦架构决策的问题,最后综合成可执行建议。
适用场景:新增支付集成、认证改造等跨领域改动前的调研。
限制:资料未提供具体安装命令、平台支持、收费信息或效果保证;成功标准强调只报告有证据支持的陷阱,零发现也是有效结果,问题仅在答案可能改变方案时提出,并记录每个发现的后续结果。