mcpField
R
research-methodology

research-methodology

github.com/magnus919生产力16170 次安装1 天前更新
代码仓库

关于 research-methodology

research-methodology 是为子 Agent 设计的研究流程技能,适用于新闻调查、行业分析和学术或综合研究。它以共用研究生命周期为基础,并强调来源评估、证据留存和可恢复的研究执行。

主要功能

  1. 01提供三类研究流程
  2. 02覆盖范围界定至报告的完整生命周期
  3. 03评估来源并分析证据
  4. 04保存可追溯的研究材料与来源关系
  5. 05处理超时并从检查点恢复
  6. 06提供研究简报、日志和媒体证据模板

适用场景

  1. 01开展基于一手来源的调查报道
  2. 02分析行业信号与市场策略
  3. 03进行系统性学术或综合研究
  4. 04验证技术或媒体相关主张

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/magnus919/agent-skills --skill research-methodology

安装后在 Claude Code 中输入/research-methodology确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
assets/
media-claim-ledger.md
research-brief.md
research-log.md
evals/
evals.json
references/
industry-analysis.md
journalistic-research.md
media-evidence-routing.md
research-lifecycle.md
source-evaluation.md
source-index.md
structured-analytic-techniques.md
synthesis-patterns.md
technical-verification.md

详细介绍

研究方法

面向子 Agent 的专业研究流程。根据研究类型分为三个方向:

  • 新闻调查 — 调查报道、一手来源研究、以大量来源为基础的叙事工作
  • 行业分析 — 市场研究与战略、信号检测
  • 学术/综合研究 — 在深度最为重要时开展的深入系统研究

三者遵循相同的生命周期(界定范围 → 收集 → 评估 → 分析 → 综合 → 报告),但在证据标准、速度和输出格式方面有所不同。

媒体证据是一种技术验证扩展,不是第四个操作方向。本技能负责研究范围、来源评估、主张核实、抽样完整性审计、排除项和持久化保存。ffmpeg 技能负责 FFmpeg 命令、媒体探查、提取、编辑、渲染和目标验证;语义/编辑观察及审批由人工或具备相应能力的审核者负责。只要研究结论依赖媒体工具、采样帧/音频/转录内容或编辑判断,就应加载 references/media-evidence-routing.md。

不适用场景

以下情况不要加载此技能:

  • 只需查询单个事实或快速作答 — 直接回复即可;完整的研究流程只会增加成本,不会提高可信度。
  • 无需调查的直接实现工作 — 直接构建并验证更改(backend-engineering、frontend-engineering)。
  • 操作特定的检索或采集工具 — 加载该工具的技能,以获取运行手册级别的配置和诊断信息。
  • 只需原样采集网页内容,无需评估或综合 — 采集工具自身的技能涵盖内容获取;本技能从来源评估开始。
  • 将已收集的发现整理成持久化摘要、分析文件和证据档案 — 使用 artifact-pyramids 规划输出架构。
  • 在反复进行研究到笔记的流程中,将采集的来源持久保存为笔记 — 使用 research-and-vault。

研究生命周期

SCOPE → GATHER → EVALUATE → ANALYZE → SYNTHESIZE → REPORT

持久化产物检查关口

Agent 给出看似合理的答案,并不意味着研究已经完成。只有在适合宿主系统及其用户的持久化格式中,保存了可复用的证据和推理过程,研究才算完成。

报告前,明确记录保存决策:

  1. 确定持久化保存位置。 使用宿主系统中常规的长期研究载体:关联的知识记录、纳入版本管理的报告包、研究数据库、项目文档或其他用户可见的产物。不要将唯一有用的输出留在聊天、临时工作区或未纳入版本管理的草稿文件中。
  2. 按来源的自然粒度提取。 记录每项会实质性影响未来推理、且彼此独立并可复用的主张、数据点、方法、矛盾和待解问题。不要用固定的原子条目数、发现数量或笔记数量作为停止标准。持续提取,直到提取日志中已记录每个保留来源的处理情况。
  3. 保留来源信息和关联关系。 每项持久化产物都必须保留来源 URL 或引文、访问日期、证据强度,以及指向研究问题、相关产物和依赖该来源的综合分析的链接。
  4. 将提取与综合分开。 简报或报告负责解释结论,不能取代底层证据记录。先保存来源级记录和可复用主张,再将其精简为综合分析。
  5. 记录未予保存的内容。 如果某个来源被拒绝、证据过弱、无法访问、内容重复或超出范围,应在研究日志中记录此决定。后续研究者必须能区分有意排除的来源和被遗漏的来源。

