AI导哈

项目蓝图设计工具

AgenticForge是一款基于Rust的智能项目蓝图设计工具，通过自然语言描述自动生成包含实体、操作、依赖关系、文件结构和测试架构的完整项目设计，解决AI代码生成缺乏整体架构规划的问题。

  • by agentralabs
  • Rust
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 agentralabs/agentic-forge

使用说明

The Forge That Designs Before It Builds

Complete project architecture -- entities, operations, dependencies, file layout, skeletons, and tests -- before any code is generated.

Quickstart · Problems Solved · How It Works · Capabilities · MCP Tools · Benchmarks · Install · API · Concepts · Paper

Agentra生态系统中的姐妹| .forge 格式| 32功能| 15 MCP工具| 41 CLI命令

为什么选择AgenticForge

每个AI代理都从空白页编写代码。在开始键入之前，它不知道项目结构。它猜测实体关系。它创造了依赖关系。它以先出现的任何顺序生成文件。由此产生的架构是不一致的、未经测试的、脆弱的——因为它从未被设计过。

当前的修复程序不起作用。快速工程会给你提示——永远不会有一个完整的架构。模板生成器生成刚性脚手架，打破了力矩要求的变化。手动架构文档在生成第一个文件的那一刻就过时了。

当前AI： 生成代码时不了解它正在构建的项目。 AgenticForge： 首先设计完整的蓝图——每个实体、每个操作、每个依赖关系、每个文件、每个测试——然后生成在严格的约束下填补空白。

AgenticForge 从自然语言意图创建完整的项目蓝图。不是“生成项目”。您的代理有 建筑师 --实体推理、依赖解析、文件结构规划、代码骨架生成和测试架构——在任何实现开始之前都已解决。

已解决的问题（请先阅读）

  • 问题： AI代理在不理解项目结构的情况下生成代码。 解决了的： 蓝图引擎在编写任何代码之前将意图分解为层、实体、操作和依赖关系——代理总是知道架构。
  • 问题： 实体关系被猜测，导致数据模型不一致。 解决了的： 通过关系映射和字段推导的实体推理从自然语言描述中生成一致的数据模型。
  • 问题： 依赖关系是临时的，发现版本冲突的时间较晚。 解决了的： 通过版本解析和冲突检测进行依赖推理，可以在第一行代码之前发现问题。
  • 问题： 生成的文件结构混乱且不稳定。 解决了的： 通过导入图分析和模块层次结构生成文件结构，可以生成干净、可测试的项目布局。
  • 问题： 测试覆盖率是一种事后的想法，在一代人之后才加上。 解决了的： 测试架构是蓝图的一部分——测试用例、夹具、集成计划和模拟规范与它们测试的代码一起设计。
  • 问题： 每次都从头开始重新构建相同的项目类型。 解决了的： 蓝图捕获了可重用的架构决策 .forge 可以调整而不是重新创建的文件。
# Design your architecture, then build with confidence -- four commands
aforge blueprint create my-api --domain api --description "REST API for task management"
aforge entity infer <id> "Users create tasks assigned to teams with deadlines"
aforge structure generate <id>
aforge test generate <id>

四个命令。一个完整的架构。一 .forge 文件包含所有内容。适用于Claude、GPT、Ollama或您接下来切换到的任何LLM。

运作原理

建筑

v0.1.0 --蓝图引擎基础设施。

AgentForge是一个Rust原生蓝图引擎，它将项目架构视为一级数据。实体之间存在关系。操作有签名。依赖项有版本。测试有目标。

核心能力

  • 层分解 --将意图分解为架构层（表示、应用程序、域、基础设施），层之间有依赖规则。
  • 实体推断 --从自然语言项目描述中提取实体、字段、关系和验证规则。
  • 操作设计 --推断每个实体的CRUD操作、查询模式、异步边界和错误流。
  • 结构生成 --为目标语言生成文件结构、导入图形、模块层次结构和配置布局。
  • 依赖解析 --从域和实体分析中推断依赖关系，解析版本，提取API规范，并检测冲突。
  • 骨架生成 --生成具有函数签名、契约和生成顺序规划的类型优先代码骨架。
  • 部件接线 --映射组件依赖关系、数据流、初始化序列和关闭序列。
  • 测试体系结构 --生成测试用例、夹具、集成测试计划和模拟规范以及他们测试的代码。

架构概述

+-------------------------------------------------------------+
|                     YOUR AI AGENT                           |
|           (Claude, Cursor, Windsurf, Cody)                  |
+----------------------------+--------------------------------+
                             |
                  +----------v----------+
                  |      MCP LAYER      |
                  |   15 Tools + stdio  |
                  +----------+----------+
                             |
