ramarivera/coding-buddy

解決的問題

Coding Buddy 為 Claude Code、Pi 和 Oh My Pi 等 AI 程式設計助手提供一個持久、可動畫的 ASCII 同伴。此專案恢復了 Claude Code 中被移除的「夥伴」功能，透過使用 Model Context Protocol (MCP) 而非二進位修補，確保該同伴在軟體更新後依然存活。

如何運作

此專案透過多個穩定的擴展點與 AI 框架整合：

• MCP 伺服器：提供工具與系統提示，指示 AI 在每回合結束時觸發反應。
• 技能：實作斜線指令（例如 /buddy），用於檢視統計資料並與同伴互動。
• 狀態列：在終端的狀態列中渲染動畫 ASCII 藝術與對話氣泡。
• 鈎子：使用 shell 包裝器偵測錯誤或測試失敗等事件，以觸發特定的同伴反應。

同伴身分透過基於使用者帳戶 UUID 的決定性演算法（wyhash + mulberry32）產生，確保同一使用者始終被分配到相同的同伴。

適用對象

使用 Claude Code、Pi 或 Oh My Pi 的開發者，希望在程式設計會話中擁有一個遊戲化、視覺化的同伴。

主要亮點

• 抗更新：基於 MCP 建構，因此在主機 AI 工具更新時不會崩潰。
• 多樣生物群：包含 19 種不同物種，稀有度從普通到傳說不等，每種都有獨特的屬性（除錯、耐心、混亂、智慧、諷刺）。
• 預設備用語句：使用備用語句池，確保即使 AI 模型未能回應，對話氣泡也不會沉默。
• 跨框架同步：透過環境變數支援在不同 AI 程式設計工具間共享單一同伴身分。
• TUI 選擇器：互動式終端使用者介面，可搜尋並儲存特定的同伴物種與稀有度。