用途:该技能用于对代码库做全面调研,回答“研究代码库”“X 是怎么工作的”“调查 Y”这类问题。其职责仅是如实记录和解释当前存在的代码,不主动提出改进、变更或未来增强建议,除非用户明确要求。
主要能力:先用主上下文完整读取用户直接提到的文件;再把研究目标拆解为可组合的调研领域,用 TodoWrite/write_todos 建立子任务计划;然后并行派出多个 Task 子智能体,先用 locator 智能体定位存在的内容,再用 analyzer 智能体分析最有价值的发现;等待全部子智能体完成后汇总结果,以实际代码库为主要事实来源,dev/log/ 仅作为历史背景补充。
产出与用法:生成元数据后写入 dev/research/YYYYMMDD-description.md,文件名中日期为当天,description 为 kebab-case 的简短主题,例如 20251010-parent-child-tracking.md、20260114-authentication-flow.md。文档以 YAML frontmatter 开头,含 date、topic、tags、status、last_updated 等字段,正文包含 Research Question、Summary、Detailed Findings、Code References、Architecture Insights、Historical Context、Related Research、Open Questions 等部分,引用需带具体文件路径与行号。后续追问会追加到同一文档,更新 last_updated、last_updated_by 并新增 Follow-up Research 小节。
适用场景:需要理解既有系统、定位组件交互、为开发提供技术地图的调研任务。
限制与注意事项:子智能体提示应具体且只做只读操作;必须等待全部子智能体完成再综合;必须先收集元数据再写文档,不得使用占位值;frontmatter 字段需保持一致,多词字段用 snake_case;不应只依赖已有调研文档,需重新调研实时代码库。