2026年9月26日 星期六

SubAgent自行定義專屬顧問

情境:記錄變形金剛IPAS_CORE  SubAgent核心成員 

🛠️ Part 1.  Deep-RCA-Expert 除錯顧問誕生

費曼比喻:建立 Subagent 就像在公司內部臨時面試並僱用一位專屬顧問。

[Step 1: 定義角色履歷] ──> define_subagent(名稱, 職責, 權限)
        │
[Step 2: 派發工作任務] ──> invoke_subagent(目標, 提示詞, 工作區)
        │
[Step 3: 獨立思考與回報] ──> 在背景對話處理,完成後以高優先級訊息主動 Handshake

詳細步驟說明:

  1. 第一步:定義履歷 (`define_subagent`) — 在系統中註冊 Agent 的專能(如 Codebase Investigator)。
  2. 第二步:實體化與啟動 (`invoke_subagent`) — 系統為其分配獨立的 conversationId 與工作區沙盒。
  3. 第三步:非同步溝通與對位 — 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 SignalCLI 進入點,安裝 Stdout 攔截器,將執行進度轉化為 [SEC-PROGRESS] 心跳脈衝。
ipas_db_engine.pyAppend-Only Ledger & Atomic Disk Sync負責讀寫 system_health.jsonl,強制執行 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) 與領域名詞映射,防止版本歧異。