AI 協作開發協議 (AI Collaboration Protocol)

在開發 Hyperliquid Monitor 的過程中，我們不只是在寫代碼，更是在實踐一種新型態的開發模式：Human-AI Pair Programming。為了確保開發過程的高效與安全，我們建立了一套嚴格的協作協議。

🛡️ 核心鐵律 (Core Rules)

1. 拒絕「全量覆寫」，擁護「精準手術」

在人機協作中，我們嚴禁 AI Agent 對現有的源代碼檔案使用 write_file (全量覆寫)。

• 為什麼？: 大型語言模型在輸出長文本時，容易發生截斷或幻覺，導致穩定的代碼片段無故失蹤。
• 解決方案: 必須使用 replace 工具進行精確替換。這確保了每一次變動都是可控且透明的。

2. 原子化備份：每一行修改都算數

我們遵循 “One Edit, One Commit.” 的原則。

• 機制: 每完成一個檔案的修改，AI 必須立即執行 git commit。
• 優點: 這為專案提供了細顆粒度的版本回溯能力。即使在複雜的重構過程中某一步出錯，我們也能迅速恢復到幾分鐘前的穩定狀態。

🤝 溝通的藝術

為了發揮 AI 的最大潛力，溝通語言的選擇也經過考量：

• 開發者對話: 使用繁體中文，確保意圖表達的細膩與精確。
• 工程產物: Git Commit 與代碼註解維持英文，符合工程界的國際通用標準。

🧠 知識注入：給 AI 一個「長期記憶」

透過 GEMINI.md 檔案，我們為 AI 實例注入了專案的「長期記憶」，包含：

• 歷史 Bug 記錄與解決方案。
• 特定環境的配置細節。
• 專案特有的架構約束。

🚀 未來展望

AI 不再只是輔助工具，而是專案的共同維護者。透過這套「開發憲法」，我們成功地在極短的時間內完成了 Hyperliquid Monitor 的多次重大版本更迭。這套協議不僅適用於本專案，更是未來軟體開發的新常態。