githubnext/chopin

解決的問題

Chopin 解決了透過人類開發者與 AI 代理之間的協作過程，來建立持久性技術文件（如實作計畫、RFC 和決策紀錄）的挑戰。它透過將推理與已接受的答案，與最終的正文分離，防止決策脈絡的遺失，確保後續重寫不會靜默地抹去選擇背後的原因歷史。

工作原理

Chopin 創建「頻道」，將 GitHub 倉庫與多人富文本文件連結起來。它使用一個託管的代理 Planner，該代理可讀取倉庫的程式碼與拉取請求，提出變更建議並起草內容。

主要組件包括：

• 協作文件：一個基於 MDX 的共享空間，人類與代理可即時共同編輯。
• 聊天：團隊溝通空間，可透過 @chopin 呼叫代理參與對話。
• 決策：一個專用系統，將帶屬性的問卷回答與評論，與文件正文分開追蹤。
• 研究：/research 命令觸發背景工作，收集資訊並以子文件形式發布結果。
• MCP 整合：提供 Model Context Protocol (MCP) 端點，允許外部編碼代理建立或消費實作計畫。

適用對象

需要在嚴格記錄架構決策的同時，借助 AI 協助共同撰寫技術規格與規劃文件的軟體工程團隊。

亮點

• 基於倉庫的 AI：Planner 代理對 GitHub 倉庫具有唯讀存取權限，確保建議基於實際程式碼。
• 決策持久化：將「為什麼」（決策）與「是什麼」（文件正文）分離。
• 多人編輯：支援人類與代理的即時協作編輯，包含存在狀態與游標顯示。
• 外部代理連接性：透過 MCP 橋接 Chopin 中的高階規劃與外部代理實際程式碼實作之間的差距。