初衷

AI 编程正在变成一种新的开发常态。现在很多开发者已经不再完全手写代码，而是、重构和测试。但当 AI 真正进入日常开发后会出现一个很现实的问题：AI 可以帮我们写代码，但不一定能持续写出风格统一、结构一致、可维护的代码。是在团队协作或长期项目中，不同开发者使用的提示词不同、模型不同、编码习惯不同。最终生成出来的代码可能在这些方面产生差异：

• 目录结构不一致
• 命名风格不一致
• Agent 拆分方式不一致
• 工具调用方式不一致
• 配置和环境变量管理方式不一致
• 错误处理和日志规范不一致

使用者痛点

• 重复搭建基础设施：每次新建 Agent 项目都要重新配置 FastAPI、LangChain、LangGraph 等依赖，耗时且易出错。
• 上下文解释成本高：在提示词里反复描述项目结构、技术选型和实现规范，导致 token 消耗爆表。
• 维护成本飙升：代码风格不统一导致后期阅读、调试和重构困难，特别是多子代理协作的复杂场景。其实，
• 技能与工具集成碎片化：每个项目都要手动编写技能加载器、MCP 中间件等。缺乏可复用模板，
• 人工审批流程难以统一：不同项目实现方式各异。导致审批逻辑分散，安全风险增加。

针对这些痛点，本项目提供了一个“工程模板”。把 Agent 项目中通用、重复、容易出错的部分沉淀成统一结构，让 AI 与开发者在同一套规范下工作。模板，开发者无需每次从零搭建基础能力，也不必在提示词里重复描述技术选型。从而显著降低 token 消耗，加快功能迭代，并提高代码可维护性。

概述

技术栈

Agent 后端

• 语言：Python
• Web 框架：FastAPI
• Agent 框架：LangChain + LangGraph
• L​LM 接口：OpenAI API
• 包管理：uv
• 服务器：Uvicorn

Web 前端

• 框架：React + TypeScript
• 建立工具：Vite
• : React Router v7
< li> Sass < li> Axios < li> @microsoft/fetch-event-source < / ul>

Agent 后端模块概览

Agent 模块

Main Agent:通过 create_main_agent创建。负责整体对话协调，通过 task 工具调度子代理。

Router Agent:通过 create_router_agent创建，使用 RouteAgentMiddleware 注册 route 工具。主 Agent 调用该工具后内部 StateGraph 会先。怎么说呢，

• AppAgentContext : 使用者上下文.
• AppAgentState : Agent 状态。 继承自 AgentState
• RouterState : 路由代理状态，包括 query 、 routers 、 router 、 results 和 final_result。.
• init_postgres_checkpointer/close_postgres_checkpointer: 初始化 /关闭 Checkpointer 链接池。
• init_postgres_store/close_postgres_store: 初始化 /关闭 Store 链接池。

MCP Client 中间件:

• MCPClientMiddleware : 与 MCP Server 建立连接，实现动态工具加载与注入。支持配置多个 MCP Server；自动为工具添加前缀避免冲突；提供 ignore_tools 参数过滤无关工具；支持 callbacks 与 tool_interceptors 功能。.

 技能程序:

• SkillLoader : 抽象技能加载器接口。
• DirectorySkillLoader : 从本地目录读取技能。
• RemoteSkillLoader : 从远程源拉取技能。.

Web 模块

 服务层: 

• FastAPI  REST API 入口
•  全局异常处理: 
•  认证中间件:  基于请求头的 token 验证
•  生命周期管理:   

< b>在误流控到后台>

Main Agent 使用 task 工具将请求分派给具体子代理，实现业务拆分与并行执行。

1. User 请求 → Main Agent 接收并解析。
2. Main Agent 判断需要调用的子代理类型。l i>
1. User 请求 → Router Main Agent 接收。l i>
2. Main Agent 调用 route 工具，将当前消息历史包装为 {"query": 使用者输入} 并传入图内部。l i>
3. "Router Graph" 根据预设的描述匹配一个或多个 RouteTaskAgent。l i>