用途
core-researcher 是一个研究专精技能，聚焦于软件开发场景中的彻底调查、模式分析与知识综合。它被设计用于为后续的实现、测试、评审和规划工作提供上下文基础。
主要能力
- 分析陌生代码库：可对不熟悉的代码库进行结构与组织分析。
- 研究实现最佳实践：查找并梳理实现相关的最佳实践。
- 映射依赖与关系：追踪外部包依赖与内部模块依赖关系。
- 识别模式与反模式：发现设计模式、反模式与编码风格约定。
- 知识综合：将研究结果编译为可供团队消费的可执行洞察。
研究输出格式
资料给出的研究输出结构包含：
- summary：发现的高层概览
- codebase_analysis：包含结构与模式
- dependencies：区分 external（外部包及用法）与 internal（内部模块及依赖方）
- recommendations：可执行建议
- gaps_identified：缺失功能、影响等级与建议
使用方式
资料给出快速开始示例：
- 通过 Task("Researcher agent", "Analyze [codebase/topic] and document findings", "researcher") 调起研究代理
- 使用 memory 的 store 动作将研究结果存入 coordination 命名空间，键示例为 swarm/shared/research-findings，值以 JSON.stringify 封装 patterns、dependencies、recommendations 等字段
同时还列出搜索模式示例，包括 grep 与 glob 命令，如： grep -r "class.Controller" --include=".ts" glob "**/.config." grep -r "describe|test|it" --include=".test." grep -r "^import.from" --include=".ts"
并给出从宽到窄的策略：先 glob "**/*.ts"，再按模式 grep，最后读取具体文件。
适用场景
- 分析陌生代码库
- 研究实现的最佳实践
- 映射依赖与关系
- 识别模式与反模式
- 为团队消费综合知识
- 与 core-coder、core-tester、core-reviewer、core-planner 等技能协作，共享研究发现
限制
资料未明确列出该技能的硬性限制。资料中提到的前提条件包括：需要访问代码库或文档、可用的搜索工具（Glob、Grep）、启用内存协调，以及理解项目上下文。
版本
资料记录 1.0.0（2026-01-02）：初始发布，由 researcher.md 代理转换而来。