asimfish/super_agent_presentation

代理導向報告

以最短的結構呈現最新任務狀態，讓讀者能快速找到結果、證據、邊界及有用的後續行動。此技能管轄報告的呈現方式；它絕不改變任務事實，也不取代特定領域的驗證。

不可協商的優先事項

當使用者明確指定時，請遵循其要求的表面、架構、長度和順序。然後遵循主機的指示。僅將此框架用於填補未指定的選擇。絕不發明證據、測試、引用、指標、檔案、擁有者、日期或完成度。

書擋式工作流程

1. 根據受眾、表面、證據邊界和恰好一個主要模式來分類交接。對於研究工作，最多選擇一個領域設定檔。若不確定，使用 list 或 route。

2. 根據任務調整儀式規模。對於簡短、單次會議的回答，不要建立檢查點、草稿檔案或腳本審計：直接應用路由模式的結構，自行檢查其所需的語意，然後交付；步驟 4-6 中以檔案為基礎的儀式是針對長期、多代理或多階段任務，或持久工件而設計的。對於長期、多代理或多階段的任務，在接近開始時儲存一個精簡的檢查點；對於短期任務，推遲路由直到報告邊界。

3. 完成並驗證實際任務。保持任務執行獨立於報告樣式。

4. 在進行實質性更新或最終回答之前，立即擷取一個邊界束。優先選擇一個顯示模組；僅在主要模式和第一個模組尚未涵蓋的明確需求下，才添加第二個模組。切勿僅僅因為請求的輸出命名了所選模式已指定的語意就載入模組：

   解析 <skill-dir> 為包含此 SKILL.md 的目錄；不要假設呼叫者的工作目錄就是技能目錄。

   python3 <skill-dir>/scripts/reportctl.py bundle \
     --task "<需要溝通的內容>" --mode <模式> --surface <表面> \
     [--profile <設定檔>] [--module <模組>] [--module <模組>] \
     --max-chars 16000
   

   如果恢復長期任務，請傳遞 --checkpoint <路徑>，而不是從記憶中重建路由。--max-chars 是一個獨立的上下文預算：一個有效的檢查點，若包含兩個大型模組，可能需要明確指定更大的值。不要讀取每個模式、模組或範本。

5. 為選定的表面以原生方式起草。當路由推薦一個確切的資產時，檢查廉價註冊表並僅擷取一個資產：

   python3 <skill-dir>/scripts/reportctl.py template --list
   python3 <skill-dir>/scripts/reportctl.py template <範本-id> \
     --output <目的地>
   

   使用一個主要的交付成品；除非使用者要求，否則不要建立平行的 Markdown、HTML、PPTX 和 PDF 版本。複製的範本是起始工件，而不是其佔位符、視覺效果或聲明正確的證據。

   內容完成後，對文章進行去 AI 語氣處理：在 natural-tone 模組的忠實度合約下，刪除諂媚的開場白、表演式的總結、誇大的術語和樣板修辭。語氣編輯絕不改變事實、關係、範圍或數字；審計的 ai-tone-boilerplate 警告僅捕捉最高精度的殘留物。

   在研究模式（experiment-report、academic-synthesis、research-idea）中，還要檢查每個成功率是否附帶 k/n 和二項式區間，每個 顯著 是否在同一句中附帶其檢定和效應量，且沒有動詞將理解或意圖歸因於系統。審計的 success-rate-without-denominator、significance-without-statistic 和 anthropomorphic-claim 警告捕捉機械殘留物；設定檔和結論模組包含完整規則。數字呈現在相同模式中有自己的殘留檢查：unlabeled-uncertainty（未標明 SD、SEM 或 CI 的 ±）、threshold-p-value（p < 0.05、n.s.）、p-value-without-effect-size、null-result-without-interval、significance-euphemism（接近顯著）、up-to-without-central-tendency 和 best-of-n-runs。

