mcpField
O
outline-agent

outline-agent

github.com/ar9av文档处理69367 次安装2 周前更新
代码仓库

关于 outline-agent

outline-agent 是 PaperOrchestra 的一项技能,可将研究材料整理为结构化大纲,并补充叙事简报。它面向论文撰写流程,提供后续步骤使用前的大纲校验。

主要功能

  1. 01读取工作区中的四类研究材料
  2. 02生成结构化大纲 JSON
  3. 03按 Schema 校验输出
  4. 04向 research_brief.md 追加叙事部分

适用场景

  1. 01根据研究构想和实验日志生成大纲
  2. 02为后续论文 Agent 准备经校验的输入

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ar9av/paperorchestra --skill outline-agent

安装后在 Claude Code 中输入/outline-agent确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
allowed-values.md
example-output.json
outline_schema.json
outline-schema.md
prompt.md
scripts/
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[]

操作方法

  1. 阅读 references/prompt.md 中的原文提示词。 这是论文中的 Outline Agent 系统提示词原文。将其用作系统消息。

  2. 在前面添加 Anti-Leakage Prompt,内容来自 ../paper-orchestra/references/anti-leakage-prompt.md。

  3. 阅读 4 个输入文件:

    • workspace/inputs/idea.md
    • workspace/inputs/experimental_log.md
    • workspace/inputs/template.tex
    • workspace/inputs/conference_guidelines.md
  4. 综合分析全部 4 个文件 — 提示词中的全局指令是: “不要孤立地分析输入。每个步骤都必须综合所有提供的文档中的信息。”

  5. 输出一个符合 references/outline-schema.md 中的架构的 JSON 对象。 使用 references/outline_schema.json(机器可读)进行交叉核对。

  6. 保存至 workspace/outline.json。

  7. 验证:

    python skills/outline-agent/scripts/validate_outline.py workspace/outline.json
    

    如果验证失败,请修复 JSON 并重新验证。大纲无效时,不要继续执行步骤 2 或步骤 3——所有下游 Agent 都依赖此架构。

  8. 将 §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 Schema
  • references/example-output.json — 论文中的示例输出
  • references/allowed-values.md — 各枚举字段允许值的列表
  • scripts/validate_outline.py — JSON Schema 验证器
  • skills/shared/research_brief_template.md — 新增 §1 架构;outline.json 通过验证后追加

评论

支持 Markdown