Theme / v0.21.4

Oh My Codex (OMX)

Codex CLI 工作流增強層

指令詳解

$deep-interview 指令詳解

如何使用 $deep-interview 啟動蘇格拉底式互動訪談,在動手前收斂模糊的需求與架構分歧

指令用途

軟體開發中最昂貴的錯誤是「會意錯誤」——AI 助手誤解了開發者的意圖,寫出了成百上千行代碼後,開發者才發現方向完全錯了。在文字描述模糊的任務中,直接動工是極其危險的。

$deep-interview 是 OMX 中的 蘇格拉底式互動需求澄清引擎。當遇到複雜或不確定的任務時,它會強行切斷 AI 的「寫代碼直覺」,改為以「面試官」的角色向開發者提出 2-3 個最具穿透性的架構問題(例如:「是要繼承現有的 Class A,還是新建一個 Interface B?」)。這能在動手前迅速收斂模糊空間,達成人機共識。


運作流程

  1. 特徵掃描:分析任務描述,找出潛在的設計分歧點。
  2. 生成結構化問卷:列出最多 3 個多選題或簡答題。
  3. 阻塞等待:停止代碼修改,阻塞線程,直至開發者輸入回答。
  4. 決策記錄:將回答轉換為 proposal.md 規格,並以此為指導生成任務。

實戰對話範例

範例:重構 API 路由時的需求澄清

  • You:
    omx $deep-interview "重構 PaymentService 的接口"
  • AI:

    [OMX] Deep Interview Mode

    為了在重構 PaymentService 時不破壞現有的微服務依賴,請回答以下 2 個架構問題:

    1. 接口兼容性

      • [A] 保留舊的同步 Charge(),新增 V2 非同步 ChargeAsync() (向後兼容,推薦)。
      • [B] 直接破壞性將 Charge() 改為非同步 (需要同步修改所有 12 個上游呼叫者)。
    2. 依賴注入 (DI)

      • [A] 在構造函數中顯式注入 HttpClient
      • [B] 使用 IHttpClientFactory 獲取。

    請輸入您的選擇(例如:1A, 2B),以便我為您產出精確的任務清單。