Immutable. This exact content is served forever at /api/v1/blob/2ffc92f38fb252fd.
---
name: code-investigate
description: Dual-perspective code investigation. Claude explores independently, then Codex explores independently (no feeding), finally integrate both conclusions.
allowed-tools: Read, Grep, Glob, Bash, mcp__codex__codex
context: fork
---
# Code Investigate Skill
## Trigger
- Keywords: 調查代碼, investigate code, 功能怎麼運作, 追蹤實作, 雙重確認, 深入了解, code 怎麼運作, 這段代碼做什麼, 調研代碼, 代碼調研
## When NOT to Use
- 只需快速查找（直接用 Grep/Glob）
- 代碼審查（用 codex-review）
- 系統驗證（用 feature-verify）
- Git 歷史追蹤（用 git-investigate）
## Core Principle
```
⚠️ Codex 必須獨立探索，禁止 Claude 餵養結論 ⚠️
```
```
┌─────────────────┐ ┌─────────────────┐
│ Claude 獨立調查 │ │ Codex 獨立調查 │
│ (Phase 1-2) │ │ (Phase 3) │
└────────┬────────┘ └────────┬────────┘
│ │
▼ ▼
┌───────────┐ ┌───────────┐
│ Claude │ │ Codex │
│ 結論 │ │ 結論 │
└─────┬─────┘ └─────┬─────┘
│ │
└───────────┬───────────┘
▼
┌─────────────┐
│ 整合報告 │
│ (Phase 4) │
└─────────────┘
```
## Workflow
| Phase | 名稱 | 動作 | 產出 |
| ----- | --------------- | ----------------------- | ---------------- |
| 1 | Claude Explore | Grep/Glob/Read 搜尋代碼 | 相關檔案清單 |
| 2 | Claude Conclude | 分析邏輯、形成理解 | 初步結論（內部） |
| 3 | Codex Explore | 調用 Codex MCP 獨立探索 | Codex 分析報告 |
| 4 | Integrate | 比對雙方視角、標示差異 | 整合報告 |
## Codex 調用規則
### 必要參數
| 參數 | 值 | 說明 |
| ----------------- | ----------- | -------- |
| `sandbox` | `read-only` | 強制只讀 |
| `approval-policy` | `never` | 自動執行 |
| `cwd` | 專案根目錄 | 探索起點 |
### 正確方式
```typescript
mcp__codex__codex({
prompt: `# 代碼調查任務
## 問題
${userQuestion}
## 專案資訊
- 路徑：${cwd}
- 技術棧：{FRAMEWORK} + TypeScript + {DATABASE}
請**獨立探索**代碼庫，回答：
1. 相關檔案有哪些？
2. 核心邏輯如何運作？
3. 資料流是什麼？
4. 有哪些關鍵依賴？
請自行 grep/read 探索，給出你的分析。`,
cwd: '/path/to/project',
sandbox: 'read-only',
'approval-policy': 'never',
});
```
### 禁止方式
| 模式 | 問題 | 範例 |
| ---------- | ----------------------- | ---------------------------------- |
| 餵養結論 | Claude 結論洩漏給 Codex | `Claude 發現這些檔案：${findings}` |
| 引導性問題 | 預設答案 | `我認為問題出在 cache，請驗證` |
| 限制範圍 | 阻止獨立探索 | `只看 src/service/` |
## Verification Checklist
| 檢查項 | 標準 |
| ----------------- | ----------------------------------- |
| Claude 獨立結論 | Phase 2 形成結論，未輸出給用戶 |
| Codex prompt 乾淨 | 只含問題 + 專案路徑，無 Claude 發現 |
| 報告視角分離 | Claude / Codex 結論分開呈現 |
| 整合完整 | 標示共識點、差異點、可能遺漏 |
## References
| 檔案 | 用途 | 何時讀 |
| ------------------------------- | ----------------- | -------------- |
| `references/prompts.md` | Codex prompt 模板 | Phase 3 調用前 |
| `references/output-template.md` | 報告格式 | Phase 4 整合時 |
## Examples
### 功能調查
```
輸入：調查 訂單處理流程怎麼運作的
Phase 1: Grep "processOrder" → Read src/service/order/*.ts
Phase 2: 形成理解：Controller → Service → Repository 寫入
Phase 3: Codex 獨立探索（只給問題 + 路徑）
Phase 4: 整合報告 → 標示雙方視角
```
### 機制理解
```
輸入：API 的快取機制怎麼運作？
Phase 1: Grep "cache" + "portfolio" → Read 相關檔案
Phase 2: 理解 Redis TTL + fallback 機制
Phase 3: Codex 獨立調查
Phase 4: 比對差異 → 輸出整合報告
```
### 問題診斷
```
輸入：為什麼 token price 有時候是 null？
Phase 1: 搜尋 price 相關邏輯 + error handling
Phase 2: 識別可能的 fallback 路徑
Phase 3: Codex 獨立診斷
Phase 4: 綜合雙方發現 → 列出可能原因
```