對 openai/codex-plugin-cc 的進階重寫，以 Claude Code marketplace 殼包一個與之同名的 plugin codex-pro。
codex-pro 用 ensemble pattern + 自家 Swift HTTPS runtime（透過 parallel-ai-agents 的 codex-call wrapper）取代上游 single-plugin 架構，從根本解決 IPC deadlock、subagent stub、無限 retry、零 observability 等系統性痛點。
| 上游（要取代） | codex-pro 對應 |
|---|---|
openai/codex-plugin-cc（單一 plugin、200+ open issues） |
codex-pro marketplace + 同名 plugin |
/codex:setup |
/codex-pro:setup — 已落地 |
/codex:review |
/codex-pro:review — 規劃中 |
/codex:adversarial-review |
/codex-pro:adversarial-review — 規劃中 |
/codex:rescue |
/codex-pro:rescue — 規劃中 |
/codex:status / /codex:result / /codex:cancel |
/codex-pro:status / :result / :cancel — 規劃中 |
openai/codex-plugin-cc 把 review、adversarial-review、rescue、status、result、cancel 打包成單一 plugin — 共用同一條 IPC pipe、同一個 fail mode、同一份 hardcode sandbox profile。一個 capability 壞掉，其他連帶失靈（見 upstream issues #330、#324、#306）。
codex-pro 也是 single plugin，但底下每個 skill 走獨立的 architecture discipline（見 CLAUDE.md Design constraints）：
- 每個 skill 各自有 circuit breaker
- 各自有獨立的 profile（max-findings、sandbox、model alias）
- 共用
parallel-ai-agents/bin/codex-callruntime（無 subprocess、hard timeout、HTTPS direct） - 一個 skill fail 不會把 session 卡死
Marketplace 殼存在的理由是給未來「對外發布到 GitHub + /plugin marketplace add」鋪好基礎結構，不是當前需要拆分多 plugin。
所有 capability 都是 plugins/codex-pro/skills/<skill>/SKILL.md 結構，skill 觸發名統一形如 /codex-pro:<skill>：
| Skill | 狀態 | 用途 |
|---|---|---|
setup |
v0.1.0 | 驗證 OAuth、codex-call runtime、plugin manifest 環境是否就緒。Read-only，跑其他 skill 前先確認。 |
batch |
v0.1.0 | 用 codex exec --full-auto 平行批次處理大型 reference doc 多 chunk（textbook 解題 / 翻譯 / 摘要）。產生 shell script + 跑 subprocess + 寫 output dir，非 read-only（與 setup 區別）。本 skill 為 Design constraint #1 的 explicit exception。 |
review / adversarial-review |
規劃中 | Ensemble code review（4 Claude teammates + N Codex 角色）+ adversarial review |
rescue |
規劃中 | Delegate task 給 Codex，HTTPS direct 無 subprocess |
status / result / cancel |
規劃中 | Background job 管理（含 token / cost / tier 觀測） |
# 1. 加入 marketplace（從 GitHub）
/plugin marketplace add psychquant/codex-pro
# 2. 安裝 plugin（marketplace 名與 plugin 名同為 codex-pro）
/plugin install codex-pro@codex-pro
# 3. 跑環境檢查
/codex-pro:setup
開發 / iterate 時可直接 clone repo 後跑 claude --plugin-dir <repo>/plugins/codex-pro（指 plugin 目錄、不是 marketplace root）。
三層 test scenarios 在 tests/：
- Layer 1 (static) — manifest JSON schema、SKILL.md frontmatter、
bash -n、batch template byte-identical sha256、namespace consistency - Layer 2 (behavioral) — setup 三 check 在 isolated env 重跑（fake HOME / 剝離 PATH / mktemp fake plugin root）、read-only 紀律驗證、batch SKILL exception 標記 + template parallel orchestration markers
- Layer 3 (manual) —
tests/e2e-checklist.md含 12 條手動 UI 確認步驟
一條命令跑 Layer 1+2：
bash tests/run.sh
跑完顯示 aggregate「N pass / N fail / N total」與 layer-level pass/fail count；exit 0 表全綠。Layer 3 是手動 markdown checklist，需要在 fresh Claude Code session 親自跑。
也可單獨跑某 layer：bash tests/static.sh、bash tests/setup.sh、bash tests/batch.sh。
- Upstream we replace: https://github.com/openai/codex-plugin-cc — 原 OpenAI codex plugin（200+ open issues 是 codex-pro 設計的反例來源）
- Runtime dependency:
parallel-ai-agents（屬psychquant-claude-pluginsmarketplace）— 提供codex-callSwift wrapper，直連chatgpt.com/backend-api、避開codex execsubprocess（這是 upstream IPC deadlock 的根因） - 設計細節 / design rationale: see
CLAUDE.md - Spec-driven development: 走 Spectra SDD — specs 在
openspec/specs/、change proposals 在openspec/changes/
MIT