具体的产物形式取决于环境。不要预设特定的数据库、笔记应用或编排系统。始终应确保研究内容持久保存、便于浏览、与证据关联,并能让后续用户或 Agent 找到并继续使用。

中断与超时恢复

研究工作者超时属于中断,而非研究结果。绝不要因此结束调查、将其概括为已完成,或仅因委派的工作者超出执行上限就推断没有有用成果。长期研究任务常会遇到提取缓慢、速率限制,或某个来源无响应的情况,即使此前已经产出了有价值的阶段性成果。应将长期研究规划为有界、可恢复的子任务:采用适合任务的执行时限,增量写入检查点,并从最近一个已验证的检查点继续,而不是设置任意的短时限,或假设可以使用无界执行时限。

工作者超时时:

  1. 在决定哪些内容丢失前,阅读完整的委派记录,并检查工作区或临时目录。
  2. 恢复并验证已写入的所有阶段性产物、来源日志和提取出的论点。
  3. 从最后一个持久检查点继续,而不是重新进行广泛探索。
  4. 缩小范围或替换耗时操作,尤其是大型 PDF 提取或重复遭遇速率限制的搜索,并增量写入后续各阶段的内容。
  5. 如果无法安全地恢复工作者,就直接继续缺失的研究,或将其拆分为更小的有界任务。超时会改变执行路径,而不会改变验收标准。
  6. 只有在研究问题已得到充分解答、保留的来源和论点已纳入持久化证据产物,且未解决的空缺已明确说明后,才能报告完成。

验收门槛是证据完整性和产物验证,而不是耗时、工作者状态或是否存在看似合理的阶段性摘要。

参考文件

类型
类型参考文件何时加载
新闻调查references/journalistic-research.md你正在研究调查报道——一手来源、访谈、文件、系列管理、发布前核查
行业分析references/industry-analysis.md你正在研究行业分析——信号检测、企业证据、竞争情报、案例研究标准
学术 / 综合研究references/research-lifecycle.md你正在进行深入的系统性研究——问题界定、搜索策略、纳入 / 排除标准
通用方法论
参考文件何时加载
references/source-evaluation.md你需要判断来源是否可信——CRAAP 测试、三角验证、可靠性等级
references/structured-analytic-techniques.md你需要评估相互竞争的解释——ACH、驱动因素、事前验尸、指标
references/synthesis-patterns.md你需要将多个来源的发现整合为综合结论
references/technical-verification.md你需要通过复现来检验技术论断——基准测试、API 行为、配置
references/media-evidence-routing.md媒体研究需要明确划分研究 / FFmpeg / 审阅者职责、抽样审计,或建立来源到论断的闭环
资源
资源产出内容
assets/research-brief.md结构化简报,包含发现、置信度评估、证据表和待解决问题
assets/research-log.md可追溯的搜索、来源和决策记录
assets/media-claim-ledger.md媒体简报职责边界、论断与来源 / 实验的闭环、抽样审计和排除日志

每项重要调查都要使用这两项资源。结束工作前,完成其中的持久化产物部分,并确认保留的来源和提取出的论点已记录在目标系统中。

发布前审查

对于任何包含事实性陈述的内容,请在汇报前加载相关领域的验证流程:

  • 新闻报道: references/journalistic-research.md 中的 7 步发布前流程
  • 行业分析: references/industry-analysis.md 中的 7 步研究流程
  • 技术: references/technical-verification.md 中的 5 步复现流程

可移植性

此技能刻意设计为与宿主无关。请使用 Agent 的常规机制加载此处列出的参考资料、模板和脚本。不要假定存在特定的配置文件系统、任务编排器、记忆服务或响应移交格式。

评论

支持 Markdown