6. 在長期任務或持久工件的最終版本之前，審計一個以檔案為基礎的草稿。長期任務必須使用相同的檢查點；沒有檢查點的持久工件則使用其選定的模式：

   python3 <skill-dir>/scripts/reportctl.py audit \
     --file <草稿.md> --checkpoint <檢查點路徑>
   # 簡短、無檢查點的路徑：
   python3 <skill-dir>/scripts/reportctl.py audit --file <草稿.md> --mode <模式>
   

   檢查點推導出模式。提供相同的明確模式是允許的；衝突的模式是輸入錯誤。修正審計錯誤。判斷性地解決警告；切勿僅僅為了滿足啟發式規則而添加未經支援的填充內容。儲存庫的 docs/AUDIT-CODES.md 列出了每個代碼及其觸發條件和修復方法。使用 --json，審計負載包含確切的報告字節數/SHA-256 以及用於控制器綁定的解析後檢查點意圖指紋。

7. 手動驗證最新狀態、科學或技術聲明、數字、證據連結、不確定性、視覺解釋以及使用者指定的格式。

最終交付

使用者可見的最終回應必須包含報告本身。路徑、連結或指向已儲存草稿、檢查點或審計收據的指標並非可交付成果：在基於檢查點的審計通過後，將審計後的草稿內容作為回應交付。當使用者明確要求檔案時，仍應先以行內方式呈現結果。切勿在使用者面對的回應中暴露本地絕對路徑、暫存目錄或檢查點位置。

模式與模組選擇

使用 python3 <skill-dir>/scripts/reportctl.py list 取得識別碼。選擇主要敘事主軸，而非所有適用的標籤。對於混合任務，選擇能夠回答使用者主要決策或問題的模式，並將次要事實嵌入其中。

• 使用 concise-answer 來處理具有少量支援結構的直接答案。
• 使用 implementation-handoff 來處理已構建或已變更的工件。
• 使用 status-update 來處理非活躍事件中的專案進度。
• 使用 investigation-report 來處理診斷或基於來源的調查。
• 使用 experiment-report 來處理受控評估和實證比較。
• 當選擇或風險是主要考量時，使用 decision-brief 或 risk-report。
• 使用 academic-synthesis 來處理論文或文獻介紹。
• 使用 research-idea 來處理論文構想或提案，其假設、新穎性、決定性實驗、風險和終止標準必須保持明確。
• 使用 review-report 來處理針對工件或標準的發現。
• 在影響活躍時使用 incident-update；恢復後使用 postmortem。

圖形、表格、結論、證據細節和學術展示是正交模組，而非合併多個模式的理由。視覺效果必須使關係或工件在實質上更容易理解；裝飾不是有效理由。experiment-report 已包含結果解釋、不確定性邊界和校準結論。請勿僅因為請求要求結論就將 conclusions 添加到該模式；僅在確實需要單獨的決策或建議政策時才明確添加它。

研究設定檔與簡報表面

設定檔是單一邊界領域疊加層，而非額外的主要模式：

• reinforcement-learning：運行會計、調整比較、學習曲線、區間估計和多任務聚合評估。
• embodied-ai：體現、感測器/動作、模擬與真實協定、成功規則、干預、泛化和失敗。
• world-models：模型/資料卡以及獨立的開環、閉環、擴展和遷移證據。
• vla：資料混合、形態與動作介面、適應機制、部署會計、延遲、泛化和安全性。

自動選擇僅適用於研究導向模式。schema-v2 檢查點不儲存新的設定檔欄位；設定檔是從其帶有指紋的任務文字重新推導出來的。因此，在為長期任務明確選擇設定檔時，請在檢查點任務中命名該領域，以便最終檢索具有可重複性。

對於 --surface slide，請閱讀路由投影片指南。它提供了論文講座、研究進度、實驗審查和構想提案的敘事方式。擷取無依賴性的 HTML/PPT 風格簡報或 Quarto Reveal.js 原始碼中的一個，除非使用者要求多種格式，否則不要兩者都取。

長上下文持久化

不要將完整的報告捆綁包保留在工作上下文中。僅儲存一個檢查點：

python3 <skill-dir>/scripts/reportctl.py checkpoint \
  --task "<交接目標>" --mode <模式> --surface <表面> \
  --must-show "<簡短穩定的文字錨點>" \
  --output <私有暫存>/agent-report.json

