情境:記錄變形金剛IPAS_CORE SubAgent核心成員 ,用途DEBUG根因分析用途,可協助剖析教練考系統為何出錯?
🛠️ Part 1. Deep-RCA-Expert 除錯顧問誕生
費曼比喻:建立 Subagent 就像在公司內部臨時面試並僱用一位專屬顧問。
[Step 1: 定義角色履歷] ──> define_subagent(名稱, 職責, 權限)
│
[Step 2: 派發工作任務] ──> invoke_subagent(目標, 提示詞, 工作區)
│
[Step 3: 獨立思考與回報] ──> 在背景對話處理,完成後以高優先級訊息主動 Handshake
詳細步驟說明:
- 第一步:定義履歷 (`define_subagent`) — 在系統中註冊 Agent 的專能(如 Codebase Investigator)。
- 第二步:實體化與啟動 (`invoke_subagent`) — 系統為其分配獨立的
conversationId與工作區沙盒。 - 第三步:非同步溝通與對位 — Subagent 完成診斷後,將成果寫回主脈絡。
⚖️ Part 2. `deep-rca-expert` vs `7D_COACH_SENTINEL` 差異對照
| 比較維度 | deep-rca-expert (診斷程式BUG外科醫生 🩺) | 7D_COACH_SENTINEL (考核總教官 🥋) |
|---|---|---|
| 費曼比喻 | 專門開刀抓出盲腸炎的急診外科醫生 | 站在旁邊進行考核與評分的系統總教官 |
| 核心職責 | 深入單點故障、死鎖 (Deadlock)、IO 卡死排查與重構 | 7D+2 體系合規性、教練考流程引導與 教學SYS條款落實度評估 |
| 工作風格 | 深入 Code 裡面抓 Bug、計算 Timeout、實作非阻塞鎖 | 觀念質詢、評估學員答覆、維持教練考嚴肅性(豁免精簡回覆) |
| 觸發時機 | 系統發生死鎖、CLI 被 kill、I/O 拋出 Exception 時 | 使用者要求「教練考」、「7D 評估」、「憲章考核」時 |
👥 Part 3. IPAS_CORE 成員與 Subagent 使用矩陣圖
========================================================================
IPAS CORE MEMBER & AGENT MAP
========================================================================
│
┌───────────────────────┴───────────────────────┐
▼ ▼
[工程實作組: Engine & IO] [教學與治理組: Governance]
- ipas_io_bridge.py - Agent_Prime_Directive.md最高指導RULE
- ipas_runner.py - teaching_engine.py 教學核心引擎
- ipas_db_engine.py - lexicon.py
│ │
▼ ▼
【調用 deep-rca-expert】 【調用 7D_COACH_SENTINEL】
- 處理 global_scope.lock 死鎖 - 觸發 7D+2 教練考評估
- 解決 tasklist 2.0s 超時 - 檢查 教學SYS 憲章條款落實
- 執行 OllamaResourceLock 降級 - 執行觀念問答與考核
🔬 IPAS_CORE 六大成員科學對位解說 (Scientific Alignment)
將每個 IPAS Core 檔案對應至計算機科學 (CS) 原理與 教學SYS體系運作機制
核心成員檔案 CS 計算機科學原理 IPAS教學SYS體系科學職責與對位 ipas_io_bridge.pyNon-blocking Lock & Deadlock Avoidance 管理 Windows/Linux 跨平台鎖,實作 2.0s 超時防禦與 10s 輪詢降級,解決卡死。 (對位: deep-rca-expert) ipas_runner.pySingle Entry Point & Telemetry Signal CLI 進入點,安裝 Stdout 攔截器,將執行進度轉化為 [SEC-PROGRESS] 心跳脈衝,防止黑箱執行強制於一定時間內做回應。 ipas_db_engine.pyAppend-Only Ledger & Atomic Disk Sync 負責讀寫 system_health.jsonl(科學底氣,記錄系統出錯原因,後續供AI_TUTOR讀取系統曾發生的問題做檢討),強制執行 RFC 8259 無 BOM UTF-8 編碼落盤。 Agent_Prime_Directive.mdImmutable Policy & System Constitution 全系統 SSoT 唯一權威真相來源(如:專案開發目錄、產出目錄..),收錄 最高指導RULE,具備最高治理約束力。 teaching_engine.pyAdaptive State Machine & Knowledge Alignment 驅動 7D 費曼教學與考題引擎,控制考題脈絡與評分對錯。 (對位: 7D_COACH_SENTINEL) lexicon.pyOntology & Semantic Versioning 定義系統統一版本號 (SYSTEM_VERSION) 與領域名詞映射,防止版本歧異。
編碼前綴 最高指導 RULE / 框架名稱 核心領域與職責描述 CORE Core Architecture Framework 核心自律與憲法基石。定義單一真理源、衍生禁令、原子化修訂及邏輯抽象性門禁。 AUDIT Audit Defense Protocol 物理對位與審計防衛。檢測實體檔案與日誌對位,防範「物理審計赤字 (SEC-AUDIT-DEFICIT)」。 LOG Log Sovereignty Protocol 日誌主權與內聚補登。規定 system_health.jsonl 主權壟斷,嚴禁幽靈路徑與雙頭備份。 ARCT / ARCH Architectural Binding Framework 系統層級與拓撲約束。實施 L0-L3 遺傳綁定、單跳 (Single-hop) 溯源及廢除 L2 中間層。 EXEC Execution & Output Protocol 教學 SYS 執行標準。強制絕對路徑、結構化標頭輸出與 JSON Schema 解析約束。 EVO Sustainability & Anti-Redundancy 永續演進與反疊床架屋。禁止重複創建功能類似的模組,優化現有成員內聚性。 ALARM / MON Health & Fatigue Monitoring 系統狀態與邏輯疲勞監測。當檢測到推理迴圈時,強制清空 Context 並重新載入憲法。 PERF Performance & Hardware Opt 效能加速與資源調優。涵蓋 OpenVINO 推理前處理優化、記憶體與 I/O 瓶頸消除。 DATA Data Integrity & Lineage 資料誠信與血統導向。涵蓋歷屆真題與模擬題庫之物理隔離,禁止幻覺與標籤偽造。 OPS Operations & Methodology Protocol 運營與教學教練法。包含 7D+2 深度解析(D1-D7 映射)、艾賓浩斯記憶與數學脫毒。 SAFE Security & Safety Guardrails 安全防護欄。防止敏感資訊外洩、權限溢出及非授權的檔案篡改。 GATE Quality Gate & CI/CD Pipeline 品質硬性門禁。如 [SEC-GATE-*],程式碼合併或執行前必須通過驗證。
優先級 (Priority) RCA 層級焦點 (Layer Focus) 系統狀態與症狀 (Symptoms) 機制 (Defense Mechanism) 🔴 P0 Emergency Critical Blocker
Physical & Hardware System Crash
- OOM / Access Violation / SegFault
- Missing Target Binary / File Access
Physical SSoT Gatekeeper
Explicit Path Assert
🟠 P1 High-Freq Environment Gap
Binary Dependency & Path Resolution
- CommandNotFound (ffmpeg Missing)
- Unicode Path Offset (C:\Users...)
Native Python Dynamic
Linkage & Unicode Normalization
🟡 P2 Medium-Freq Temporal Coupling
Async Barrier & Visual Scene Boundary
- Race Condition (Async Task Phase)
- Sampling Motion Blur (Frame Offset)
Barrier Sync Protocol
DiffScore Tensor Maxima
🔵 P3 Low-Freq Observer & Silent
Exception Swallowing & Latency
- Broad try-except Masking Root Cause
- Test Logger IO Latency Degradation
Zero-Silent Failure
In-Memory Read-Only Op
⚪ P4 Monitoring Architecture Overhead
Redundant Layering & Sub-optimal Engine
- Multi-wrapper Pipeline Bloat
- Repeated Neural Weight Loading
Anti-Redundant Layering
OpenVINO Engine Synergy
1. P0 區間 (Blocker): 最高優先級防線,專注守護硬體、實體記憶體與執行檔存在性,避免底層崩潰。
2. P1 區間 (Environment Gap): 最常見的環境執行差距(Eliminate OS PATH Dependencies)。如環境缺乏二進位檔(如 ffmpeg),自動降級回退到 Python 原生動態庫處理。
3. P2 區間 (Temporal Shift): Eliminate Race & Phase Lag,透過 manage_task(status) 與物理張量差分切點演算法,精準消除非同步進程與視訊幀採樣的時間相位差。
4. P3(In-Memory InspectionEliminate Observer Effect & Silent Catch)
P4 區間 (Observer & Synergy): 採用無靜默捕捉(Zero-Silent Catch)避免抑制根本原因,結合記憶體讀取與 OpenVINO 加速,防止觀測者效能污染。