关于 outline-agent
outline-agent 是 PaperOrchestra 的一项技能,可将研究材料整理为结构化大纲,并补充叙事简报。它面向论文撰写流程,提供后续步骤使用前的大纲校验。
主要功能
- 01读取工作区中的四类研究材料
- 02生成结构化大纲 JSON
- 03按 Schema 校验输出
- 04向 research_brief.md 追加叙事部分
适用场景
- 01根据研究构想和实验日志生成大纲
- 02为后续论文 Agent 准备经校验的输入
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ ar9av/ paperorchestra --skill outline-agent安装后在 Claude Code 中输入/outline-agent确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/allowed-values.mdexample-output.jsonoutline_schema.jsonoutline-schema.mdprompt.mdscripts/validate_outline.py详细介绍
Outline Agent(步骤 1)
忠实实现 PaperOrchestra 中的 Outline Agent (Song 等,2026,arXiv:2604.05018,附录 F.1,第 40–44 页)。
成本:调用大模型 1 次。
你的任务
从工作区读取 4 个输入文件,并在
workspace/outline.json 生成一个包含 3 个顶层键的 JSON 对象:
plotting_plan— 图表对象数组intro_related_work_plan— 包含introduction_strategy和related_work_strategy的对象section_plan— 章节对象数组,每个对象都包含section_title和subsections[]
操作方法
-
阅读
references/prompt.md中的原文提示词。 这是论文中的 Outline Agent 系统提示词原文。将其用作系统消息。 -
在前面添加 Anti-Leakage Prompt,内容来自
../paper-orchestra/references/anti-leakage-prompt.md。 -
阅读 4 个输入文件:
workspace/inputs/idea.mdworkspace/inputs/experimental_log.mdworkspace/inputs/template.texworkspace/inputs/conference_guidelines.md
-
综合分析全部 4 个文件 — 提示词中的全局指令是: “不要孤立地分析输入。每个步骤都必须综合所有提供的文档中的信息。”
-
输出一个符合
references/outline-schema.md中的架构的 JSON 对象。 使用references/outline_schema.json(机器可读)进行交叉核对。 -
保存至
workspace/outline.json。 -
验证:
python skills/outline-agent/scripts/validate_outline.py workspace/outline.json如果验证失败,请修复 JSON 并重新验证。大纲无效时,不要继续执行步骤 2 或步骤 3——所有下游 Agent 都依赖此架构。
-
将 §1 附加到 research_brief.md(参见
skills/shared/research_brief_template.md):outline.json通过验证后,将 §1 章节附加到workspace/research_brief.md(如果文件不存在,则创建该文件)。模板:## §1 · Core Claim and Narrative _Written by: outline-agent, Step 1_ **Core claim:** <one-sentence contribution> **Narrative tension:** <gap this paper resolves> **Key novelty framing:** <how the contribution is framed relative to prior work> **Outline decisions:** - Plotting plan: <N> figures - Related Work clusters: <names> - Section structure: <section titles> **Potential weaknesses flagged at outline stage:** - <any claim in idea.md that may be hard to support>这是自由格式的文本追加操作;不需要机器可读的架构。
提示词中的硬性规则(不得违反)
以下内容摘自 references/prompt.md。验证器会强制检查这些规则。
绘图计划(指令 1)
plot_type必须严格为"plot"或"diagram"之一。data_source必须严格为"idea.md"、"experimental_log.md"或"both"之一。aspect_ratio必须严格为以下值之一:"1:1"、"1:4"、"2:3"、"3:2"、"3:4"、"4:1"、"4:3"、"4:5"、"5:4"、"9:16"、"16:9"、"21:9"。figure_id必须是语义明确的 snake_case 标识符 (例如fig_framework_overview、fig_ablation_study_parameter_sensitivity)。figure_id不得包含单词"Figure"。
引言/相关工作策略(指令 2)
- 严格区分引言(宏观背景,10–20 篇论文,基础性论文 + 综述 + 影响)和相关工作(微观技术基线,30–50 篇论文,划分为 2–4 个方法类别,直接与所提方法竞争或先于该方法出现)。
- 对于每个相关工作类别:提供
methodology_cluster、sota_investigation_mission、limitation_hypothesis、limitation_search_queries、bridge_to_our_method。 - 关键时间线规则:不得指示搜索任何发表时间晚于
{cutoff_date}的论文。根据conference_guidelines.md推导cutoff_date(例如,“ICLR 2025 → 截止日期为 2024 年 10 月”,“CVPR 2025 → 截止日期为 2024 年 11 月”)。如果未指定,则默认为今天之前一个月。
章节规划(指令 3)
- 结构层级:如果创建了小节 X.1,则必须创建 X.2。 不得有孤立的小节。如果某个章节无需拆分,则完全省略小节。
- 内容具体性:每个
content_bullets条目都必须具体引用源材料。避免使用“描述该模型”之类的表述。应使用“根据 idea.md 中的公式 3,形式化定义时间感知注意力机制”之类的表述。 - 强制引用:
idea.md或experimental_log.md中提及的每个数据集、优化器、指标及基础架构/模型都必须有引用提示,无论其多么常见(例如 AdamW、ResNet、ImageNet、CLIP、Transformer、LLaMA、GPT、LLaVA)。 - 引用提示格式:
- 如果知道确切的作者和标题:
"作者(论文确切标题)" - 否则:
"介绍 '[模型/数据集/指标确切名称]' 的研究论文或技术报告" - 不得猜测或捏造作者。
- 如果知道确切的作者和标题:
输出
恰好一个文件:workspace/outline.json。不得包含正文、代码块或 Markdown。
章节撰写 Agent 和文献综述 Agent 将直接解析此 JSON。
完整示例请参见 references/example-output.json,该示例取自论文(附录 F.1,第 43–44 页)。
资源
references/prompt.md— 附录 F.1 中 Outline Agent 提示词的原文references/outline-schema.md— 对架构的文字说明references/outline_schema.json— 机器可读的 JSON Schemareferences/example-output.json— 论文中的示例输出references/allowed-values.md— 各枚举字段允许值的列表scripts/validate_outline.py— JSON Schema 验证器skills/shared/research_brief_template.md— 新增 §1 架构;outline.json 通过验证后追加