codex-architect · git:20260305.c56d819 · 2026-03-05 · sha256 0c9d109c7f18b7ac

codex-architect git:20260305.c56d819A

Immutable. This exact content is served forever at /api/v1/blob/0c9d109c7f18b7ac.

---
name: codex-architect
description: Codex architecture consulting (third brain). Get Codex architecture advice during design phase, forming dual perspective with Claude.
allowed-tools: Read, Grep, Glob, mcp__codex__codex, mcp__codex__codex-reply
---

# Codex Architect Skill(第三大腦)

## Trigger

- Keywords: 架構設計, 方案評估, 技術選型, 第三大腦, Codex 建議, 設計諮詢, 問問 Codex, 第二意見

## When NOT to Use

- 代碼實作(用 /codex-implement)
- 代碼審查(用 /codex-review)
- 深度討論/窮舉(用 /codex-brainstorm)

## Usage

```bash
/codex-architect "<問題>"
/codex-architect "評估這個設計" --context src/xxx.ts --mode review
/codex-architect "Redis vs MongoDB?" --mode compare
```

## Modes

| Mode    | Purpose      | When             |
| ------- | ------------ | ---------------- |
| design  | 提供設計建議 | 從零開始(預設) |
| review  | 評估現有設計 | 驗證方案、找問題 |
| compare | 比較多個方案 | 技術選型         |

## Core Principle

```
User → Claude → Codex → 整合
         ↓        ↓       ↓
      初步思考  第三視角  綜合建議
```

## Codex Prompt Template

使用 `mcp__codex__codex` 時,必須包含以下內容:

```typescript
mcp__codex__codex({
  prompt: `你是資深架構師。請針對以下問題提供架構建議。

## 問題
${QUESTION}

## 模式
${MODE} (design/review/compare)

## ⚠️ 重要:你必須自主調研專案 ⚠️

在提供架構建議前,你**必須**執行以下調研:

### 調研步驟
1. 了解專案結構:\`ls src/\`、\`ls src/service/\`、\`ls src/provider/\`
2. 搜尋相關模組:\`grep -r "關鍵字" src/ --include="*.ts" -l | head -10\`
3. 讀取現有實現:\`cat <相關檔案> | head -150\`
4. 了解現有架構模式和約定

### 驗證重點
- 現有架構是什麼樣的?
- 現有代碼風格和模式是什麼?
- 有什麼相似的功能可以參考?

## 輸出要求

1. 先說明你調研了哪些檔案
2. 基於專案現況提供建議
3. 考慮與現有架構的一致性

...(其他審核維度)`,
  sandbox: 'read-only',
  'approval-policy': 'never',
});
```

## Workflow Integration

```
/codex-architect → /tech-spec → /review-spec → /codex-implement → /codex-review-fast
    設計              規劃         審核           實作              審查
```

## Verification

- 報告包含 Codex 建議 + Claude 觀點
- 共識點與差異點明確標示
- 最終建議有整合雙視角

## References

- `references/project-knowledge.md` - 專案架構知識 + 報告模板

## Examples

```
輸入:/codex-architect "如何設計高併發快取?"
動作:Codex 分析 → Claude 補充 → 整合輸出
```

```
輸入:/codex-architect "這個 API 設計有問題嗎?" --mode review
動作:Codex 評估 → Claude 驗證 → 輸出問題 + 建議
```