AgileBuilder logoAgileBuilder
返回文档

产品简介

AgileBuilder 是什么：一个开源的 Git 模板脚手架 CLI，配合云端空间与 MCP 集成，让 AI 和团队都从同一个规范起点创建项目

AgileBuilder 是什么

AgileBuilder 是一个基于 Git 模板的项目脚手架与开发资源管理工具，由两部分组成：

  • 开源 CLI（MIT 协议）：通过 npm 全局安装，提供 agilebuilder / ag 命令。它从 Git 模板地址或已登记的模板资源生成项目骨架，支持模板变量（EJS 渲染）、文件路径渲染和生成后 Hook，并内置 agilebuilder-mcp 服务模式供 AI 工具调用。
  • 云端服务 AgileBuilder Cloud：提供 SSO 账号、个人/团队空间、云端资源管理和订阅计费，让模板和规范文档可以跨设备同步、在团队内共享。

AgileBuilder 本身不调用任何大模型。它负责把项目结构和团队规范沉淀为模板与文档；AI 工具通过 MCP 协议读取这些资产，从而在你的规范内工作。

解决什么问题

在 AI 辅助编程成为常态之后，项目创建环节暴露出两个典型问题：

  • AI 不按规范工作：直接让 AI 生成项目，目录结构、依赖版本、工程配置每次都不一样，团队规范写在 Wiki 里没人看，AI 更看不到。
  • 项目起点不一致：团队成员各自复制旧项目、手工改配置，项目之间逐渐漂移，评审和维护成本越来越高。

AgileBuilder 的思路是：把验证过的项目结构和规范固化为模板，让人和 AI 都从同一个模板出发。

核心保证：同一模板 + 同一参数 = 同一项目骨架，结果可复现、可审计。

三个核心理念

约束 AI

CLI 内置 MCP server（agilebuilder-mcp）。Cursor、Claude Code、Codex 等支持 MCP 协议的 AI 工具可以直接查询你的模板库和规范文档、基于模板生成项目骨架，而不是靠提示词自由发挥。

模板即资产

一个 Git 仓库 + 一个 .agilebuilder.config.yaml 配置文件就是一个模板。模板可以版本化、可以评审、随团队持续演进；变量系统与 Hooks 让同一套工程模式适配不同项目。

开源免费起步

CLI 以 MIT 协议开源，本地功能完整免费、离线可用，不需要注册账号。需要云端同步与团队协作时，再按需订阅云端空间。

开源 CLI 与云端的关系

开源 CLI（本地）云端 AgileBuilder Cloud
费用免费（MIT 开源）免费版只读，Pro/Trial 可写，按年订阅
账号不需要SSO 登录（邮箱验证码 / 微信 / GitHub / Google）
数据存储本机 ~/.agilebuilder/v2云端空间 + 本地缓存
资源范围本地模板与文档个人空间、团队空间共享资源
协作单人使用成员、角色、权限管理

两个形态共享同一套 CLI：不登录时使用内置的本地工作空间；ag login 登录后即可访问云端空间，本地与云端的工作方式完全一致。

适合谁

  • 个人开发者：把常用的项目结构和初始化流程固化成模板，一次维护、持续复用，全程离线免费。
  • 技术负责人 / 工程团队：统一团队的项目起点，把规范文档通过 MCP 喂给 AI，降低评审和返工成本。
  • 模板作者：用 Git 仓库维护自己的模板，可以发布到资源广场与团队和社区分享。

下一步