cobuilt

cobuilt 插件

通过 AI 编码 Agent 将项目的构建回执发布到 cobuilt.dev。构建回执如实记录项目的构建过程，以及 AI 如何参与其中。你的 Agent 会根据代码库和会话内容起草回执，询问只有你才能回答的问题，并且只有在你批准所有字段后才会发送。

适用场景

Claude Code 和 Gemini CLI 支持发布，因为它们可以发送 Agent 令牌。在 claude.ai 聊天和 Cowork 中，技能可以加载，但 cobuilt 工具无法使用，因为这些应用通过 OAuth 登录连接服务，而 cobuilt 目前尚未提供这种方式。请在 Claude Code 中打开项目以进行发布。

试用

在项目中说出以下任意一句：

• “将此项目发布到 cobuilt。”你的 Agent 会起草回执，询问它无法获知的信息，并展示最终字段供你批准。
• “显示此项目在 cobuilt 上的构建回执。”它会在你的项目中找到该项目，并读取当前回执。不会更改任何内容。
• “更新此项目在 cobuilt 上的构建回执。”它会以已发布的回执为基础，将新旧文本并排展示，并在替换任何内容前发出提醒。

安装（Claude Code）

1. 登录 cobuilt.dev 并创建 Agent 令牌：Settings → Agent tokens（令牌以 cbt_ 开头）。

2. 在 Claude Code 会话中运行：

   /plugin install cobuilt --marketplace cobuilt-dev/agent-plugins
   

   在对话框提示时粘贴令牌，然后运行 /reload-plugins。

3. 说 “将此项目发布到 cobuilt”，或运行 /cobuilt:publish。

无法正常工作时

• 之前用 claude mcp add 添加过 cobuilt？ 请先运行 claude mcp remove cobuilt --scope user。你在相同地址手动添加的服务会悄无声息地替换插件服务。
• 没有 cobuilt 工具？ 运行 /plugin configure cobuilt@cobuilt，粘贴令牌，然后运行 /reload-plugins。通过命令行安装（claude plugin install）不会提示输入令牌。
• 在 claude.ai 上添加了插件？ 它会以 cobuilt@synced 的形式传入 Claude Code，因此请改为运行 /plugin configure cobuilt@synced。
• 也使用 Cursor？ Cursor 会导入已安装的 Claude Code 插件（默认开启：Cursor Settings → Agents → Third-Party Imports），并将此插件列为“cobuilt · Plugin”且显示错误，因为它无法读取令牌。请在 Cursor 的 MCP 列表中关闭该条目（重启后仍会保持关闭），并使用 cobuilt.dev/connect 中的 ~/.cursor/mcp.json 片段设置 Cursor。

安装（Gemini CLI）

1. 按上述说明创建 Agent 令牌。

2. 在终端中运行：

   gemini extensions install https://github.com/cobuilt-dev/agent-plugins
   

   在提示输入 cobuilt agent token 时粘贴令牌。

3. 启动 Gemini CLI 并说 “将此项目发布到 cobuilt”。

没有 cobuilt 工具？ 运行 gemini extensions config cobuilt，粘贴令牌，然后重启 Gemini CLI。运行 gemini mcp list 应会显示 cobuilt 已连接。

其他客户端的设置方法：cobuilt.dev/connect。

包含内容

• cobuilt MCP 服务（https://cobuilt.dev/mcp），通过 Authorization: Bearer … 发送你的令牌。其工具包括：列出你的项目、获取起草指南、读取当前回执、提交构建回执。
• 一个名为 publish 的技能，由 Claude Code 和 Gemini CLI 共用。除非你允许，否则客户端会在每次调用 cobuilt 工具前征求同意；提交回执时始终会先征求你的同意。

你的令牌

Claude Code 会将令牌作为密钥保存：在 macOS 上保存到钥匙串中，其他情况下则保存在 Claude Code 自己位于用户文件夹中的凭据文件里。 卸载插件会将其移除。

Gemini CLI 会将令牌保存在系统钥匙串中（在 Windows 上，保存在“Gemini CLI Extensions cobuilt …”下的凭据管理器中；没有钥匙串时，则保存在 Gemini CLI 自己的设置文件夹中的一个文件里）。卸载扩展不会将其移除：你需要自行删除该条目（在 Windows 上：控制面板 → 凭据管理器 → Windows 凭据 → 普通凭据）。

在 cobuilt.dev 的设置 → Agent 令牌中撤销令牌，才是真正的关闭方式。

它会发送什么，以及发送到哪里

该插件不会在你的设备上运行任何内容：没有钩子、脚本或本地命令。它只会与一个服务 https://cobuilt.dev/mcp 通信，并且每个请求都会携带你的 Agent 令牌。

• **读取：**你的 Agent 会请求撰写指南、项目列表以及某个项目当前的记录。
• **发布：**你批准后，它会发送记录：项目标题、描述、链接、类型和技术栈（用于新项目）、AI 的参与方式、使用的 AI 工具、AI 完成的工作、你完成的工作、出现的问题、Agent 和模型名称，以及提交次数等可选汇总数据。

项目获批后，提交的记录会公开；新项目则会先经过审核。为现有项目发送记录会替换其当前记录。cobuilt 会保留该记录，直到你替换记录或删除项目。

插件的说明会告诉你的 Agent，绝不要发送源代码、差异、文件内容、提示词、聊天记录、密钥、环境变量或本地文件路径。你的 Agent 会先向你展示所有字段，因此请在批准前检查。请参阅隐私政策和条款。

发布版本

每次更改都会更新所有清单中的版本，并创建一个标记为 vX.Y.Z 的 GitHub Release。撰写指南和工具的更改会发布在 cobuilt.dev 上，无需更新插件。仅更改此 README 不会更新版本。

server.json 会将该服务以 dev.cobuilt/cobuilt 的名称列入官方 MCP Registry。它使用与插件相同的版本；已发布的版本无法再次发布，因此更改此文件需要先发布新版本，再重新发布。

许可证

MIT