关键词

AI协作开发任务管理代码审查大模型编程工具自动化开发

项目简介

Automagik Forge 是一款专为人类与 AI 协作开发设计的平台。它提供了一个持久化的看板，用于高效管理和追踪开发任务。该平台集成了多种 AI 编程代理，支持用户试验不同的 AI 方法来完成任务，并提供全面的控制和审查机制，确保最终交付的代码质量可靠。通过其内置的 Model Context Protocol (MCP) 服务器，Automagik Forge 能够与任何兼容 MCP 的 AI 客户端无缝集成，允许 AI 直接访问、更新和管理任务上下文，从而优化您的 AI 编码工作流程。

主要功能点

  • 任务看板与管理： 提供一个直观、持久化的看板，用于创建、组织、分类和追踪所有开发任务的生命周期。任务不再丢失在聊天记录中，而是集中管理。
  • 多 AI 代理支持： 集成并支持多种主流的 AI 编程代理，例如 Claude、Gemini、Cursor CLI 等，甚至包括开源模型，让您可以根据任务需求选择最合适的工具。
  • 专业化代理： 允许定义和使用带有特定提示词的“专业代理”（如“测试编写者”、“PR 评审者”），这些代理可以与任何 AI 编程代理结合使用，以应对特定的开发场景。
  • 隔离尝试与代码审查： 每个任务尝试都在独立的 Git 工作区中进行，确保代码更改互不影响。平台提供详细的可视化代码差异，方便您比较不同代理的输出，并在合并代码前进行彻底的人工审查。
  • MCP 服务器集成： 作为核心功能，Automagik Forge 运行一个 MCP 服务器，使得外部 AI 编码客户端（如您的 IDE 或命令行 AI 工具）能够通过标准化协议远程控制任务板，进行任务的创建、更新和查询。
  • 实时进度与可视化上下文： 实时监控 AI 代理的工作进度，查看代码更改的动态差异。您还可以为任务附加截图和图表，提供丰富的视觉上下文。
  • 通知系统： 当任务执行完成或状态发生更新时，系统可以发送通知，确保您及时获得关键信息。

安装步骤

  1. 准备环境： 在您的本地机器上，请确保已安装 Node.js 18 或更高版本，以及 pnpm 8 或更高版本。
  2. 全局安装： 打开您的命令行终端，运行以下命令来全局安装 Automagik Forge： 
    npm install -g automagik-forge
  3. 启动 Forge 应用： 导航到您的开发项目目录（例如，您的 Git 仓库根目录），然后运行： 
    automagik-forge
    应用启动后，它会自动在您的默认浏览器中打开用户界面，通常地址是 'http://localhost:3000'。

服务器配置

Automagik Forge 作为一个 Model Context Protocol (MCP) 服务器，可以与各种支持 MCP 的 AI 客户端进行通信和交互。要让您的 AI 客户端连接并使用 Forge 服务器，您需要在客户端中进行以下关键配置：

  • 服务器名称： 这是您为 Forge MCP 服务器指定的一个唯一标识符。在您的 AI 客户端配置中，通常会有一个字段用于填写此名称，例如 'automagik-forge'。
  • 启动命令 (Command)： 指示您的 AI 客户端如何启动 Forge MCP 服务器进程的命令行工具。这通常是 'npx'。
  • 命令参数 (Arguments)： 传递给启动命令的一系列参数，用于明确告知 Forge 应用以 MCP 服务器模式运行。这些参数通常是 'automagik-forge' 和 'mcp-server'。
  • 项目 ID (环境变量)： 大多数 MCP 客户端需要配置一个 'PROJECT_ID' 环境变量，以指定 MCP 服务器在哪个具体的 Forge 项目上进行操作。这个 ID 是一个唯一的项目标识符（UUID）。您可以在 Forge 的用户界面中，创建或选择项目后，从浏览器地址栏 (例如 'http://localhost:3000/projects/您的项目ID/tasks') 或通过查看项目设置面板来获取它。
  • 传输协议： Automagik Forge MCP 服务器默认通过标准输入/输出 (Stdio) 协议与客户端进行通信，这是一个常见的本地进程间通信方式。

请根据您所使用的 MCP 客户端（例如 Claude Code、Cursor、Gemini CLI 或其他）的具体配置指南，将上述信息集成到其设置中。通过正确配置，您的 AI 客户端将能够与 Automagik Forge 建立连接，并利用其提供的强大任务管理和上下文服务功能。

基本使用方法

  1. 在 Forge 中规划任务： 打开 Forge 用户界面，创建一个新项目。您可以手动创建任务卡片，填写标题和详细描述，或者利用 AI 协助您规划一个完整的任务列表，例如“规划一个包含 OAuth、JWT 和基于角色的访问控制的完整认证系统”。
  2. 通过 AI 客户端执行操作： 在您偏好的 AI 编程工具中，一旦 Forge MCP 服务器配置完成，您就可以通过自然语言命令与 Forge 互动，而无需离开您的开发环境：
    • 创建任务： 当您在编码过程中发现一个新需求或 Bug 时，可以直接指示 AI：“Add bug: API returns 500 on malformed JSON input in /api/users endpoint.”，Forge 会自动创建相应的任务卡片。
    • 更新任务状态： 当任务完成或进入下一阶段时，您可以告诉 AI：“Mark all database migration tasks as complete and move API tasks to in-progress.”，Forge 会批量更新任务状态。
    • 查询任务信息： 您可以向 AI 提问：“Show me all high-priority tasks that are blocked or have dependencies.”，Forge 会返回符合条件的任务列表。
  3. 审查与决策： AI 代理完成任务尝试后，返回的结果会显示在 Forge UI 中。您可以仔细审查 AI 生成的代码更改、比较不同尝试的优劣，并最终决定接受、修改或拒绝这些更改，确保代码质量并保持对开发流程的完全控制。

信息

分类

开发者工具

访问项目