+----------------------------v--------------------------------+
|                    FORGE ENGINE                              |
+-----------+-----------+------------+-----------+------------+
| Write     | Query     | 32         | Blueprint | Token      |
| Engine    | Engine    | Capabilities| Validator | Conservation|
+-----------+-----------+------------+-----------+------------+
                             |
                  +----------v----------+
                  |     .forge FILE     |
                  | (your architecture) |
                  +---------------------+

蓝图生命周期

Intent -> Decompose -> Infer Entities -> Design Operations -> Resolve Deps
  |                                                                    |
  +-- Structure -> Skeleton -> Wire Components -> Generate Tests ------+
                                                                       |
                                                              .forge file

发动机启动时 意图，解析自然语言项目描述。 分解 将关注点分层。 推断实体 提取数据模型。 设计操作 创建函数签名。 解决Deps问题 决定图书馆。 结构 规划文件布局。 骨架 生成类型优先的代码。 电线 映射组件依赖关系。 生成测试 设计测试架构。结果是便携式 .forge 包含完整蓝图的文件。

32功能

AgenticForge提供32种能力，分为八个层次，具体程度越来越高：

层级 能力 重点
T1：分解 层分解、关注点分析、边界推断、交叉检测 应该如何组织？
T2：实体 实体推理、关系映射、字段推导、验证规则 什么是数据模型？
T3：操作 操作推理、签名生成、错误流设计、异步分析 操作是什么？
T4：结构 文件结构、导入图、模块层次结构、配置设计 一切都去哪儿了？
T5：依赖性 依赖关系推理、版本解析、API提取、冲突解决 需要什么库？
T6：蓝图 骨架生成、类型优先物化、合同规范、生成计划 代码是什么样子的？
T7：集成 组件接线、数据流、初始化顺序、关闭顺序 它是如何连接的？
T8：测试 测试用例、测试夹具、集成计划、模拟规范 它是如何测试的？

完整功能文档->

MCP工具

AgenticForge曝光 15个MCP工具 对于AI代理：

蓝图工具

工具 说明
forge_blueprint_create 根据意图创建新的项目蓝图
forge_blueprint_get 按ID检索蓝图
forge_blueprint_update 更新现有蓝图
forge_blueprint_validate 验证蓝图是否可构建
forge_blueprint_list 列出所有蓝图

实体工具

工具 说明
forge_entity_add 将实体添加到蓝图
forge_entity_infer 根据描述推断实体

依赖工具

工具 说明
forge_dependency_resolve 解决所有依赖关系
forge_dependency_add 手动添加依赖关系

生成工具

工具 说明
forge_structure_generate 生成文件结构
forge_skeleton_create 创建代码骨架
forge_test_generate 生成测试架构
forge_import_graph 生成导入图
forge_wiring_create 创建元件接线
forge_export 导出蓝图

完整的MCP文档->

基准测试

操作 延迟
蓝图创建 <1ms
实体推理（10个实体） <5毫秒
依赖解析（20 deps） <2 ms
结构生成（50个文件） <5毫秒
完整管道（意图绘制蓝图） <50 ms
验证通过 <3毫秒

所有基准测试均在Apple Silicon上进行，发布模式，单线程。

快速启动

# Install
cargo install --path crates/agentic-forge-cli

# Create a blueprint from intent
aforge blueprint create my-api --domain api --description "REST API for task management"

# Infer entities from natural language
aforge entity infer <blueprint-id> "Users create tasks assigned to teams with deadlines and comments"

# Resolve dependencies
aforge dependency resolve <blueprint-id>

# Generate file structure and skeletons
aforge structure generate <blueprint-id>
aforge skeleton create <blueprint-id>

# Generate test architecture
aforge test generate <blueprint-id>

# Validate the blueprint
aforge blueprint validate <blueprint-id>

# Export
aforge export json <blueprint-id>

MCP服务器

aforge serve --mode stdio

兼容Claude Desktop、Cursor、Windsurf、VS Code、Cody和任何MCP客户端。

安装

源自源头

git clone https://github.com/agentralabs/agentic-forge.git
cd agentic-forge
cargo install --path crates/agentic-forge-cli

快速安装

curl -fsSL https://agentralabs.tech/install/forge | bash

配置文件变体：

curl -fsSL https://agentralabs.tech/install/forge/desktop | bash    # Claude Desktop + Cursor
curl -fsSL https://agentralabs.tech/install/forge/terminal | bash   # CLI only
curl -fsSL https://agentralabs.tech/install/forge/server | bash     # Server mode with auth
npm install @agenticamem/forge

独立担保： AgentForge完全独立运行。不需要其他姐妹、外部服务或协调器。

构建和测试

cargo build --workspace
cargo test --workspace        # 519 tests

文档

许可证

麻省理工学院——见 许可证.

相关 MCP