AgentForge

English | 中文 | 日本語

专为业务开发设计的TypeScript全栈+AI脚手架，让AI Agent开发像搭积木一样简单

🚀 立即起步

安装

npm install -g agentforge

创建新项目

agentforge create my-agent-app
cd my-agent-app
npm run dev

为什么选择 AgentForge

AgentForge不是单纯AI Agent原型工具，而是面向企业业务开发的TypeScript全栈脚手架。它将前端、后端、工具、测试与AI助手协作规则统一在一个仓库中，适合快速构建SaaS、内部业务系统和行业型产品。

• ✅ 业务开发基座：提供可组合的业务模块和模板，而不是只做Agent实验
• ✅ AI助手友好：内置 Copilot、Claude Code、Cursor、Windsurf 等助手规则
• ✅ 全栈统一：前端、后端与工具链都用同一套TypeScript类型系统
• ✅ 业务场景优先：直接支持客服、订单、知识库、自动化流程等实际功能
• ✅ 替代传统低代码/SaaS：开发者可在代码中保留可维护性和扩展性，同时享受助手加速

✨ 特性

• 🧩 积木式开发 - 业务功能、Agent、工具、UI、API 模块可增量组合
• 🤖 AI助手友好 - 提供根目录 CLAUDE.md、AGENTS.md、.github/copilot-instructions.md、.windsurf/rules/、.cursor/rules/
• 🧠 业务驱动提示词 - 规则文件让主流AI助手理解项目目标和边界
• 🔧 全栈TypeScript - 前后端统一技术栈，类型安全
• ⚡ 开箱即用 - 预配置最佳实践，专注业务逻辑
• 🎯 企业导向 - 避免过度工程化，专注可交付业务成果

📦 项目结构

my-agent-app/
├── CLAUDE.md                    # Claude Code（仓库根目录）
├── AGENTS.md                    # Cursor / Codex / Windsurf
├── .github/
│   └── copilot-instructions.md  # GitHub Copilot 仓库说明
├── .windsurf/rules/             # Windsurf Cascade 规则
├── .cursor/rules/               # Cursor 项目规则（.mdc）
├── src/
│   ├── agents/          # Agent定义
│   ├── tools/           # 工具集合
│   ├── components/      # UI组件
│   └── utils/           # 工具函数
├── apps/
│   ├── web/            # 前端应用 (Next.js)
│   └── api/            # 后端API (Fastify)
├── docs/               # 项目文档（可选）
└── tests/              # 测试文件

🎯 核心原则

AgentForge基于Andrej Karpathy观察到的LLM编程陷阱，提供四大核心原则：

1. 思考先于编码

• 明确假设，不隐藏困惑
• 暴露权衡，主动寻求澄清
• 遇到不确定时停止并提问

2. 简洁优先

• 最小化代码解决实际问题
• 不添加未要求的功能
• 避免为单一用途创建抽象

3. 精确修改

• 只修改必要的部分
• 清理自己的"烂摊子"
• 匹配现有代码风格

4. 目标驱动

• 定义成功标准并验证
• 将任务转化为可验证目标
• 循环直到达成目标

🛠️ 技术栈

前端

• 框架: Next.js 14 (App Router)
• UI: TailwindCSS（shadcn/ui 组件可作为可选模板）
• 状态管理: Zustand
• 类型检查: TypeScript strict mode

后端

• 运行时: Node.js 18+
• 框架: Fastify
• ORM: Prisma
• 验证: Zod
• 测试: Vitest

AI集成

• SDK: OpenAI、Anthropic官方SDK
• 向量数据库（可选）: Pinecone/Chroma（通过可选集成包）
• 本地模型（可选）: Ollama（通过可选集成）
• 工具调用: Function calling标准化

📚 文档

• 技术实现与架构说明

🤝 贡献

欢迎贡献代码！请查看 贡献指南。

📄 许可证

MIT License - 查看 LICENSE 文件了解详情。

🙏 致谢

基于 Andrej Karpathy 对LLM编程行为的深刻洞察，以及 andrej-karpathy-skills 项目的优秀实践。