本機狀態

預設位置

Platform	State root
Windows	%LOCALAPPDATA%\Codex\workflow-skill-router
macOS	~/Library/Application Support/Codex/workflow-skill-router
Linux	${XDG_STATE_HOME:-~/.local/state}/codex/workflow-skill-router

設定 WORKFLOW_SKILL_ROUTER_DATA_DIR 可改用其他目錄。Runtime 會拒絕把 state path 放在 Plugin install/cache 邊界內。

儲存內容

Personal Routing Profile 放在相同外部資料根目錄下的 profiles/personal/*.json。Workspace Profile 仍由專案擁有，固定為 .codex/workflow-skill-router.json；MCP 模式還要求該 root 已由 Client 公告，或存在於 WORKFLOW_SKILL_ROUTER_WORKSPACE_ROOTS。Profile 不放進 Plugin cache。

Profile 是 strict routing data，不是 executable instructions。已存在但無效的檔案會 fail closed；有效匹配也只是 intended-unverified，仍要由 Runtime Capability Discovery 檢查所選 SKILL。

Bundled local R0 會儲存 durable plan records、state versions、idempotency keys、workflow/work-graph IDs、envelope decisions 與 objective digests；local plan table 不會儲存明文 objective。Verified Host integration 可在不同 authority 下增加 event、projection、artifact 與 evaluation stores。

Upgrade 與移除

state root 會解析到 Plugin 安裝／快取邊界之外。自動化的 local-root replacement 演練已驗證：保留這個外部路徑時，resolver 能持續找到相同的 state；但它不代表已驗證真實 codex plugin remove 後再重新安裝仍會保留 state。Windows/macOS/Linux 的完整生命週期驗證仍是尚未完成的 release-candidate migration evidence。

仍需要 audit history 或 resumable work 時，請保留這個外部 state path。進行 upgrade 或移除流程前，記錄明確路徑；在完成對應的生命週期證據前，請將任何 state 保留結果視為未驗證。

移除任何 state file 前，先停止 active Router processes，並確認沒有 Goal 依賴該狀態。只移除已檢查過的明確檔案或目錄；專案不會把 uninstall 視為靜默遞迴刪除的授權。

檢查 readiness

python plugins/workflow-skill-router/runtime/workflow_skill_router.pyz doctor

預設不啟用 telemetry。已設定的 model adapter 可能使用 provider quota；其 evidence 與 retention policy 必須另外揭露。

Adaptive Workflow Memory 公開契約

公開介面共有 20 個 MCP tools。Memory 將 Operational DB 與 Optional Memory DB 分開；Managed write 只允許 managed-personal、managed-workspace-local，User-owned Profile 仍保留原本的寫入權限邊界。

四項決策彼此獨立：Policy autonomy、可信 Workspace binding、Profile ownership／target authority，以及 Runtime／Side-effect execution authority。可信 root 不等於 Host write grant。

沒有 receipt evidence 時，Skill consistency 必須標示為 unavailable；intended-unverified 只是規劃意圖，不是 activation proof。Memory Flight Recorder 只使用 fixture-trace 或 sanitized runtime record；deterministic-local-pilot not Model Evidence，也不包含真實 Personal Memory。

State 分離

Operational DB 保留 workflow／control state。Optional Memory DB 只在啟用 Memory 且進入寫入時才 lazy-create。Managed Personal、Workspace Digest scoped managed state 與 immutable Revision snapshot 位於外部 data root；關閉 capture 不會暗中 purge。