name: survey-generatordescription: “Generate source-backed AI/ML survey paper artifacts with curated bibliographies and Fireworks/Kimi HTML rendering.”allowed-tools: Read, Write, Bash, WebFetch, AskUserQuestioncategory: “research”risk: “safe”source: “official”source_repo: “dair-ai/dair-academy-plugins”source_type: “official”date_added: “2026-06-19”author: “DAIR.AI”license: “MIT”license_source: “https://github.com/dair-ai/dair-academy-plugins/blob/main/README.md#license”tags:dair-academyaiworkflowtools:claude-codecodex-clicursorSurvey Generator 技能何時(shí)使用當(dāng)此工作流與用戶請(qǐng)求匹配時(shí)使用為已文檔化的工作流使用此技能。來(lái)源dair-ai/dair-academy-pluginsMIT。將學(xué)術(shù)風(fēng)格的綜述論文生成為單個(gè)自包含的 HTML 文件。此技能做什么給定一個(gè)主題和一個(gè)公開(kāi)的錨點(diǎn)資源此技能讀取錨點(diǎn)資源并提取相關(guān)工作全景。構(gòu)建結(jié)構(gòu)化的research_bundle.json標(biāo)題、分類(lèi)法、章節(jié)、真實(shí)論文的參考文獻(xiàn)。通過(guò) Fireworks chat completions API 調(diào)用 Kimi K2.6傳入研究包和固定的style_spec.json。寫(xiě)出單文件 HTML 產(chǎn)物包含內(nèi)聯(lián) SVG 圖、學(xué)術(shù)布局、編號(hào)章節(jié)和參考文獻(xiàn)列表。使用此技能的代理只負(fù)責(zé)研究策展。所有散文、圖表和 HTML 都由 Kimi K2.6 在一次 API 調(diào)用中生成。用戶輸入用戶至少以以下內(nèi)容調(diào)用此技能topic一個(gè)簡(jiǎn)潔的綜述主題例如Agentic Engineering或Reasoning Models。source_url一個(gè)公開(kāi)的錨點(diǎn)資源。任何精選列表、權(quán)威博客文章、arXiv 綜述、GitHub awesome 列表或索引頁(yè)面都可以。建議的起點(diǎn)DAIR.AI AI Papers of the Week一個(gè)持續(xù)更新的知名 AI/ML 論文開(kāi)源索引非常適合寬泛主題、GitHub awesome-* 倉(cāng)庫(kù)、arXiv 綜述 PDF 或維護(hù)良好的論文頁(yè)面?？蛇xbibliography_size目標(biāo)參考文獻(xiàn)規(guī)模?？焖倬C述默認(rèn) 20。綜合綜述用 40 到 50詳盡綜述用 80 到 100。章節(jié)長(zhǎng)度和 token 預(yù)算隨此縮放。section_count章節(jié)數(shù)量默認(rèn) 6 到 10。如果用戶沒(méi)有提供這些在繼續(xù)前使用 AskUserQuestion 收集。要求環(huán)境中導(dǎo)出FIREWORKS_API_KEY。構(gòu)建腳本從os.environ讀取它。Python 3僅標(biāo)準(zhǔn)庫(kù)urllib。無(wú)外部依賴。代理工作流按順序執(zhí)行以下步驟。不要跳過(guò)步驟。第 1 步讀取錨點(diǎn)資源獲取并讀取source_url。如果是 GitHub 倉(cāng)庫(kù)獲取 README 以及任何相關(guān)的README-*.md或papers.md索引。如果是 arXiv 綜述使用摘要、圖表和章節(jié)標(biāo)題。如果是博客文章完整閱讀。提取關(guān)鍵子主題以及它按名稱引用的論文或系統(tǒng)。對(duì)于寬泛的 AI/ML 主題DAIR.AI AI Papers of the Week 是一個(gè)特別豐富的錨點(diǎn)它有持續(xù)多年的周報(bào)每期包含 6 到 10 篇知名論文的簡(jiǎn)短摘要因此很容易跨時(shí)間瀏覽并過(guò)濾出與你的主題匹配的子集。如果你的代理可以使用論文搜索工具Papers-of-the-Week MCP、arXiv 搜索、Semantic Scholar、Google Scholar、組織內(nèi)部索引等請(qǐng)使用它把候選池?cái)U(kuò)展到錨點(diǎn)資源直接引用的范圍之外。第 2 步定義分類(lèi)法和章節(jié)起草一棵以主題為根的分類(lèi)法包含 4 到 8 個(gè)分支每個(gè)分支有 2 到 4 個(gè)子節(jié)點(diǎn)。分支應(yīng)覆蓋主題的不同子領(lǐng)域不要重疊。起草 6 到 10 個(gè)編號(hào)章節(jié)與分類(lèi)法的遞進(jìn)保持一致引言、基礎(chǔ)、方法、評(píng)估、開(kāi)放問(wèn)題。圖 1 的視口高度通過(guò)style_spec.json中的幾何契約隨葉子總數(shù)自動(dòng)縮放因此更深的分類(lèi)法也能干凈渲染。第 3 步策展參考文獻(xiàn)挑選與bibliography_size規(guī)模相符的真實(shí)論文。對(duì)于綜合綜述40 到 50 條是最佳區(qū)間此技能已在build_artifact.py中max_tokens81920的條件下測(cè)試到 100 條。每條必須有key、authors、year、title、venue和 1 到 2 句的summary。不要編造論文。每個(gè)章節(jié)的papers數(shù)組必須引用參考文獻(xiàn)中存在的鍵。第 4 步編寫(xiě)research_bundle.json在技能目錄中build_artifact.py旁邊寫(xiě)入research_bundle.json。使用templates/research_bundle_template.json作為結(jié)構(gòu)骨架。必需的頂層字段title、authors_placeholder、anchor_source、abstract_hints、taxonomy、paradigms、stack、sections、table、bibliography。查看examples/agentic-engineering/research_bundle.json獲取完整的工作示例。第 5 步運(yùn)行生成器python3 build_artifact.py從技能目錄運(yùn)行此命令。腳本讀取research_bundle.json和style_spec.json調(diào)用 Fireworks 上的 Kimi K2.6并寫(xiě)出output/survey_kimi-k2p6_v{N}.html。每次運(yùn)行都會(huì)產(chǎn)生一個(gè)新的帶版本號(hào)的文件。要使用不同的 Fireworks 模型例如 Kimi K2.5 做并排對(duì)比FIREWORKS_MODELaccounts/fireworks/models/kimi-k2p5 python3 build_artifact.py輸出文件名按模型 slug 化因此你可以跨模型比較版本。第 6 步預(yù)覽與迭代在本地打開(kāi) HTML 文件。它是一個(gè)完全自包含的 HTML 文檔因此你也可以從任何靜態(tài)主機(jī)提供服務(wù)、嵌入面板或交給你的代理暴露的任何產(chǎn)物預(yù)覽機(jī)制。如果圖表看起來(lái)不夠好調(diào)整style_spec.jsonrequired_figures和figure_quality_note鍵并重新運(yùn)行。如果散文單薄或章節(jié)缺失收緊research_bundle.json中的章節(jié)guidance字段。不要直接編輯 Kimi 的輸出對(duì)輸入進(jìn)行迭代。常見(jiàn)圖表失敗模式及修復(fù)它們的 style_spec 模式不同面板的節(jié)點(diǎn)折疊到同一面板要求g transformtranslate(OFFSET,0)組使用面板局部坐標(biāo)圖 2 強(qiáng)制。葉子矩形垂直重疊導(dǎo)致標(biāo)簽被裁剪強(qiáng)制 rect_pitch 大于 rect_height配合顯式公式和健全性檢查圖 1 強(qiáng)制。根標(biāo)簽溢出其膠囊在規(guī)范中固定最小矩形寬度圖 1 強(qiáng)制width200。一行中的兄弟節(jié)點(diǎn)水平重疊例如編排器-工作器面板中的 Worker A、Worker B、Worker C在固定寬度面板中為 N 個(gè)節(jié)點(diǎn)強(qiáng)制確定性的 rect_width 和 center_x 公式相鄰矩形之間留最小水平間隙圖 2 多節(jié)點(diǎn)行強(qiáng)制。面板內(nèi)容漂移到左或右邊緣而不是位于面板背景中間將每個(gè)組的 translate 偏移固定為匹配面板背景的 x 位置10、270、530并將所有內(nèi)容居中于面板局部 x120圖 2 強(qiáng)制。因?yàn)槟Ｐ推貌煌臄⑹隽鞒潭鴮?dǎo)致圖表以錯(cuò)誤的數(shù)字順序輸出要求標(biāo)題按順序使用 required_figures 中的確切 ID圖 1 在圖 2 之前圖 2 在圖 3 之前即使這意味著在同一章節(jié)放置兩個(gè)圖通過(guò) hard_rules_for_generation 強(qiáng)制。堆棧圖右側(cè)標(biāo)簽在視口邊緣被裁剪將堆棧 SVG 視口加寬到 720并要求角色文本 tspan 適配在 x710 內(nèi)圖 3 強(qiáng)制。添加新圖或修改現(xiàn)有圖時(shí)遵循同樣的模式聲明絕對(duì)視口、逐元素坐標(biāo)或確定性公式以及在描述末尾加上硬性不變量檢查子句。此技能中的文件SKILL.md- 本文件。build_artifact.py- 調(diào)用 Fireworks 的 Python 腳本。style_spec.json- 視覺(jué)和結(jié)構(gòu)規(guī)范與主題無(wú)關(guān)。templates/research_bundle_template.json- 新主題的空模板。examples/agentic-engineering/- 參考性 100 篇論文的運(yùn)行research_bundle.json survey.html。代理必須遵守的硬性規(guī)則絕不編造參考文獻(xiàn)條目。每篇被引用的論文都必須是帶有真實(shí)發(fā)表場(chǎng)所的真實(shí)工作。每個(gè)章節(jié)的papers數(shù)組必須引用參考文獻(xiàn)中存在的鍵。絕不編輯生成的 HTML。對(duì)research_bundle.json或style_spec.json迭代并重新運(yùn)行。不要修改style_spec.json.hard_rules_for_generation中的硬性規(guī)則。保持 style_spec 與主題無(wú)關(guān)。主題特定內(nèi)容只存在于research_bundle.json中。不要在 research bundle 的散文字段中使用破折號(hào)或箭頭符號(hào)。局限性當(dāng)工作流指明需要上游工具、賬戶、API 密鑰或本地設(shè)置時(shí)需要具備這些。未經(jīng)用戶明確批準(zhǔn)不授權(quán)破壞性、生產(chǎn)、付費(fèi)或外部消息操作。在將生成的產(chǎn)物或建議視為最終結(jié)果之前對(duì)照用戶的真實(shí)來(lái)源進(jìn)行驗(yàn)證。