面向前端工程的领域 Agent 系统，以 SDD 规约驱动为核心约束，通过 MCP 协议实现文件、浏览器、终端的可控感知与执行，内置混合 RAG、幻觉预防、跨会话记忆与技能管理能力。
FrontAgent 是一个面向前端工程的领域 AI Agent 系统，采用两阶段架构（Planner + Executor），以 SDD（Specification Driven Development）作为硬约束层确保生成代码符合项目规范。系统通过 MCP 协议统一管理文件操作、浏览器交互（基于 Playwright）和终端执行三种工具能力，实现可控感知与执行。
在知识层面，FrontAgent 内置远程混合 RAG 引擎，支持 BM25 关键词检索与语义检索并行加权融合，配合 LLM 查询改写和 Cross-Encoder 重排序（兼容 Jina/Cohere），并支持 Weaviate 向量存储与缓存导出导入。针对代码幻觉问题，提供多层幻觉检测与自动 import/export 路径验证。跨会话记忆系统覆盖预加载、运行时召回、任务后持久化与结构化存储四个阶段，持久化项目事实、错误方案和依赖状态。
执行层面具备阶段化自修复机制，每个 phase 内可自动分析错误并生成修复步骤，phase 完成时自动检查模块引用完整性。Skill Lab 模块提供完整的本地技能迭代工作流（脚手架/评估/基准测试/改进/晋升）。可选 LangGraph 图执行引擎支持 checkpoint，仓库管理阶段可自动完成 git commit/push/PR 全流程。项目基于 TypeScript 构建，采用 pnpm monorepo + Turborepo 管理，通过 npm 分发，当前最新版本 v0.1.6，采用 MIT 开源协议。
核心架构#
User Input → Agent Core → Output
│
┌───────────┼───────────┐
▼ ▼ ▼
SDD Layer Planner Executor
(Constraints)(Stage 1) (Stage 2)
│ │ │
└───────────┼───────────┘
▼
MCP Layer
┌──────┬────────┬──────┐
│ File │ Web │Shell │
└──────┴────────┴──────┘
CLI 核心命令#
| 命令 | 说明 |
|---|---|
frontagent init | 初始化 SDD |
frontagent run "<task>" | 执行任务 |
frontagent skill list/scaffold/init-evals/benchmark/improve/promote | Skill Lab 工作流 |
frontagent rag export/import | RAG 缓存导出/导入 |
快速开始#
npm install -g frontagent
export PROVIDER="openai"
export BASE_URL="https://api.openai.com/v1"
export MODEL="gpt-4"
export API_KEY="sk-..."
cd your-project
frontagent init
frontagent run "Create a user login page"
前置要求：Node.js 环境、外部 LLM API Key（OpenAI 或 Anthropic）。若使用 Weaviate 作为向量存储，需额外部署 Weaviate 实例并通过环境变量配置连接信息。