← 返回 Director Mode Lite

WORKFLOW / 三個 CLI

GUIDANCE-FIRST WORKFLOW

一份 brief，一個有邊界任務，任一 CLI。

director-mode 與 session-relay 兩個核心 Skills 在 plugin-only 安裝也有 bundled fallback。同供應商用原生 resume；跨供應商則從預設 unreviewed 的 packet 開新接手端原生 session。

Claude CodeCodex CLIGrok Build

BOUNDARY / NATIVE CONTROLS

預設只給指引，權限留在原生。

Director Mode Lite 不加入隱藏 approval layer、deny rule、forced workflow，也不隱式改權限；director-open 是可信任 workspace 的獨立選擇。

  • 預設安裝：零 Director Mode hooks。
  • Plugin-only：兩個核心 Skills 保留 guide、relay 與 doctor fallback。
  • Runtime assets 或 hooks 不清楚時，執行唯讀 director-doctor。
  • 把 packet 主張視為待驗證證據，不把驗證做成干擾使用者的關卡。

METHOD / EVIDENCE

五階段證據路徑

只採用能推進任務的最小階段；繼續前先讓證據可見。

  1. 01 / FRAME

    寫 Director Brief

    說明目標、相關 context、限制、done-when 證據與未決問題。

    Artifact：可審查任務 brief
  2. 02 / INSPECT

    讓當前 CLI 落地

    只檢查下一個決策需要的 files 與 documentation。

    Artifact：引用 files 與目前行為
  3. 03 / CHANGE

    做有邊界的修改

    完成能滿足一項驗收結果的最小一致修改。

    Artifact：聚焦 diff
  4. 04 / CHECK

    執行原生檢查

    使用專案 tests、lint、type checks、build 與 review 規則，不看泛用成功標籤。

    Artifact：commands 與實際 output
  5. 05 / DECIDE

    接受、修改、交接或停止

    用 evidence 對照 done-when；只有下一步理由明確才繼續。

    Artifact：明確決定與剩餘風險

PORTABLE / BRIEF

可攜 Director Brief

Brief 刻意維持精簡，能跨 CLI 交接，不必拖著完整 transcript。

01 / 目標
一個可觀察結果，以行為變化描述。
02 / CONTEXT
只保留當下需要的 files、docs、errors 與 decisions。
03 / 限制
Architecture、compatibility、安全與範圍邊界。
04 / 完成條件
具名檢查與 review 證據，不是完成感。
05 / 未決問題
下一位 worker 行動前必須確認的事實。

EXAMPLE / PLAIN TEXT

CLI-neutral 起始 prompt

在任一支援 CLI 貼上或調整；實作前補入 repository paths 與真實 commands。

目標：新增一個可觀察行為。
Context：列出相關 files、docs 與失敗證據。
限制：保留 public APIs 與 CLI 原生安全控制。
完成條件：指定 tests、lint、build 與 diff 證據。
未決問題：記錄不確定性，不要隱藏。

ADAPTERS / NATIVE SURFACES

轉譯方法，不轉譯權限

把長期指引放在工具原生 project surface，把任務細節放在當前 prompt。

CLI長期指引SESSION 用法驗證方式
Claude CodeCLAUDE.md 與已安裝 Claude assetsdirector-open claude 或原生啟動專案檢查 + diff
Codex CLIAGENTS.md 與已安裝 Codex assetsdirector-open codex 或原生啟動專案檢查 + diff
Grok Build.grok agents 與相容 assetsdirector-open grok 或原生啟動專案檢查 + diff

HANDOFF / SESSION-RELAY

只在 handoff 有幫助時 relay

session-relay 建立 director-handoff/v2、可讀 v1，以 --parent 記錄多 hop lineage，並用 status --json 比對 live worktree。Packet 預設 review_status: unreviewed；validate 與 status 都不等於審查。

.director-mode/bin/director-doctor --json --no-probe
.director-mode/bin/director-relay create \
  --from claude --to codex \
  --goal "Finish one bounded outcome" \
  --summary "Verified state only" \
  --next "First concrete next step" \
  --verification "Command and observed result"
# Later hop: repeat create with --parent
.director-mode/bin/director-relay validate
.director-mode/bin/director-relay status --json
.director-mode/bin/director-relay continue --to codex
  1. R-01 / 準備

    摘要已驗證事實、changed files、checks、結果與剩餘不確定性。

  2. R-02 / 審查

    移除推測、secrets、無關 transcript 與無證據主張；真的審查後才明確記錄。

  3. R-03 / 交接

    同供應商用原生 resume；跨供應商開新的原生 session。

  4. R-04 / 再驗證

    接收 CLI 在繼續前重查目前 files、Git state 與 evidence。

DECISION / HUMAN-REVIEWABLE

乾淨的停止規則

停止是正常結果，不是 automation 失敗。

接受

Done-when 證據齊全，review 沒有 blocking issue。

修改

目標仍有效，但 evidence 顯示一項有邊界修正。

交接

不同 CLI 或新 session 有明確優勢，且收到已檢查 handoff。

停止

權限、context、evidence 或使用者意圖不足。