一款智能体需求描述文档(Agent PRD)生成工具,能将自然语言描述转化为结构化的、适用于 Vibe coding 的技术文档。
概览 • Web UI • MCP 集成 • 快速开始 • 配置 • 项目结构 • Prefab 生态系统 • 参与贡献 • 许可证
- 首先,你得定义活是什么:输入有哪些,具体操作步骤是什么,输出什么内容?如何定义任务成功了?。这些内容一般称为SOP,能被SOP化的工作,就能被AI自动化。
- 其次,你得给Agent合适的工具,人能用OFFICE全家桶, 能上网冲浪,能管理文件存数据等等。如果要Agent干活,这些工具也得给他。
- 最后,你得告诉Agent按照什么形式来组织成果。
这些定义在Agent语境下,有个更合适的词语,叫做上下文工程。具体来说,在Code Agent(Claude Code/Cursor/Augment/Devin/...)开始编码Agent前,我们希望用文档明确:
- design.md:定义活儿是什么。
- prefab.md:定义有哪些工具,如何使用。我们称为预制件。
- starter-kit:定义开发框架,可用环境等(这一部分不同项目间基本不变)。
这就是GTPlanner想做的事情,简化搭建Agent的流程。
GTPlanner的目标是帮您轻松生成一份Agent PRD,也即AI能够读懂的标准操作程序(standard operating procedure , SOP)。快速自动化你手边的任务。GTPlanner的设计哲学是:
- 追求确定性:通过清晰的SOP(Agent PRD)消除AI的歧义,确保其执行路径和结果高度可控且可预测。
- 追求可组合: 将SOP分解为可复用的“预制件”(Prefab)和任务模块,像搭积木一样组合它们,以构建更复杂的工作流。
- 追求自由度:我们不绑定执行平台(如n8n),而是直接使用最简的AI框架和原生python代码进行构建,从而保证最大限度的灵活和自由。
为了获得最佳体验,我们强烈推荐使用 Web UI。它提供了为现代开发者量身打造的流畅 AI 规划工作流。
核心优势:
- 智能规划助手:AI 辅助快速生成系统架构和项目计划
- 即时文档生成:自动创建全面的技术文档
- 完美适配 Vibe Coding:优化输出,适配 Cursor、Windsurf、GitHub Copilot
- 团队协作:多格式导出,方便共享
体验 Web UI - 所见即所得的规划与文档生成体验
- Python ≥ 3.10(推荐 3.11+)
- 包管理器: uv(推荐)
- LLM API Key: OpenAI / Anthropic / Azure OpenAI / 自建兼容端点
git clone https://github.com/OpenSQZ/GTPlanner.git
cd GTPlanner
# 使用 uv 安装依赖
uv sync复制配置模板并设置 API Key:
cp .env.example .env
# 编辑 .env 文件,设置必需的环境变量必需配置:
LLM_API_KEY="your-api-key-here"
LLM_BASE_URL="https://api.openai.com/v1"
LLM_MODEL="gpt-5"详细配置指南(包括常见供应商、Langfuse 等)→ 配置文档
python gtplanner.py进入后直接输入需求,例如:
创建一个视频分析助手,可以自动提取视频字幕、生成摘要和关键要点。
python gtplanner.py "设计一个文档分析助手,支持PDF、Word文档解析和智能问答"CLI 详细文档(会话管理、参数说明等)→ CLI 文档
启动 FastAPI 服务:
uv run fastapi_main.py
# 默认运行在 http://0.0.0.0:11211访问 http://0.0.0.0:11211/docs 查看 API 文档
API 详细文档(端点说明、使用示例等)→ API 文档
cd mcp
uv sync
uv run python mcp_service.pyMCP 详细文档(客户端配置、可用工具等)→ MCP 文档
GTPlanner 支持多种配置方式:
- 环境变量 (.env 文件):API Key、Base URL、Model 等
- 配置文件 (settings.toml):语言、追踪、向量服务等
- Langfuse 追踪(可选):执行过程追踪和性能分析
完整配置指南 → 配置文档
GTPlanner/
├── README.md # 主文档
├── gtplanner.py # CLI 启动脚本
├── fastapi_main.py # API 服务入口
├── settings.toml # 配置文件
│
├── gtplanner/ # 核心代码
│ ├── agent/ # Agent 系统
│ │ ├── cli/ # → [CLI 文档](../../gtplanner/agent/cli/README_zh.md)
│ │ ├── api/ # → [API 文档](../../gtplanner/agent/api/README_zh.md)
│ │ ├── flows/ # 控制流程
│ │ ├── subflows/ # 专业子流程
│ │ └── ...
│ └── utils/ # 辅助函数
│
├── prefabs/ # Prefab 生态系统
│ ├── README_zh.md # → [Prefab 文档](../../prefabs/README_zh.md)
│ └── releases/ # 发布管理
│ ├── community-prefabs.json # Prefab 注册表
│ └── CONTRIBUTING_zh.md # → [Prefab 贡献指南](../../prefabs/releases/CONTRIBUTING_zh.md)
│
├── mcp/ # MCP 服务
│ └── README_zh.md # → [MCP 文档](../../mcp/README_zh.md)
│
├── docs/ # 文档
│ ├── zh/ # 中文文档
│ ├── ja/ # 日文文档
│ ├── configuration.md # 配置指南
│ └── architecture/ # 架构文档
│
├── workspace/ # 运行时目录
│ ├── logs/ # 日志
│ └── output/ # 输出文档
│
└── tests/ # 测试
系统架构文档 → 架构文档
GTPlanner 通过 Prefab 生态系统实现能力扩展。每个 Prefab 都是一个标准化、可复用的 AI 功能组件。
Prefab 是即用型的 AI 功能模块,可以:
- 被发现:GTPlanner 自动识别可用 Prefab
- 被部署:PR 合并后自动部署到平台
- 被集成:通过标准 API 调用
- 版本管理:语义化版本控制
当你贡献一个 Prefab 到 community-prefabs.json 时:
- 扩展规划能力:GTPlanner 知道了一个新的解决方案
- 智能推荐:GTPlanner 会在生成规划时推荐合适的 Prefab
- 自动集成:规划文档中会包含 Prefab 的使用说明
示例 Prefab:
- 媒体处理:视频处理 Prefab - 视频转音频、字幕提取
- 数据服务:高德天气 Prefab - 天气查询
- 文档处理:PDF 解析、Excel 处理
- AI 服务:语音识别、图像识别
使用 Prefab:
通过 Prefab Gateway 网关调用任何已发布的 Prefab:
# 1. 在 AgentBuilder 平台创建 API Key
# 2. 通过网关调用 Prefab
curl -X POST "https://gateway.agentbuilder.com/v1/prefabs/{prefab-id}/execute" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"function": "function_name", "parameters": {...}}'浏览可用 Prefab:
cat prefabs/releases/community-prefabs.json | jq '.'创建自己的 Prefab:
git clone https://github.com/The-Agent-Builder/Prefab-Template.git my-prefab
cd my-prefab
uv sync --dev
# 开发、测试、发布完整 Prefab 文档 → Prefab 指南
网关调用详情 → Prefab 使用指南
我们深信,一个卓越的工具离不开社区的智慧与共建。GTPlanner 期待您的参与!
为什么贡献 Prefab?
每个 Prefab 都会:
- 扩展 GTPlanner 的规划能力
- 帮助其他开发者解决问题
- 被自动纳入推荐系统
- 获得社区认可
如何贡献?
- 使用模板创建 Prefab → Prefab-Template
- 开发并测试你的功能
- 发布 GitHub Release 并上传
.whl文件 - 向
prefabs/releases/community-prefabs.json提交 PR
Prefab 影响力:
- 进入推荐系统:
community-prefabs.json中的 Prefab 会被 GTPlanner 识别 - 智能匹配:规划时自动推荐给合适的场景
- 自动部署:PR 合并后自动部署到 Prefab 平台
详细贡献指南 → Prefab 贡献文档
通过评测驱动的开发方式,提升 GTPlanner 的规划质量和系统性能。
核心代码贡献 → 贡献指南
分享您的使用经验,帮助社区发掘 GTPlanner 的全部潜力:
- 使用案例:真实项目中的应用
- GTPlanner 生成的 PRD:展示规划质量
- 教程和最佳实践:帮助新用户上手
提交案例 → 在 docs/examples/community-cases/ 创建 PR
本项目基于 MIT 许可证。详情请参阅 LICENSE 文件。
- 基于 PocketFlow 异步工作流引擎构建
- 配置管理由 Dynaconf 提供支持
- 旨在通过 MCP 协议与 AI 助手无缝集成
GTPlanner - 用 AI 的力量将您的想法转换为结构化的施工图。




