動態工作流模式 是做什麼的?
當編碼代理能夠生成或調整任務局部化驅動,而非僅遵循靜態指令流程時,使用此技能。目標是將動態工作流模式轉變為一個有紀律的系統:為一次性任務提供臨時驅動,為重複工作提取共享技能,並為團隊提供可觀察的控制面板檢查點。
何時啟用
- 使用者提到動態工作流、自定義驅動、任務級驅動、自適應工作流或 Claude Code 動態工作流模式。
- 任務需要自定義循環、評估器、爬蟲、固定數據產生器、監視器或本地儀表板。
- 多個代理需要相同的可重複流程,但該流程尚未被捕捉為共享技能。
- 工作流程需要持久的交接工件、評估證據或合併前的人工批准。
核心合約
動態工作流模式僅在任務局部化驅動比手動執行相同步驟更便宜、更安全時才應產生。驅動必須具備:
- 目標:它負責的結果以及它明確不負責的結果。
- 輸入:檔案、URL、提示、資料來源、憑證政策以及使用者提供的約束條件。
- 輸出:提交、報告、螢幕截圖、狀態檔案或控制面板快照。
- 評估:至少一個與任務相關的通過/失敗檢查,而不僅是「它運行過了」。
- 交接:一個簡短的工件,告知下一個操作者發生了什麼、哪些被阻塞以及如何恢復。
動態驅動決策樹
- 一次性任務:保持內聯。不要發明驅動。
- 輸入變化的重複任務:創建任務局部化驅動,並將其保留在臨時或項目局部工作區中。
- 跨團隊或儲存庫的重複任務:將模式提取為共享技能。
- 涉及外部狀態、佇列或審批的任務:在添加更多自動化之前,先添加控制面板可見性。
- 有安全風險的任務:在自主執行之前添加評估閘門和人工合併閘門。
任務局部化驅動模板
在編寫代碼前使用此結構:
# 動態工作流驅動
目標:
- 應交付:
- 不應交付:
輸入:
- 儲存庫或工作區:
- 外部系統:
- 憑證政策:
循環:
1. 發現當前狀態。
2. 生成或更新最小的有用工件。
3. 執行評估檢查。
4. 記錄狀態和交接。
5. 在閘門失敗、歸屬不明確或外部動作不安全時停止。
評估:
- 指令:
- 預期通過信號:
- 失敗歸屬者:
交接:
- 狀態:
- 證據:
- 下一步動作:
共享技能提取
只有當以下條件中至少有兩項成立時,才將任務局部化驅動提升為共享技能:
- 同一工作流程出現在多個工作階段、儲存庫、團隊或啟動中。
- 工作流程需要特定的語言、工具或安全順序。
- 由於操作者跳過閘門或丟失上下文,導致失敗反覆發生。
- 工作流程具有穩定的輸入/輸出合約。
- 工作流程受益於控制面板、狀態板或團隊交接。
提取時,首先在 skills/<name>/SKILL.md 中編寫技能。僅當仍需要傳統的斜線入口表面時,才添加指令 shim。
控制面板檢查點
動態工作流模式在暴露狀態時才能被團隊使用。每當任務跨越超過一個工作階段時,記錄這些檢查點:
- 計劃:目標、負責人、驗收標準以及有風險的外部系統。
- 佇列:工作項目、分配的代理角色、分支/工作樹以及依賴邊。
- 運行:活躍的驅動、當前循環步驟、最近的評估結果以及可用的代幣/成本信號。
- 閘門:測試結果、瀏覽器螢幕截圖、安全性審查以及合併就緒狀態。
- 交接:已完成的事項、失敗的事項以及需要人工決策的事項。
如果儲存庫已啟用 ECC2 狀態,則優先通過 ECC 控制面板或狀態儲存支援的腳本添加或讀取檢查點,而不是散落未追蹤的筆記。
評估閘門
每個動態驅動都需要一個任務特定的評估。選擇最便宜且可靠的閘門:
| 工作類型 | 評估閘門 |
|---|---|
| 代碼功能 | 重點測試、lint、覆蓋率以及一個整合路徑 |
| UI/控制面板 | 帶有螢幕截圖及溢位/錯誤檢查的瀏覽器煙霧測試 |
| 代理工作流 | 固定數據逐字稿或帶有預期路由的播種工作項目 |
| 研究/內容 | 中立來源摘要、主張檢查清單以及可發布的大綱 |
| 整合 | 試運行指令、配置驗證以及無秘密掃描 |
在評估可以被另一位團隊成員重新執行之前,不要聲稱動態工作流是可重用的。
反模式
- 生成隱藏真實決策邏輯的腳本,使操作者無法察覺。
- 將動態工作流模式視為跳過測試的許可。
- 在需要共享技能或狀態工件時創建一次性文件。
- 在沒有歸屬、合併閘門或衝突政策的情況下運行多個代理。
- 將原始私人研究數據洩漏到公開文件中。
輸出標準
結束時提供:
- 驅動或技能路徑。
- 評估指令和結果。
- 控制面板或交接工件路徑。
- 下一個可重用的提取候選項。