version: "1.0.0" name: parallel-research description: 对指定的多个代码库、文档或实现来源并行调研，并按来源保存可追溯的研究报告。

并行调研

围绕用户的研究问题，调查各来源自身的实现、取舍和适用条件。每个来源交付一份 Markdown 报告，供之后独立使用。

这个技能只做研究。workspace 是报告输出位置，不是隐含的目标项目；不检查它的业务代码来提出迁移方案，也不把来源中的做法直接写成某项目应采用的设计。

输入与输出

从请求和已有上下文确定研究问题、来源，以及输出位置。研究问题或来源存在会改变范围的歧义时再澄清；无需为命名参数单独中断研究。

用户指定的路径优先。否则以当前工作目录作为 workspace，按主题推导 research_ROI，按来源身份生成可区分的 source_slug，告知研究范围与输出目录。默认报告路径沿用：

{workspace}/.codex/{research_ROI}/research/{source_slug}.md

按来源研究

将可以独立调查的来源分别交给研究 subagent，并向用户说明各自负责什么。只有一个来源时可直接研究；并发受限时分批执行。

每个研究者收到：

• 自己负责的来源与本次研究问题。
• 必要的范围说明，例如版本、运行方式或要追踪的行为。
• 下述报告要求，尤其是关键证据、适用条件和未回答的问题。
• 自己拥有的精确报告路径；只写这份报告，不修改来源或其他报告。

研究应追踪与问题有关的实际行为。按问题需要检查入口、调用链、模块职责、关键数据、状态变化及错误行为，不逐项套用通用架构清单。阅读到一个接口声明或说明文字，不足以证明它在实际流程中的使用方式。

报告围绕问题组织，不要求固定章节。保留这些能够支持后续判断的信息：

• 调查范围：实际读取的来源、可得的版本信息或查阅日期。
• 对研究问题的直接回答，以及支撑回答的关键实现或文档位置。源码使用路径和符号或行号；文档使用链接和相关位置。
• 结论成立的条件、来源自身的取舍，以及会影响结论的已知限制。
• 实现事实、文档声称的行为与研究者推断之间的区别；没有执行的行为不能写成已验证。
• 尚未回答的问题及原因，例如来源未提供相关实现或访问受阻。

引用集中在关键结论附近，不必为每段背景说明附证据。来源中的经验可以归纳，但要保留其适用条件，避免泛化为所有项目都应采用的“最佳实践”。

收束

接收报告后，按本次研究问题判断回答是否充分、关键结论是否有依据；内容缺口交回对应研究者补充。报告文件或章节存在本身不代表问题已经回答。

交付所有报告的实际路径列表，简要指出主要发现，以及未完成的来源或问题。报告间有重要分歧时说明分歧和各自条件，留给后续设计判断；不在收尾时扩展成目标项目迁移设计。