Research 是一个面向技术决策的调研技能,核心目标是在做出实质性技术改动之前,先把问题调查清楚。
用途 该技能适用于需要调查代码库、比较工具或方案、核实当前外部或库事实,以及在动手前研究失败原因的场景。它把调研本身视为一个独立环节,帮助使用者在决策前建立足够的证据基础。
主要能力
- 从问题出发推导调研范围:以决策目标、相关范围、已确定的约束和所需的新鲜度作为起点,并优先复用已有答案。
- 覆盖度推导:在评估选项之前,先从问题和权威来源推导出相关问题;用户指定的工具和问题只是最低要求,而非全部调查内容。
- 多源证据:本地行为以仓库源码为依据;外部契约以官方文档、源码和变更日志为依据;发现问题和实际反例可参考 issue、Reddit 及其他社区报告。
- 独立性:既按问题搜索,也按指定方案搜索;检查可信的替代方案,以及可能改变决策的反面证据。
- 主张分级:区分已记录能力、本地观察行为、推断和未知;缺少证据并不等于能力不存在。
- 比例原则:只调查可能改变答案的内容,不设固定搜索配额,不强制产出报告,也不做无关审计。
- 范围控制:复用现有任务授权;调研本身不增加安装、实现或外部写入的权限。当某个来源不可用时,继续开展有用的独立调查。
使用方式 技能提供若干调研路径,按问题类型选择对应参考:
- 仓库行为或影响:走代码库路径(references/codebase.md)。
- 选项、重叠或充分性:走比较路径(references/comparison.md)。
- 当前外部主张:走外部证据路径(references/external.md)。
- 库或 API 契约:走库与 API 路径(references/library-api.md)。
- 失败或补救:走故障排查路径(references/troubleshooting.md)。 只阅读与任务问题相关的参考,跳过无关路径。
完成标准 在得出结论前,重新审视原始问题和推导出的覆盖范围:每个重要事项都应有证据、不适用理由,或明确的未知及其后果。按来源权威性、版本和适用性解决实质性矛盾;未解决的争议应保持可见。只能在所述范围内声称证据充分,并指出剩余的重要缺口及其可接受原因或阻碍建议的原因。当继续调查不太可能改变决策,或缺失证据与下一步有用检查已明确时停止,不承诺穷尽式确定性。
输出与记录 回答时先给出答案,在主张旁标注决定性来源,并解释权衡与局限。必要时可使用紧凑的比较表,但不强制固定报告结构。被要求时,将已接受的决策记录到现有决策文件中;保持提案与未知分离;仅在要求或后续工作需要时创建可复用笔记。
适用场景与限制 该技能适合技术选型、方案对比、外部事实核实和故障排查等需要证据支撑的决策场景。其限制在于:调研本身不授予安装、实现或外部写入权限;不保证穷尽式确定性;缺少证据不能推断能力不存在;具体参考文件内容、安装方式、收费与价格、平台支持等信息在现有资料中暂未提供。