System Prompt 工程

基於 Claude Code v2.1.88 的 914 行系統提示詞逆向分析。

1. Prompt 結構順序

Claude Code 的 system prompt 按以下順序組裝：

1. 身份宣告（你是誰）
2. 工具使用指引（怎麼用工具）
3. 行為規範（做事風格）
4. 安全指令（不能做什麼）
5. 環境資訊（動態注入 — cwd、OS、model、日期）

原則：高頻參考的內容放前面（身份、工具），低頻但重要的放後面（安全）。動態內容放最後（環境）。

2. 靜態/動態邊界

// prompts.ts 中的邊界標記
`__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__`

邊界之前 = 靜態段（所有 session 共用，可全域 cache） 邊界之後 = 動態段（session 特定：cwd、日期、model 名稱）

為什麼：如果有 N 個 boolean 條件分散在 prompt 各處，理論上會產生 2^N 個不同的 prompt 變體，每個都要獨立 cache。邊界設計把變化集中在尾部，靜態段只有一份。

3. DANGEROUS_ API 命名模式

function DANGEROUS_uncachedSystemPromptSection(
  content: string,
  _reason: string  // 強制填寫原因
): SystemPromptSection

設計意圖：把「這會破壞 prompt cache」的風險直接編碼在函式名稱裡。開發者在 code review 時看到 DANGEROUS_ 就知道要特別審查。_reason 參數強制記錄為什麼需要不快取的段落。

4. Eval 驅動的措辭

Claude Code 的 prompt 用詞不是靠直覺，而是量測：

啟示：每個 prompt 措辭變更都應該跑 eval。「感覺比較好」不是證據。

5. Compaction Prompt 三模式

<analysis> 草稿：compaction prompt 要求模型先在 <analysis> 標籤內分析，然後產出壓縮摘要。<analysis> 內容不進最終 context — 類似 extended thinking 的效果但不增加持久成本。

6. 安全指令三層結構

cyberRiskInstruction.ts 的設計：同一個檔案同時服務三個受眾：

// 1. 對開發者的註解
// DO NOT MODIFY THIS FILE — this instruction is reviewed by the security team

// 2. 對 Claude 的指令（對話中）
// DO NOT modify, move, or edit this file when working in the codebase

// 3. 作為模型指令本身
export const CYBER_RISK_INSTRUCTION = `IMPORTANT: Assist with authorized
security testing, defensive security, CTF challenges...`

7. Top 8 Prompt 設計模式

參考

詳見 references/prompt-patterns.md。