全部技能 / 文档与知识 / research
文档与知识 · mattpocock/skills

research

Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.

风险提醒：绿色 · 放心使用AI 侦查报告
作者 mattpocockGitHub mattpocock/skills ↗Stars 253948许可 MITcommit 3cca18b368
agent 宿主通常会约束 skill 执行权限；风险提醒为 AI 侦查观点，不构成质量或安全保证。第三方 skill 仅作拆解与展示，安装使用风险自负，版权归原作者。

1实现原理 · 为什么它能做到

实现原理 = 纯 prompt 编排 + 宿主后台 agent 能力，skill 内零代码：指示主 agent 把研究委托给一个后台 agent（异步，主 agent 不被阻塞），由宿主提供的子 agent/工具完成实际阅读与落盘

skills/engineering/research/SKILL.md
Spin up a **background agent** to do the research, so you keep working while it reads.
注：整个 skill 只有这段指令文本。没有任何脚本、钩子或对具体宿主 API 的调用——'background agent' 是宿主（Claude Code/Codex 等）已具备的委托能力，skill 只是规定怎么用

信源质量纪律是核心机制：强制一手信源（官方文档/源码/规范/一方 API）而非二手转述，并把每条 claim 回溯到拥有它的源头——用溯源规则来对抗幻觉与二手失真

skills/engineering/research/SKILL.md
Investigate the question against **primary sources** (official docs, source code, specs, first-party APIs), not a secondary write-up of them. Follow every claim back to the source that owns it.
注：这里的机制是约束（bias）而非自动化：不校验引用真实性，只要求 agent 把每个论断追回一手出处

产出形态固定为'仓库内单个 Markdown 文件 + 逐 claim 标注来源'，把研究成果落成可版本化、可复核的仓库资产而非对话摘要

skills/engineering/research/SKILL.md
Write the findings to a single Markdown file, citing each claim's source.
注：单文件、含引用，是交付物契约；无固定结构模板，格式自由

落点策略：优先跟随仓库已有笔记约定，无约定时由 agent 自选合理位置并明确告知用户位置

skills/engineering/research/SKILL.md
Save it where the repo already keeps such notes; match the existing convention, and if there is none, put it somewhere sensible and say where.
注：把'约定发现与位置决策'交给 agent 判断，而不是交互式询问用户

2核心能力

01后台异步研究委托（主 agent 不阻塞，可继续干活）
02一手信源优先与 claim 溯源（官方文档/源码/spec/一方 API，拒绝二手转述）
03单 Markdown 文件沉淀发现，每条 claim 附来源
04遵循仓库笔记约定落盘并回报落点（无约定则自选合理处并说明）
05触发面声明：主题调研、文档/API 事实收集、把阅读苦力活外包给后台 agent
06宿主工具界面自描述（Codex/OpenAI 系 display_name + short_description）

4风险提醒 风险提醒：绿色 · 放心使用

风险提醒：绿色 · 放心使用
  • 输出误导风险（幻觉引用无法自证） — skill 无引用校验/格式要求，agent 若未真正核实，'citing each claim's source' 的文件可能含编造出处；引用真实性需人工抽检
  • prompt injection 面未被防护 — skill 命令 agent 读取任意一手信源网页/文档，但无任何'警惕信源内容本身是被注入的指令'的提示，恶意或被篡改页面可影响后台 agent 行为
  • 质量完全依赖模型与信源，无兜底结构 — 无输出模板/清单/篇幅约束（'a single Markdown file' 即全部），不同模型产出的一致性与深度差异大
  • 落点与范围判断权交给后台 agent — 无笔记约定的仓库中 'put it somewhere sensible' 可能产生位置随意的散落文件（低危）
全目录仅 2 个文本文件（SKILL.md 794B + agents/openai.yaml 94B，git ls-files 与 find 确认无脚本、无隐藏文件、无符号链接），逐字检查无网络端点、无凭证读取、无内嵌可执行内容。唯一'动作'是模型受指示在用户仓库写一个 Markdown 笔记文件（即交付物本身，宿主权限约束下执行）。纯 prompt 编排，与同批同 repo 同类 skill（grill-with-docs：纯指令 + 项目内写文档，同为 green）分级口径一致

5第二遍独立确认

  • [ok] 目录内容仅 SKILL.md + agents/openai.yaml 两个文件（无脚本/附属代码） — git ls-files skills/engineering/research 仅列出两文件；find -type l 为 0；ls -la 无隐藏条目——与第一遍一致
  • [ok] 实现依赖'宿主后台 agent 能力'而非内置机制 — git show 复核 SKILL.md 全文仅 794B 指令文本，无任何对具体宿主 API/工具名的调用代码，'background agent' 确为宿主既有能力
  • [ok] 一手信源优先 + claim 回溯规则存在且为 skill 核心 — 复核到 SKILL.md 正文步骤 1 原文：'Investigate the question against **primary sources** … Follow every claim back to the source that owns it.'
  • [ok] 引用纪律（逐 claim 标注来源） — 复核到步骤 2：'Write the findings to a single Markdown file, citing each claim's source.'
  • [ok] 仓库约定落盘 + 无约定自选并告知 — 复核到步骤 3 原文 'Save it where the repo already keeps such notes; match the existing convention…'
  • [ok] agents/openai.yaml 仅界面元数据、无行为 — git show 复核 94B，仅 interface.display_name/short_description 两字段
  • [ok] external_deps 为空（无 CLI/API/网络端点/第三方包） — 两文件全文逐词复查：无 URL、无域名、无命令行、无包名、无环境变量引用；'official docs, source code, specs, first-party APIs' 只是信源类型描述，非调用点
  • [ok] 安全分级 green（无脚本/无网络外发/无凭证/无隐藏内容） — 找反例未果：无 .sh/.py/可执行位文件、无 fetch/curl 字样、无 key/token/env 字样；唯一写入为交付用的仓库 Markdown（宿主动作）。与同批纯指令型 skill 分级口径一致

6结论

  • 异步委托，主 agent 不被研究阻塞
  • 信源质量纪律直接写入规则，缓解二手失真与幻觉引用
  • 强制引用，产出可复核
  • 产出即仓库长期资产，且随仓库既有笔记约定落盘
  • 零依赖、零代码，宿主可移植性极强
    • 适合：需要把'读文档/查 API 事实/做调研'委托出去并落盘为可复核仓库笔记的场景；适合已有 notes/docs 约定目录的仓库，主 agent 需要并行干其他活时尤其合适
    不适合：需要固定格式/结构化报告或严格篇幅的场景（skill 无任何格式契约）；需要实时交互式多轮深挖的研究（后台 agent 过程不可见）；涉及对抗性或敏感信息、且无人复核引用真实性的场景
    安装 agent 直装可复制
    ② 上游 GitHub · 原始来源
    能访问 GitHub？直接去上游安装（实时版，可能已更新）GitHub 原始 ↗
    本页镜像锁定 commit 3cca18b368；上游为实时仓库。
    来源信息 GitHub 原始
    作者 / 仓库mattpocock / mattpocock/skills
    原始 GitHubmattpocock/skills ↗
    Stars253948
    最近推送2026-09-04
    本 skill commit3cca18b368
    许可MIT
    本站信息
    收录日期2026-09-06
    分类文档与知识
    侦查报告2026-09-06 · 2 遍
    本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。