用途:处理 blueprint 工作流的研究阶段,包括工具箱(Toolbox)解析、经验(lessons)发现、本地/外部研究决策以及规格(spec)审查。
主要能力:1)并行读取配置并启动 toolbox-resolver 与 lessons-discoverer 代理,产出 research_hooks、coding_styles、lessons_context;2)始终运行本地研究,调用 git-researcher 与 repo-analyst 代理,收集代码库模式、约定与相似实现;3)依据 topic_risk、user_familiarity、uncertainty_level、user_intent 及本地发现,决定 SKIP_EXTERNAL 或 RUN_EXTERNAL;4)外部研究为条件执行,调用 docs-researcher、best-practices-researcher 及工具箱中匹配的栈特定代理,最多 4 个外部代理;5)并行执行 spec-reviewer 技能与 coding_styles 技能注入。
使用方式:作为 blueprint 工作流的一个阶段被调用,输入 feature_description、tech_stack 与 discovery_result(含 user_familiarity、user_intent、topic_risk、uncertainty_level)。配置读取使用 config_read("tech_stack", "generic") 与 config_read("lessons_path", ".agents/lessons/")。
输出:research_result,包含 toolbox、lessons_context、research_decision 及原因、research_findings(local 与 external)、spec_findings(gaps、edge_cases、questions)、skill_content 与 ready_for_architecture。
限制:工具箱缺失、经验目录缺失、发现返回 0 条或失败均为非阻塞错误,记录后继续;外部研究仅在决策为 RUN_EXTERNAL 时运行,否则 external 为 null。具体安装命令与收费信息暂未提供。