用途
该技能面向需要系统性调研与证据支撑的场景。当面临技术评估、方案对比、最佳实践调研,或出现“research”“evaluation”“comparison”类需求时使用。其目标是通过系统化调查、基于证据的分析,产出有权威依据的建议。
适用场景包括:技术评估与对比;文档检索与故障排查;最佳实践与行业标准调研;需要权威来源支撑的实施指引。不适用于:快速查询、广为人知的模式、没有调研阶段的时间紧迫调试。
主要能力与工作流程
技能采用五阶段系统化方法:
- 问题阶段:定义范围。明确要做的决策、评估参数(性能、可维护性、安全性、采用度)、约束条件(时间、专业能力、基础设施)。
- 发现阶段:多源检索。官方文档优先使用 context7,其次 octocode、firecrawl;故障排查优先 octocode issues、firecrawl 社区、context7 指南;代码示例优先 octocode 仓库、firecrawl 教程、context7 示例;技术评估可并行所有来源并交叉验证。
- 评估阶段:按标准分析。性能看基准、延迟、吞吐、内存;可维护性看代码复杂度、文档质量、社区活跃度;安全性看 CVE、审计、合规;采用度看下载量、生产使用、行业模式。
- 对比阶段:系统性权衡分析。对每个选项梳理优势、劣势、最佳适配、致命缺陷。
- 建议阶段:给出清晰指引与依据,包括主推荐、备选方案、实施步骤、局限说明。
技能使用三类 MCP 服务器:context7 适合官方文档与 API 参考(resolve-library-id、get-library-docs);octocode 适合代码示例与 issue(packageSearch、githubSearchCode、githubSearchIssues);firecrawl 适合教程与基准(search、scrape、map)。执行模式包括并行执行独立查询、按 context7 → octocode → firecrawl 顺序回退、以及从宽到窄的渐进式检索。
阶段跟踪
技能加载 maintain-tasks 技能进行阶段跟踪,阶段只前进不回退。触发关系为:会话开始进入“Analyze Request”;标准定义后进入“Discover Sources”;识别来源后进入“Gather Information”;信息收集后进入“Synthesize Findings”;综合完成后进入“Compile Report”。简单且明确的查询可直接跳到“Gather Information”;综合阶段出现缺口可新增“Gather Information”任务;提前终止时可带说明跳至“Compile Report”。
输出结构
调研结论有两种输出模式。评估模式包含:Finding(断言)、Source(权威来源与链接)、Confidence(高/中/低及理由)。发现模式包含:Found(发现了什么)、Source(来源与链接)、Notes(上下文或注意事项)。
报告结构包括:Research Summary(概述调研内容与来源)、Options Discovered(发现的选项)、Comparison Matrix(对比矩阵)、Recommendation(主推荐及理由、置信度、备选方案)、Implementation Guidance(后续步骤、常见陷阱、验证)、Sources(官方、基准、案例、社区)。
使用方式
综合阶段可加载 outfitter:report-findings 技能,用于来源权威性评估与置信度校准。该技能(research)覆盖使用 MCP 工具的完整调查流程;report-findings 覆盖综合、来源评估与呈现。
技能要求始终包含直接引用与链接、置信等级与局限、建议可能不适用的上下文;始终验证版本为最新稳定版、文档与用户上下文匹配、关键信息交叉引用、代码示例完整可运行;主动提示弃用方案及其现代替代、缺失前提、常见陷阱、生态内相关工具。禁止跳过“Analyze Request”而未定义范围、在多源可用时使用单源、在无引用下交付建议、不标注弃用方案、遗漏局限与边界情况。
限制与暂未提供
该资料未提供具体收费、价格、平台要求或性能效果数据,暂未提供。相关细化内容还包括 source-hierarchy.md(权威评估细节)、tool-selection.md(MCP 服务器决策矩阵)、discovery-patterns.md(详细调研工作流)。