githubnext/chopin

解决的问题

Chopin 解决了通过人类开发者与 AI 代理之间的协作过程来创建持久性技术文档（如实施计划、RFC 和决策记录）的挑战。它通过将推理过程和已接受的答案与最终的正文分离，防止决策背景的丢失，确保后续重写不会无声地抹去选择背后的原因历史。

工作原理

Chopin 创建“通道”，将 GitHub 仓库与多人富文本文档连接起来。它使用一个托管的代理 Planner，该代理可以读取仓库的代码和拉取请求，提出更改建议并起草内容。

关键组件包括：

• 协作文档：一个基于 MDX 的共享空间，人类和代理可实时共同编辑。
• 聊天：团队沟通空间，可通过 @chopin 调用代理参与对话。
• 决策：一个专用系统，将带属性的问卷回答和评论与文档正文分开追踪。
• 研究：/research 命令触发后台任务，收集信息并以子文档形式发布结果。
• MCP 集成：提供 Model Context Protocol (MCP) 端点，允许外部编码代理创建或消费实施计划。

适用人群

需要在严格记录架构决策的同时，借助 AI 协助共同撰写技术规范和规划文档的软件工程团队。

亮点

• 基于仓库的 AI：Planner 代理对 GitHub 仓库具有只读访问权限，确保建议基于实际代码。
• 决策持久化：将“为什么”（决策）与“是什么”（文档正文）分离。
• 多人编辑：支持人类和代理的实时协作编辑，包含存在状态和光标显示。
• 外部代理连接性：通过 MCP 桥接 Chopin 中的高层级规划与外部代理的实际代码实现之间的差距。