joshua-zyy/academic-paper-writer

Academic Figure

CS/AI/ML 學術圖表路由器。實驗數據圖預設交付 Python/matplotlib 可編輯 SVG，並通過 CS/AI/ML 圖表設計門檻。模型框架圖、架構圖、概覽圖和複雜機制圖不屬於本技能的自動繪製範圍；若論文需要此類圖表，僅能輸出人工繪製需求、證據清單、標題草案或圖表藍圖筆記。

路由器協議

1. 讀取 manifest.yaml。它聲明 always_load 檔案、axes 以及 references.on_demand。
2. 讀取 always_load 下列出的每個檔案。這些是技能的綁定規則 — 非參考材料。
3. 將載入的材料作為約束應用：
   • stance.md 定義僅限 Python 繪圖、圖表合約、視覺政策及範圍。
   • red-lines.md 定義絕對禁止事項。不得協商這些事項。
   • output-contract.md 定義每種模式的交付物。
   • anti-patterns.md 定義已知的失敗模式及其正確替代方案。
4. 從清單中選擇恰好一個 mode。若不明確，僅在缺少數據來源或目標用途時提出一個簡潔的澄清問題。對模型框架圖、架構圖、概覽圖或機制圖的請求，僅使用 figure-blueprint 模式來生成 manual_figure_needed 註記；切勿渲染圖像、SVG 或提示詞。
5. 執行前向用戶回顯所選模式。
6. 僅當清單的 references.on_demand 條件滿足時，才存取 references/。

模式

模式	使用時機
chart-from-data	有數據檔案或數值結果，需要生成帶有 CS/AI/ML 圖表設計門檻的發表級圖表
figure-blueprint	需要為論文章節提供圖表建議
figure-audit	對現有圖表進行發表準備度審查
figure-revision	需要修改現有圖表

代理分派

agents/figure_agent.md 由編排器在第 6.4 步分派。代理返回圖表成品、腳本、SVG 路徑和報告；它不得獨立編輯專案原始碼或實驗數據。

完成標準

• chart-from-data：圖表合約、CS/AI/ML 圖表設計門檻、Python 腳本、來源數據、可編輯 SVG、QA 報告 — 全部通過。
• figure-audit：每個 QA 項目都有通過/失敗狀態及具體改進措施。
• figure-blueprint：每個建議圖表都對應到一個論文主張和數據/證據來源。
• figure-revision：修改後的成品或說明、QA 報告、不變的證據可追溯性。