Community生產力與協作github.com

promptbyprompt/agent-briefs

在委派工作前撰寫一頁的簡報。每當你啟動子代理(Agent tool)、工作流程、背景任務或任何需要多步驟的長時間任務給另一個 Claude,以及規劃大規模分階段建置時,都應使用此技能。

agent-briefs 是什麼?

此技能提供了一套結構化方法,用於在啟動子代理或長時間任務前撰寫簡報。它確保代理擁有所有必要資訊:目標、可衡量的完成標準、硬性規則、時間與測試預算、優先級、可互換的交付成果,以及固定的回報格式。此技能從根本上解決了子代理從空白記憶體開始、不知道所處更大脈絡與特定約束的問題。它透過一套標準步驟來引導使用者:先用規劃代理拆解大型任務,再為每個階段撰寫簡報;處理品質工作時先收集參考資料;並且建立一個「看門狗」機制來監控超過預算的任務。此技能支援常見的代理工具與工作流程平台(如 Claude Code、Coding Agent、其他協作終端),其模式適用於任何 Linux、macOS 或雲端環境。簡報本身利用 Markdown 模板來強制執行紀律,例如引用業主原話、要求可驗證的完成標準、限制測試範圍,以及要求固定的回報格式。這避免了代理在長時間任務中偏離軌道或做出無法記錄之決策的常見痛點。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/promptbyprompt/claude-brief-kit/tree/HEAD/agent-briefs

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

代理簡報

子代理從空白記憶體開始。它只知道你寫入的內容。在啟動任何子代理、工作流程或長時間任務之前,請使用此技能資料夾中的 templates/brief.md 撰寫一份簡報。

步驟

  1. 包含多個部分的大型任務:首先執行一個使用 templates/planner.md 的規劃代理。它會回傳 5 到 8 個階段,每個階段都有一個可衡量的 done_when。接著每個階段都會獲得自己的簡報。
  2. 品質工作(音樂、音效、視覺、寫作風格):首先遵循 templates/reference.md。收集 2 到 3 個參考資料,測量它們,寫出差異,製作一個樣本,並讓業主在進行後續工作前進行判斷。
  3. 使用 templates/brief.md 的每個標題來撰寫簡報。在不相關的標題下寫上「無」。將 templates/test-policy.md 貼入每個會建置或修改內容的簡報中。
  4. 在建置步驟之後,讓 2 或 3 位評論員(來自 templates/critic.md)基於相同的記錄材料,並行進行審查。將合併後的 must_fix 列表交給一個修復代理。
  5. 在每個運行時間超過約 15 分鐘的代理旁啟動一個看門狗(見下文)。
  6. 告訴使用者你啟動了什麼、預算以及一個誠實的估計。說明哪些部分是不確定的。

每份簡報的規則

  • 先閱讀:指向檔案和章節,而非貼上長篇幅的上下文。
  • 引用業主的話(如有需要則翻譯),讓代理看到真正被要求的是什麼。
  • 如果業主不在,請說明:「業主無法回答。請自行決定並記錄每一個決策。」
  • 完成標準必須能透過腳本、測試或測量來驗證。使用數字和範圍。
  • 代理無法像人類一樣觀看或聆聽。讓它進行測量(螢幕截圖、影格數、音量、峰值),在報告中說明哪些部分無人查看或收聽,並將品味判斷留給業主。
  • 每份簡報都有一個時間預算、一個測試預算和一個停止規則:「時間用盡時,停止,記錄未完成的部分,然後回報。」長時間任務也需設定檢查點(「在 2 小時時,如果 X 尚未開始,則回退到 Y」)。
  • 未經限制,切勿寫入「重新運行所有先前的測試」或「保持一切正常運作」。僅測試新部分位於其位置的功能;僅在你修改了舊測試所涵蓋的內容時才重新運行它。
  • 列出優先級,以便時間耗盡時有所依據,最重要的優先,並說明其餘部分的處理方式。
  • 交付成果應保持其取代項目相同的名稱、格式和長度,以便下一步可以將其替換。
  • 一個進度檔案會為每個完成的片段加上時間戳記行,這樣即使工作中斷,成果也能保存。
  • 硬性規則需說明原因(「絕不儲存 X:儲存會抹除其參考資料」)。
  • 將先前的失敗作為規則傳承下去(「先前的片段播放為黑畫面:請使用 Main profile 和 yuv420p」)。
  • 為有風險的支線任務設定時間限制:「最多花 15 分鐘在上面,然後回退到 Y。」
  • 並行代理需要範圍區隔:「步驟 3 不是你的工作:請勿觸碰 A 或 B。」
  • 要求固定的回報格式:完成了什麼、跳過了什麼及原因、測量結果、測試時間、已用時間、對剩餘工作的估計、檔案位置。

看門狗

在每個長時間運行的代理旁,啟動一個背景命令,該命令會等待時間預算到達,然後輸出一行:

sleep 5400; echo "BUDGET exceeded: stage 3 (90 min)"

在背景中執行它(Claude Code 會在它完成時通知你)。當它觸發時:讀取代理的進度檔案,然後指示代理結束並回報,或停止它,或延長一次預算並告知使用者。如果代理提前返回,則停止看門狗。

相關技能