代理簡報
子代理從空白記憶體開始。它只知道你寫入的內容。在啟動任何子代理、工作流程或長時間任務之前,請使用此技能資料夾中的 templates/brief.md 撰寫一份簡報。
步驟
- 包含多個部分的大型任務:首先執行一個使用
templates/planner.md的規劃代理。它會回傳 5 到 8 個階段,每個階段都有一個可衡量的done_when。接著每個階段都會獲得自己的簡報。 - 品質工作(音樂、音效、視覺、寫作風格):首先遵循
templates/reference.md。收集 2 到 3 個參考資料,測量它們,寫出差異,製作一個樣本,並讓業主在進行後續工作前進行判斷。 - 使用
templates/brief.md的每個標題來撰寫簡報。在不相關的標題下寫上「無」。將templates/test-policy.md貼入每個會建置或修改內容的簡報中。 - 在建置步驟之後,讓 2 或 3 位評論員(來自
templates/critic.md)基於相同的記錄材料,並行進行審查。將合併後的must_fix列表交給一個修復代理。 - 在每個運行時間超過約 15 分鐘的代理旁啟動一個看門狗(見下文)。
- 告訴使用者你啟動了什麼、預算以及一個誠實的估計。說明哪些部分是不確定的。
每份簡報的規則
- 先閱讀:指向檔案和章節,而非貼上長篇幅的上下文。
- 引用業主的話(如有需要則翻譯),讓代理看到真正被要求的是什麼。
- 如果業主不在,請說明:「業主無法回答。請自行決定並記錄每一個決策。」
- 完成標準必須能透過腳本、測試或測量來驗證。使用數字和範圍。
- 代理無法像人類一樣觀看或聆聽。讓它進行測量(螢幕截圖、影格數、音量、峰值),在報告中說明哪些部分無人查看或收聽,並將品味判斷留給業主。
- 每份簡報都有一個時間預算、一個測試預算和一個停止規則:「時間用盡時,停止,記錄未完成的部分,然後回報。」長時間任務也需設定檢查點(「在 2 小時時,如果 X 尚未開始,則回退到 Y」)。
- 未經限制,切勿寫入「重新運行所有先前的測試」或「保持一切正常運作」。僅測試新部分位於其位置的功能;僅在你修改了舊測試所涵蓋的內容時才重新運行它。
- 列出優先級,以便時間耗盡時有所依據,最重要的優先,並說明其餘部分的處理方式。
- 交付成果應保持其取代項目相同的名稱、格式和長度,以便下一步可以將其替換。
- 一個進度檔案會為每個完成的片段加上時間戳記行,這樣即使工作中斷,成果也能保存。
- 硬性規則需說明原因(「絕不儲存 X:儲存會抹除其參考資料」)。
- 將先前的失敗作為規則傳承下去(「先前的片段播放為黑畫面:請使用 Main profile 和 yuv420p」)。
- 為有風險的支線任務設定時間限制:「最多花 15 分鐘在上面,然後回退到 Y。」
- 並行代理需要範圍區隔:「步驟 3 不是你的工作:請勿觸碰 A 或 B。」
- 要求固定的回報格式:完成了什麼、跳過了什麼及原因、測量結果、測試時間、已用時間、對剩餘工作的估計、檔案位置。
看門狗
在每個長時間運行的代理旁,啟動一個背景命令,該命令會等待時間預算到達,然後輸出一行:
sleep 5400; echo "BUDGET exceeded: stage 3 (90 min)"
在背景中執行它(Claude Code 會在它完成時通知你)。當它觸發時:讀取代理的進度檔案,然後指示代理結束並回報,或停止它,或延長一次預算並告知使用者。如果代理提前返回,則停止看門狗。