| name | 507-research |
| description | 通用外部证据入口。研究外部项目、文章、文档、标准、竞品或当前事实，区分已核实事实、来源观点、本项目推断与未知，产出可追溯的 evidence handoff（证据交接）。可独立回答，也可把证据交给 explain、explore、mine、grill、PRD 或 issue；不挖碎片、不替用户做取舍、不直接实施。Use when user mentions 查一下, 搜一下, 帮我查, 调研一下, 研究一下, 调查一下, 查证, 核实, 搜资料, 找资料, 看看这个项目, 看看这篇文章, 外部证据, 竞品, 参考实现, benchmark, research, investigate, verify sources. |
外部调研（research）
把一个外部问题或参照物研究清楚，产出可被下一步直接消费的可靠证据。
507-research 是 common/（横向层）的外部证据入口，不只服务代码，也服务概念解释、项目探索、写作挖掘与方案决策。它回答的是：
外部世界目前能确认什么，证据在哪里，还有什么不能确认？
输入
- 一个待核实的问题、对象或主张；
- 证据将服务的当前目标，例如理解概念、评估项目、形成碎片或支持决策；
- 用户限定的来源、时间或范围（若有）。
没有明确当前项目时也能独立调研；需要判断“对本项目能借什么”时，再读取项目 AGENTS.md、doc/ 与相关权威说明。
覆盖什么
- 外部项目、源码、官方文档、文章、论文、标准、竞品和参考实现；
- 时效性事实、机制核实、多个方案对照与反例；
- 对当前项目的借鉴判断；
- 为后续 skill 提供结构化的
evidence handoff（证据交接）。
不覆盖什么
- 把材料变成写作碎片或观点 →
507-mine；
- 把用户不理解的概念讲懂 →
507-explain；
- 探索项目内部已知、未知和当前可推进边界 →
507-explore；
- 替用户决定产品意图或风险取舍 →
507-grill；
- 直接写规格、工单、正文或实现。
核心纪律
- 先定义证据问题：明确要核实的主张及证据将支持什么，不为“资料更多”无限扩搜。
- 一手来源优先：机制事实优先官方文档、源码、原始论文、标准、原始数据、作者说明或权威记录；二手来源用于发现线索和补充语境。
- 分开事实与判断：明确区分已核实事实、来源观点、本项目推断和仍未知事项。
- 深度与风险相称：简单事实用足够的一手证据即可；会影响路线、架构、产品或公开结论时，再扩大到多个同类样本、替代方案和反例。不要机械要求每次都“3+1”。
- 冲突证据不抹平：来源相互矛盾时写明分歧、时间与适用范围，降低置信度；不能确认就保留未知。
- 默认轻产物：通常在对话中交付证据包。只有用户要求、项目规则规定，或结论需要长期复用时，才写入项目既有参考目录；不为一次调研新建文档体系。
工作流程
- 锁定证据问题、使用场景和范围；能从上下文确定时不反问。
- 先读指定对象及其一手来源；技术问题优先官方文档与源码。
- 按结论风险补充同类样本、替代解释、反例或时效核验。
- 交叉核对来源，标记时间、适用范围、冲突和证据缺口。
- 输出证据交接，并根据当前目标选择下一步。
证据交接
按复杂度裁剪，最小结构是：
## 结论
<当前证据支持的最短结论>
## 已核实事实
- <事实> — <一手来源>
## 推断与适用边界
- <从证据得到的推断，以及它只在什么条件下成立>
## 反例 / 替代解释
- <确有必要时列出>
## 未知与置信限制
- <仍无法确认的部分>
## 对当前目标的意义
- <下一步可直接消费的证据或约束>
若任务是“对当前项目有什么借鉴”，再把机制分成：设计冲突、同思路、候选；候选必须指出受影响的项目能力或决策，不停在“这个思路很好”。
完成与接力
- 完成信号：目标主张已有可追溯证据，事实、推断与未知已分开，证据深度与决策风险相称。
- 产物：对话中的证据交接；必要时是项目既有参考目录中的耐久文档。
- 候选出口：需要讲懂时进入
507-explain；需要重新计算项目未知时返回 507-explore；需要形成写作碎片时进入 507-mine；需要用户取舍时进入 507-grill；前提已经充分时进入 507-prd、507-issue、写作或实施；只需答案时直接结束。
- 回退条件：关键事实仍无法核实时，保留未知或降低置信度，不把猜测交给下游当结论。
红线
- 不把搜索结果摘要冒充事实核验；
- 不用二手解读覆盖一手来源；
- 不把当前项目推断写成外部对象的客观事实；
- 不为了形式完整强制落文档或堆来源；
- 不挖碎片、不替用户做决策、不顺手实施。
