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