用途:Readout 将一次调查转化为一份自包含的 HTML 文档,让读者在数周后无需原始上下文也能读懂。它有两种启动方式:快照模式,在对话中途调用(如“write this up”),以对话中积累的发现为素材;研究模式,全新调用(如“/readout on how github webhook events are processed in the server”),没有对话可挖掘,调查本身即任务的一部分。
主要能力:作为主智能体的副任务,主智能体负责明确范围、用简报启动一个子智能体,子智能体完成挖掘/研究与写作,从而把大量工作挡在主上下文窗口之外。
使用方式:编排流程分四步。一是明确范围,启动前先问 2–4 个有针对性的问题,给出具体选项,并确定深度与受众;范围已具体时可跳过访谈。二是撰写简报(约 10–20 行),包含工作标题/主题、模式、必须回答的问题、深度与受众、覆盖与排除范围、快照模式下的核心结论、研究模式下的起点指针、仓库绝对路径、托管 URL 与已检查的 commit。三是通过 run_agents 启动恰好一个本地子智能体,命名为 readout-<topic-slug>,其提示词需包含简报、对应模式的素材块(快照模式还需 current_run_id 以便用 search_conversation_history 挖掘父对话)、先阅读 references/doc-guide.md 的指令、输出路径约定与完成协议。四是启动后继续手头工作或结束回合,子智能体完成消息会自行到达。
输出约定:写入 ~/.readouts/<YYYY-MM-DD>-<topic-slug>.html,必要时创建目录、重名加 -2/-3 后缀,日期取自 date +%F;按文档指南嵌入源码(scripts/embed_snippets.py);用 python3 scripts/update_index.py 刷新索引;写完后用 open <path> 打开(无头环境跳过);向编排者报告绝对路径、2–3 句摘要及未能验证的内容。
限制与回退:子智能体不可用或被拒时,主智能体自行按 doc-guide.md 产出文档;子智能体无法搜索对话历史时,向其回复提炼后的发现;用户直接提供材料(转录、文件、链接)时,以该材料为来源,其余流程不变。资料未提供具体收费、平台支持范围等信息。