AgenticWorkflow：通用代理技能與執行工具鏈
一個多能幹細胞框架與多代理執行引擎，能將複雜任務轉化為確定性、可自我驗證的自主工作流程。
執行不變量
$$\text{意圖} \xrightarrow{\text{研究}} \text{計劃（SOT state.yaml）} \xrightarrow{\text{實作}} \text{4 層品質閘門} \xrightarrow{\text{pACS Delta}} \text{已驗證交付成果}$$
⚡ 動態模式路由器
從上下文或明確標記中偵測所需的模式：
| 模式 | 觸發短語 | 核心執行流程 |
|---|---|---|
| 1. 設計 | "設計工作流程"，"新增管線"，"workflow.md" | 研究 → 規劃 → 實作 3 階段藍圖生成 |
| 2. 執行 | "執行工作流程"，"運行管線"，"開始步驟" | SOT 狀態機驅動器，逐步產生交付成果 |
| 3. 自動駕駛 | "autopilot"，"全自動"，"放手執行" | 自動批准 (human) 檢查點並記錄決策；強制執行安全鉤子 |
| 4. ULW | "ulw"，"ultrawork"，"最高嚴謹度" | 3 個增強器：西西弗斯持續性、強制分解、重試升級 |
| 5. 驗證 | "驗證步驟"，"品質閘門"，"執行 pacs" | L0 反跳過 → L1 驗證 → L1.5 pACS → L2 對抗審查 |
| 6. 最佳化 | "最佳化工作流程"，"縮短週期時間"，"精簡流程" | 精實瓶頸分析、自動化評分、週期時間壓縮 |
3 項絕對標準（憲法準則）
由本技能創建或治理的每個工作流程、工具和子代理均嚴格繼承這 3 項絕對標準：
- 絕對標準 1：最終交付品質
完全忽略速度、token 成本、工作負載和長度限制。每個決策的唯一標準是最終交付成果的品質。
- 絕對標準 2：單檔案 SOT + 分層記憶體
所有共享狀態集中在單一檔案（
state.yaml）中。SOT 寫入權限僅屬於編排器/團隊領導。並行代理絕不同時變異共享檔案。 - 絕對標準 3：程式碼變更協議 (CCP)
在編寫、修改、新增或刪除程式碼之前，內部執行：步驟 1 (理解意圖) → 步驟 2 (漣漪效應分析) → 步驟 3 (變更計劃)。受編碼錨點 (CAP-1~4) 管轄。
4 層品質保證堆疊
flowchart TD
StepStart["步驟執行"] --> L0["L0：反跳過物理防護（檔案存在且 >= 100 位元組）"]
L0 -->|透過| L1["L1：驗證閘門（100% 功能目標達成）"]
L0 -->|失敗| Diag["反事實診斷"]
L1 -->|透過| L15["L1.5：pACS 自我評分（F/C/L 預設評分）"]
L1 -->|失敗| Diag
L15 -->|紅色：<50| Diag
L15 -->|綠色 / 黃色| L2["L2：對抗審查（@reviewer + @fact-checker）"]
L2 -->|透過| SOT["推進 SOT (current_step + 1)"]
L2 -->|失敗| Diag
Diag --> Retry["使用替代假說重試（最多 3 次）"]
- L0 反跳過守衛：確定性驗證交付成果存在於磁碟上且非空值（
MIN_OUTPUT_SIZE >= 100 位元組）。 - L1 驗證閘門：語意驗證所有驗收標準 100% 達成。
- L1.5 pACS（預測代理信心分數）：針對忠實性、完整性、邏輯進行預設評估。$pACS = \min(F, C, L)$。
綠色 (>= 70)：自動推進。黃色 (50 - 69)：在決策日誌中標記弱項維度並繼續。紅色 (< 50)：停止並觸發重做。
- L2 對抗審查：由
@reviewer和@fact-checker進行獨立的生成器-評論家評估。
工作流程最佳化引擎（精實與自動化）
在分析或最佳化工作流程時：
- 瓶頸嚴重性：對瓶頸評分 1 至 5。
- 自動化潛力：量化手動任務以進行代理委派。
- 錯誤減少：在故障傳播前，於根本原因處實施品質閘門。
- 週期時間縮短：目標在提升交付品質的同時，將週期時間減少 >= 40%。
自主自我驅動引擎與熔斷機制
系統作為一個端到端的自主引擎運行，內建能源管理功能：
- 自我驅動與能量循環：動態監控 token 和上下文餘量，在上下文耗盡前自動執行 RLM 狀態壓縮和補充燃料檢查點。
- Fable 熔斷機制：狀態轉換
關閉→開啟→半開。當連續失敗次數 $\ge 2$ 時自動停止推測性空轉，透過反事實診斷（diagnose_context.py）隔離根本原因，並執行結構化復原。 - 整潔程式碼守衛：自動化 AST 守衛檢查，通過 24 項整潔程式碼命令（小函式、意圖揭示命名、最多 4 個參數、不吞沒例外、不偽造成功模擬）。
- AI 工程評估：整合四分之五差異影響測試（$\ge 0.80$）、PSI 分佈漂移監控，以及對抗性提示注入清理。
CLI 與工具鏈整合
# 啟動具備自我驅動與能量管理的端到端自主自動駕駛工作流程
agentic-workflow autopilot --title "生產管線" --goal "自主交付"
# 執行整潔程式碼守衛審計檢查（SOLID、24 項命令、AI 故障模式）
agentic-workflow guard [目錄]
# 執行 AI 工程師公平性、漂移和提示注入評估閘門
agentic-workflow eval
# 查詢多代理可觀測性追蹤日誌和跨度
agentic-workflow traces
# 初始化基礎設施、SOT 執行時目錄和健康檢查
agentic-workflow init
# 驗證工作流程架構、SOT 完整性和 pACS 日誌
agentic-workflow validate
# 檢查即時工作流程儀表板和可觀測性指標
agentic-workflow status
# 執行完整自動化測試套件（安全性、守衛、MAS、評估器）
agentic-workflow test
參考對映表
- 架構與 DNA：
soul.md、AGENTICWORKFLOW-ARCHITECTURE-AND-PHILOSOPHY.md - 操作手冊：
AGENTICWORKFLOW-USER-MANUAL.md - 通用指令：
AGENTS.md、CLAUDE.md、GEMINI.md - 協議：
docs/protocols/(autopilot-execution、quality-gates、ulw-mode、code-change-protocol、context-preservation-detail) - 子代理：
.claude/agents/(reviewer、fact-checker、translator) - 腳本：
.claude/hooks/scripts/(context_guard、validate_pacs、validate_review 等)