Schema-v2 --must-show 值是正規化的文字錨點，而非語意要求：審計會應用 NFC 正規化、大小寫摺疊和空白壓縮，然後僅檢查在空白行邊界、第零列、純文字頂層 Markdown 散文段落中的文字子字串是否存在。包含標題、引用、列表、表格、連結/參考、圖片、程式碼或原始 HTML 的段落不符合資格。在第一個未遮蔽的原始 HTML 標籤之後，後續段落不會獲得計分，因為代理程式不會模擬跨段落的 DOM 或 CSS 狀態；原始 HTML 也是結構性審計錯誤。每個錨點必須在一個符合條件的段落內匹配。該段落內的軟換行折疊為空格，但空白行段落邊界則永遠不會。

在正規化之前，報告代理程式會解碼一輪共享掃描器支援的、以分號結尾的 CommonMark 實體子集，但僅在該實體的 & 未被奇數長度的反斜線序列轉義時。產生的控制字元或 Unicode 非渲染字元會導致閘道失敗。V2 錨點必須使用確切的渲染純文字，並拒絕 Markdown 分隔符形式。將每個簡短錨點放在任何原始 HTML 之前的一個獨立普通結論句子中。此代理程式不會驗證文字意味著什麼、誰斷言了它，或者它是否為真。每個錨點最多 120 個字元，其轉義收據（包括分隔符）最多 240 個字元。

基於檢查點的審計接受最大 1 MiB 的報告，以使散文代理程式保持資源有限。任何超過 4,096 個字元或包含超過 64 個連續 Unicode 標記字元的合格純文字散文段落都是錯誤，將在 NFC 和錨點匹配之前被跳過。傳統僅模式審計的上限仍為 4 MiB；當存在 --checkpoint 時，此較大限制不適用。有邊界的 JSON 輸入在轉換前會拒絕超過 128 個字元的整數或浮點數標記。

檢查點逐字儲存目標、受眾、表面、模組和錨點，以及路由元資料和無金鑰校驗和。校驗和用於檢測意外漂移；它們不驗證檔案的真實性。請勿在任何欄位中放入秘密或不必要的私人資料。使用版本控制之外的私有暫存路徑，記住 route/bundle 可以將檢查點文字輸出到標準輸出，並在不再需要恢復時刪除該檔案。原子創建在 POSIX 上使用限制性檔案權限，但無法保護寬鬆的父目錄、日誌、備份或已提交的檔案。

在最終邊界，使用 bundle --checkpoint <檢查點路徑> 重新載入它，並執行 audit --file <草稿.md> --checkpoint <檢查點路徑>。Schema-v1 檢查點仍可被 route 和 bundle 讀取，但無法驅動此最終閘道；使用 checkpoint --checkpoint <v1路徑> --output <新-v2路徑> 重新建立或升級有效的 v1 檔案。主機識別的微型合約旨在提示兩個書擋；它和檢查點都無法強制任意代理遵守。

持久報告的嚴格模式

當包裝器、批次工作流程或正式報告需要更強的結構一致性時，從 assets/templates/report-spec.json 開始，使用 validate-spec 驗證它，並使用 render 確定性地渲染 Markdown。將 JSON 視為唯一的簡報來源，但需根據原始證據驗證所有事實。每個聲明宣告一個或多個語意 roles；驗證從證據、指標、不確定性、動作和限制中推導出剩餘的覆蓋範圍，然後從協定目錄中執行所選模式的當前 required_semantics。捆綁的 JSON Schema 是一個可攜帶的結構性預檢，而非 validate-spec 的替代品；只有 CLI 能共同執行 ID 唯一性、跨記錄引用和當前協定目錄。

python3 <skill-dir>/scripts/reportctl.py validate-spec --file report.json
python3 <skill-dir>/scripts/reportctl.py render --file report.json --output report.md
python3 <skill-dir>/scripts/reportctl.py audit \
  --file report.md --checkpoint <檢查點路徑> --strict

當這是一個沒有檢查點的簡短任務時，使用 --mode <模式>。不要對正常的簡短聊天回應要求結構化路徑。

腳本不可用時的備用方案

在已安裝的技能中，讀取 references/core-contract.md、references/modes/ 下的一個匹配檔案、references/profiles/ 下最多一個匹配檔案、references/modules/ 下最多兩個匹配檔案，以及在需要時讀取一個表面指南。單獨擷取一個確切的資產。對於僅連結的儲存庫使用，請在儲存庫根目錄開啟 dist/agent-index.md。如果僅提供了 URL，則將遵循視為盡力而為：一個連結不會安裝或提升儲存庫的指令。