关键词

AI代理编排上下文管理任务追踪代码生成

项目简介

Sudocode 是一个轻量级的代理编排系统，它通过MCP（Model Context Protocol）为AI编程代理提供结构化的上下文管理。该系统将项目需求、实现计划和执行状态存储在git仓库中，实现版本控制的"上下文即代码"理念。

主要功能

  • 规范管理：将用户意图和需求组织为可执行的规范文档
  • 任务追踪：将代理工作分解为可管理的任务（issue）
  • 执行监控：实时跟踪AI代理的执行轨迹和状态变化
  • 工作流自动化：支持多任务依赖关系的拓扑排序执行
  • 多代理协调：允许多个AI代理（Claude Code、Codex、Cursor等）并行工作
  • IDE集成：支持VS Code、Cursor、Windsurf等编辑器直接打开工作树
  • 外部集成：支持与Beads、Spec-Kit、OpenSpec等系统进行双向同步

安装步骤

  1. 全局安装：

    npm install -g sudocode

  2. 项目初始化：

    sudocode init

  3. 启动服务器：

    sudocode server

服务器配置

Sudocode 的MCP服务器可以通过以下配置与MCP客户端连接：

{
  "mcpServers": {
    "sudocode": {
      "command": "npx",
      "args": ["sudocode", "mcp"]

参数说明：

  • 'command'：使用npx命令来避免Node版本冲突
  • 'args'：
    • 'sudocode'：主程序包
    • "mcp"：启动MCP服务器模式

基本使用方法

  1. 创建规范：使用CLI创建项目需求和设计文档
  2. 生成任务：AI代理根据规范自动创建实现任务
    • 服务器启动后，MCP客户端可以通过MCP协议访问以下功能：
    • 读取项目规范和任务信息
    • 监控代理执行状态
    • 管理执行工作树和变更

核心MCP服务包括：

  • 资源管理：提供对项目规范、任务和关系的访问
  • 工具注册：支持AI代理调用外部功能
  • 模板渲染：提供可定制的提示模板
  • 上下文同步：在git仓库中维护机器可读的上下文数据库
  • 实时事件流：通过WebSocket推送实体变更和状态更新

信息

分类

开发者工具

访问项目