关于 research-methodology
research-methodology 是为子 Agent 设计的研究流程技能,适用于新闻调查、行业分析和学术或综合研究。它以共用研究生命周期为基础,并强调来源评估、证据留存和可恢复的研究执行。
主要功能
- 01提供三类研究流程
- 02覆盖范围界定至报告的完整生命周期
- 03评估来源并分析证据
- 04保存可追溯的研究材料与来源关系
- 05处理超时并从检查点恢复
- 06提供研究简报、日志和媒体证据模板
适用场景
- 01开展基于一手来源的调查报道
- 02分析行业信号与市场策略
- 03进行系统性学术或综合研究
- 04验证技术或媒体相关主张
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ magnus919/ agent-skills --skill research-methodology安装后在 Claude Code 中输入/research-methodology确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdassets/media-claim-ledger.mdresearch-brief.mdresearch-log.mdevals/evals.jsonreferences/industry-analysis.mdjournalistic-research.mdmedia-evidence-routing.mdresearch-lifecycle.mdsource-evaluation.mdsource-index.mdstructured-analytic-techniques.mdsynthesis-patterns.mdtechnical-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 给出看似合理的答案,并不意味着研究已经完成。只有在适合宿主系统及其用户的持久化格式中,保存了可复用的证据和推理过程,研究才算完成。
报告前,明确记录保存决策:
- 确定持久化保存位置。 使用宿主系统中常规的长期研究载体:关联的知识记录、纳入版本管理的报告包、研究数据库、项目文档或其他用户可见的产物。不要将唯一有用的输出留在聊天、临时工作区或未纳入版本管理的草稿文件中。
- 按来源的自然粒度提取。 记录每项会实质性影响未来推理、且彼此独立并可复用的主张、数据点、方法、矛盾和待解问题。不要用固定的原子条目数、发现数量或笔记数量作为停止标准。持续提取,直到提取日志中已记录每个保留来源的处理情况。
- 保留来源信息和关联关系。 每项持久化产物都必须保留来源 URL 或引文、访问日期、证据强度,以及指向研究问题、相关产物和依赖该来源的综合分析的链接。
- 将提取与综合分开。 简报或报告负责解释结论,不能取代底层证据记录。先保存来源级记录和可复用主张,再将其精简为综合分析。
- 记录未予保存的内容。 如果某个来源被拒绝、证据过弱、无法访问、内容重复或超出范围,应在研究日志中记录此决定。后续研究者必须能区分有意排除的来源和被遗漏的来源。
具体的产物形式取决于环境。不要预设特定的数据库、笔记应用或编排系统。始终应确保研究内容持久保存、便于浏览、与证据关联,并能让后续用户或 Agent 找到并继续使用。
中断与超时恢复
研究工作者超时属于中断,而非研究结果。绝不要因此结束调查、将其概括为已完成,或仅因委派的工作者超出执行上限就推断没有有用成果。长期研究任务常会遇到提取缓慢、速率限制,或某个来源无响应的情况,即使此前已经产出了有价值的阶段性成果。应将长期研究规划为有界、可恢复的子任务:采用适合任务的执行时限,增量写入检查点,并从最近一个已验证的检查点继续,而不是设置任意的短时限,或假设可以使用无界执行时限。
工作者超时时:
- 在决定哪些内容丢失前,阅读完整的委派记录,并检查工作区或临时目录。
- 恢复并验证已写入的所有阶段性产物、来源日志和提取出的论点。
- 从最后一个持久检查点继续,而不是重新进行广泛探索。
- 缩小范围或替换耗时操作,尤其是大型 PDF 提取或重复遭遇速率限制的搜索,并增量写入后续各阶段的内容。
- 如果无法安全地恢复工作者,就直接继续缺失的研究,或将其拆分为更小的有界任务。超时会改变执行路径,而不会改变验收标准。
- 只有在研究问题已得到充分解答、保留的来源和论点已纳入持久化证据产物,且未解决的空缺已明确说明后,才能报告完成。
验收门槛是证据完整性和产物验证,而不是耗时、工作者状态或是否存在看似合理的阶段性摘要。
参考文件
类型
| 类型 | 参考文件 | 何时加载 |
|---|---|---|
| 新闻调查 | 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 的常规机制加载此处列出的参考资料、模板和脚本。不要假定存在特定的配置文件系统、任务编排器、记忆服务或响应移交格式。