Egent

📋 动机与概述

Cursor、Windsurf、Augment Code 和 Cline 等现代编程工具都提供了强大的“Agent 模式”，可根据自然语言指令自动完成复杂任务：

• 更新软件包依赖项并修复 CVE 漏洞
• 跨多个文件执行常规代码重构
• 为新增或现有功能添加单元测试
• 统一代码格式并修复 lint 问题

然而，这些功能面临一个关键限制：上下文共享。

问题

• 每位团队成员使用的工具各不相同（Cursor、Cline 等）
• 自然语言“操作手册”仅存在于个人环境中
• 缺少集中共享、版本管理或协作改进这些操作手册的方式
• 团队成员各自编写 Agent 指令，形成操作手册孤岛

解决方案：playbookmcp

playbookmcp 将基于 GitHub 仓库的操作手册转换为 MCP 服务，供所有主流编程工具使用。这使得团队能够：

• 通过标准 GitHub 工作流协作编辑操作手册
• 对团队的操作手册进行版本控制
• 在整个团队中即时共享新能力

例如，工程师 Alice 为“在整个 monorepo 中更新依赖版本”添加新的操作手册，将其提交到操作手册仓库并推送后，工程师 Bob 就能立即在自己首选的编码工具中使用此功能。

🔍 设计

团队可以通过编辑操作手册仓库（通常是 GitHub 仓库）持续丰富知识库，让 AI 自动完成各种任务。

有关操作手册仓库结构的详细信息，请参阅 docs/playbook.md。

🚀 使用方法

设置

基本配置

要将 playbookmcp 与远程操作手册仓库配合使用：

{
  "mcpServers": {
    "playbookmcp": {
      "command": "npx",
      "args": [
        "-y",
        "playbookmcp@latest",
        "--playbook-repo",
        "<your playbook repo>"
      ]
    }
  }
}

本地开发

要使用本地上下文目录进行测试：

{
  "mcpServers": {
    "playbookmcp-local": {
      "command": "npx",
      "args": [
        "-y",
        "playbookmcp@latest",
        "--playbook-path",
        "<your playbook files path>"
      ]
    }
  }
}

PlaybookMCP 开发

要开发 PlaybookMCP 本身：

{
  "mcpServers": {
    "playbookmcp-dev": {
      "command": "node",
      "args": [
        "build/index.js",
        "--playbook-path",
        "<your playbook files path>"
      ]
    }
  }
}

你也可以使用 inspector 检查 MCP 资源：

npx @modelcontextprotocol/inspector node build/index.js --playbook-repo <your playbook repo>

与代码 Agent 聊天

以下是 Cursor 中的配置示例：

{
  "mcpServers": {
    "playbookmcp": {
      "command": "npx",
      "args": [
        "-y",
        "playbookmcp@latest",
        "--playbook-repo",
        "[email protected]:xuezhaojun/PlaybookMCP-demo.git"
      ]
    }
  }
}

启动交互的第一条命令必须是 pb_start：

pb_start Say Hi to playbookmcp.

也可以指定得更具体：

use MCP tool pb_start Say hi to playbookmcp.

随后，你的代码 Agent 会在此 问题 上添加评论。