autoresearch
Skill3 starsChanged 13 days agoMITView on GitHub
研究循环总控:用户交办目标或开放问题(方案可以完全未知),独立跑「研究→干活→审核→蒸馏」来回循环——调研取证、动手实验、对抗审查、总结蒸馏,对照完成判据没完成就排除法续轮,直到五个诚实终态(answered/inconclusive/blocked/budget-exhausted/cancelled)。Triggers: autoresearch, 自动研究, 研究循环, research loop, hypothesis loop.
100 other projects use a version of this.
Adopted by
Most recently taken up by
- thistleknot/skillstheir own version, first seen Nov 8, 2026
- WdBlink/autoresearch-papertheir own version, first seen Nov 8, 2026
- OpenLAIR/dr-clawtheir own version, first seen Nov 8, 2026
- taixuann/development-spacetheir own version, first seen Nov 8, 2026
- TidalPaladin/skillstheir own version, first seen Nov 8, 2026
- usecompai/compound-operations-modeltheir own version, first seen Nov 8, 2026
Used with
Projects with it also use aeon-update, auto-workflow and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
aaronjmarsSkillaeon-update
Pull framework updates from the upstream Aeon repo into this instance - 3-way merges canon's new commits into a PR, never clobbering operator config.
Also in 4 projects that use this
aaronjmarsSkillauto-workflow
Two-mode aeon.yml workflow builder - analyze inspects URLs and emits a tiered, signal-verified skill-enablement plan plus an aeon.yml diff; enable flips slugs to enabled:true and opens a PR.
Also in 4 projects that use this
- +10 more from aaronjmars
Other versions100 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 100
- github/awesome-copilot★ 41ksame name
- Yeachan-Heo/oh-my-claude-sisyphus★ 41ksame name
- Yeachan-Heo/oh-my-claudecode★ 41ksame name
- Yeachan-Heo/oh-my-codex★ 34ksame name
- AgriciDaniel/claude-obsidian★ 16ksame name
- Orchestra-Research/AI-research-SKILLs★ 13ksame name
- zechenzhangAGI/AI-research-SKILLs★ 13ksame name
- Orchestra-Research/AI-Research-SKILLs★ 12ksame name
- advaitpaliwal/feynman★ 10ksame name
- companion-inc/feynman★ 10ksame name
90 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository17 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- brainstormSkill
- cleanupSkill
- diagnoseSkill
- find-skillsSkill
- handoffSkill
- harness-builderSkill
- implementSkill
- planSkill
- remove-deadcode-pySkill
- researchSkill
- reviewSkill
- shipSkill
- sweepSkill
- tddSkill
- writing-for-agentsSkill
The file
Files
AutoResearch 研究循环
用户交办一个目标或问题——方案未知没关系。本 skill 独立跑完:每轮「研究 → 干活 → 审核 → 蒸馏」,对照完成判据看完成没有,没完成就过排除法三问续轮。入口一句话,循环零打扰;与 deep research 的区别是干活是一等公民——跑实验、写测量脚本、改代码验证假设都是正常取证。需改代码走 implement(实验子任务独立轨道,不动研究主轨道),不在轮内调 ship(收尾由本 skill 统一负责)。
入口
autoresearch <目标/问题>(可附材料):立项即开跑。autoresearch <研究日志路径>:目标已在日志头部,直接续跑;重入先检索docs/research/既有日志。
立项摸底(planner)
- 需求定成一句可交付目标(逐字引用用户原话,原话未覆盖的推断须标注),落日志(默认
docs/research/YYYY-MM-DD--<topic>.md,项目有 research/notes 惯例跟随)。头部背景节=一句话目标+范围边界+完成判据+已知事实与候选解释——全程固定,防偷换防漂移。日志即轨道(Track 头自登记):项目有 harness 恢复面且研究要跨会话恢复时,由plan按合同 v2 开轨道(index.md加一行、建tracks/<id>.md,Entry:指向日志;见../writing-for-agents/references/recovery_surface_policy.md);无恢复面不强建.harness/,无 lessons 面则蒸馏条目记日志末节。 - 摸底并行做:读 lessons 与既有日志;通用检索+平台渠道(环境装有 agent-reach 类平台读取路由时自动扩展取证面,遵循其自身协议如 doctor 体检;无则降级为通用 web 检索+一手来源直读)。候选解释=后续轮次要区分的竞争假设。
循环(每轮四段)
- 研究:假设包写进日志——可证伪假设、预测(足以区分本轮竞争解释,不扩大不偷换用户范围)、验证方式、成功判据。不等批准——防线=背景节固定+授权边界+审核必审。
- 干活(取证执行,并行扇出:轮内独立任务并行派后台代理/subagent,主会话只持假设与裁决,有依赖才串行;派发与回收靠上下文指针——日志路径、假设编号、来源链接——不贴摘要):
- 只读类:一手来源优先(官方文档、源码、spec、第一方 API);委派结果一律是 claim,回主会话核来源+获取时点才落账;平台社交内容(X/Reddit/播客字幕等)是线索不是定案,定案回溯一手来源;关键结论至少两个独立一手来源交叉,只有单源必须明示。
- 动手类:本地可逆实验直接做——跑实验、写测量脚本、改代码验证(走
implement,实验子任务独立轨道不动主轨道);纯阅读轮此段记「本轮无需动手」。
- 审核:
review协议+独立攻击(lens 见references/adversarial-lenses.md),重开提案本身列入必审对象。降级自审必须记录具体攻击与反例尝试,输出标注 independent / self。 - 蒸馏:日志记一节(假设→预测与观察→对抗裁决→结论);lessons 候选只收带触发条件的非显然经验,记在本轮日志,收尾时由
cleanup写进lessons.md(轮内不写.harness/);「无新增」是合法结论并照记。
控制与停止
- 完成检查:每轮蒸馏后对照背景节完成判据——覆盖且证据充分 →
answered(唯一可称完成的终态);否则过三问决定续轮或诚实停止。 - 重开三问(对抗审查下交出):本轮排除了什么(附证据)?尚未解决的剩余解释?下一轮如何区分?目标与范围不变(背景节固定);未覆盖的原始要求不得降格为「遗留」——只能报告部分回答,或在剩余预算内继续;与原目标不同向的相邻新问题才记「遗留」,用户显式加问另立轨道。
- 授权边界(唯一暂停点):研究范围内只读、检索、本地可逆实验免批;花钱、外部写入、不可逆或生产影响——停下来问。逐轮确认是触发词选项(用户说「每轮停下来给我看」即启用);「全权」声明后全程免停。
- 预算:默认 3 轮 × 每轮 1 次有成本实验(检索与阅读不计入),用户可调;预算尽 →
budget-exhausted。 - 五终态:
answered/inconclusive(证据不足,如实报告未能得出的结论)/blocked(外部依赖不可得)/budget-exhausted/cancelled(用户叫停)。
终态与交付
收敛或停止后先写完终态与结论,再走 cleanup 收尾。结论节按「结论先行+逐条证据链接」书写,读者只读该节即可拿走答案。研究日志是交付物,关轨道时不删(关轨道只删计划与 Spec);无 git 环境保留日志并记录终态。
Recommended next skill
- 收尾:
cleanup;干活中根因未知:diagnose。 - 目标本身是用户设计取舍且阻碍继续:
brainstorm(转出后本 skill 结束)。 - 研究产物堆积后全仓对账:
sweep。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

