用途:在规划或编辑任何内容前,先为陌生代码库、项目或研究领域建立一份经过核实的侦察报告,区分已验证事实与假设,并以一段诊断收尾。
主要能力与引导顺序:先运行 date 并列出目录树(源码目录、配置、文档),记录最大文件及行数;再读意图文档(AGENTS.md/CLAUDE.md、README、.context/ 下的 plan.md、research.md、decisions/、设计文档);然后读入口点、主循环或路由表及一两个核心类型;接着看历史(git log --oneline -20、gh issue list、gh pr list);再确认实际运行状态(进程、docker ps -a、磁盘数据目录、已部署端点、cron);随后针对触发本次引导的具体问题直接 grep 源码并检查实时状态;最后对已安装版本的第三方接口做一次低成本自省命令,把训练知识当作假设。
使用方式:按上述顺序执行,全程只读,不修改任何内容;发现 bug 记录到报告或提 issue。在共享或远程机器上只运行只读命令(如 hostname、资源列表),不得更改驱动、缓存或系统状态。
委派探索:当存在两个以上独立领域时,按架构域(后端/CLI/Web/数据/基础设施)划分,文件所有权互不重叠,每个域一个只读探索者并行启动;机械映射可委派,判断性文档自行阅读;探索者提示需含可证伪的编号问题、明确只读指令和输出契约(file:line 引用、结论导向、不倾倒文件);探索者结论成为标题性主张或计划前提前,须自行复核最关键事实。
研究领域引导:先自行做广泛检索并保存原始语料,再按主题族委派总结者;优先一手来源;将发现记入 research/<family>.md,综合成一份综述,并以 ADR 记录决策。
输出契约:报告含诊断、架构地图、观察到的约定、实际运行内容、已验证事实与假设、建议的下一步。
限制:引导期间禁止编辑;不因含糊或错别字多的需求停滞,用一句话说明理解并给出纠正机会后即开始。