System Prompt 在團隊內部的價值，不只是當下產生一致的程式碼，更是 長期維護與知識傳承 的關鍵。
今天我們聚焦在 新成員的導入流程 ——如何讓新人能快速上手既有的 System Prompt 規範，減少適應期的混亂。

一、為什麼需要 System Prompt onboarding？

在真實的團隊場景中，常見的新人問題有：

• 程式風格不一致：新人直接依賴 AI 工具，卻不清楚團隊的 System Prompt 設定。
• 誤用錯誤規範：不了解 Claude 與 Cursor 的差異，導致載入錯誤的設定檔。
• 規則理解不足：只看到 .cursorrules 或 CLAUDE.md，卻不明白背後的設計理念。

這些都會造成 技術債務，因為後續需要花時間修復不符合規範的程式碼。

二、建立 System Prompt 說明文件

新成員第一步，需要一份結構清晰的 說明文件。建議文件包含：

檔案結構導覽

專案根目錄/
├── .cursorrules           # Cursor 專用設定（必須在根目錄）
├── CLAUDE.md             # Claude 專用設定
├── system-prompt/        # System Prompt 管理資料夾
│   ├── base/             # 基礎規範模組
│   ├── frontend/         # 前端專用規範
│   ├── backend/          # 後端專用規範
│   ├── templates/        # 規範模板
│   └── README.md         # 說明文件入口
├── src/                  # 程式碼
└── docs/                 # 其他文件

規範核心章節解釋

• 角色與上下文：AI 應該扮演的工程師角色
• 程式碼規範：命名、錯誤處理、測試要求
• 約束條件：安全性、效能優先級

工具對照表

這樣新人不用硬啃規範全文，只要看 system-prompt/README.md 就能知道該去哪裡找細節。

重要提醒：.cursorrules 和 CLAUDE.md 必須放在專案根目錄，這樣工具才能自動載入設定。

三、新成員導入流程設計

可以設計一個 三步驟 Onboarding 流程：

1. 環境準備
   • Clone 專案後，自動安裝必要的 System Prompt 檔案
   • 使用 Git Hook 或 Shell Script 檢查設定檔是否存在

# .git/hooks/post-checkout
if [ ! -f ".cursorrules" ]; then
  echo "⚠️  請確認已同步最新的 System Prompt 配置"
fi

2. 快速體驗

   • 指導新人嘗試用 AI 寫一個小功能（例如：新增一個 API endpoint）
   • 比對生成結果與團隊標準程式碼是否一致

3. 回饋與測試

   • 安排 Pair Programming，讓新人即時看到 AI 規範效果
   • 蒐集使用過程的困惑，更新文件或補充 FAQ

四、效果驗證與持續改進

為了避免 onboarding 流於形式，需要建立 驗證機制：

• 程式碼一致性檢查：搭配 lint、單元測試，檢查是否符合 System Prompt。
• 新人成長追蹤：一週後回顧程式碼，確認是否還出現規範偏差。
• 文件更新流程：根據新人的反饋，調整文件與教學材料。

五、降低技術債務的關鍵思路

• 文件化：規範不是只有在 System prompt 中，還要有明確的文字解釋。
• 自動化：盡量透過工具驗證，減少人力審查的負擔。
• 反饋閉環：新人是最佳的檢驗者，他們的困惑就是規範不清楚的證據。

結語

System Prompt onboarding 的核心，不是「把文件丟給新人」，而是設計一個 循環驗證的導入流程。
這樣一來，既能保證新成員快速上手，也能避免技術債務隨著人員更替而不斷累積。