研究技能
高效调查技术问题,并将所学知识持久化,这样团队就无需再次研究同一主题。
1. 界定主题范围
从用户消息中提取(仅在确实不清楚时提问):
- 主题别名:短横线命名法的文件夹名称,例如
bluetooth-audio-routing - 技术栈:平台/语言/框架
- 症状:观察到的行为与预期行为
- 已知情况:已尝试过的假设
2. 准备工作区
运行 scripts/init-research.sh {topic-slug} 来创建文档文件夹。
3. 并行启动 3 个默认代理
每个代理获得一行角度描述以及共享上下文。当需要确切提示措辞时,请阅读 reference/agent-prompts.md。
- 代码库分析(探索代理)— 查找相关代码、差距、文件:行引用。
- 根本原因理论(网络代理)— 解释其在操作系统/框架/协议层面发生的原因。
- 解决方案与验证(网络代理)— 原生 API、库、社区确认的修复。
仅当用户明确要求库比较或跨平台 API 深入探究时,才启动可选的第四个/第五个代理。
4. 综合
精确创建以下两个文件:
docs/{topic}/NOTAS.md— 原始发现、代码片段、URL、快速观察。docs/{topic}/RESEARCH_CONSOLIDADO.md— 结构化的主文档。
仅在需要完整模板时使用 reference/consolidated-template.md。
仅在发现合理时创建可选的详细文件(例如 03_android_api.md、04_librerias.md 等)。
5. 最终化
运行 scripts/finalize-research.sh {topic-slug} 以验证主文档存在并附加一个迭代记录。然后向用户报告:
- 根本原因(如果适用,包含文件:行)
- 前 3 个非显而易见的发现
- 已创建的文件
- 建议的下一步
保持聊天报告简洁;详细信息存储在文档中。