---
slug: "agentic-spec-forge"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/tikazyq/agentic-spec-forge@main/README.md"
repo: "https://github.com/tikazyq/agentic-spec-forge"
source_file: "README.md"
branch: "main"
---
# AGENTIC SPEC FORGE（ASF） - AI驱动的项目规格脚手架锻造工具

> 🎯 **一句话**：告诉AI你要做什么项目，30-60分钟自动生成完整的开发指南
>
> ✨ **支持主流AI工具**：Cursor、Trae、Codex、Claude Code、Windsurf、Cline 等  
> ✨ **智能适配复杂度**：从快速验证到严格控制，AI自动判断详细程度

## 🚀 30秒快速开始

### 立即启动
```
载入 ASF_BUILD_SPEC_SCAFFOLD.md

我要做一个在线书店管理系统，主要功能是图书管理、销售统计和客户管理。
我们一起商量着来，不要太快也不要太慢。
```

AI会自动：
- ✅ 生成项目结构和开发指南（30-60分钟）
- ✅ 设定合适的质量标准（需求→设计→实现）
- ✅ 编译执行规范（ExecSpec，`ExecSpec*`）并支持按 SubPlan/Round 落成代码与测试

### 核心价值

**解决的问题**：
- ❌ 新项目不知道从哪开始，文档混乱，重复造轮子

**ASF的方案**：
- ✅ **4-Session演进**：生产脚手架→推敲与维护→编译执行规范→落实执行规范
- ✅ **双层输出**：spec/（独立可交付）+ _sys/（AI协作基础设施）
- ✅ **智能适配**：AI根据项目特点自动调整复杂度



---

## 🎯 什么是ASF？

**AGENTIC SPEC FORGE（ASF）** 是AI驱动的项目规格脚手架锻造工具：
- **AGENTIC** - AI驱动的智能生成 (vs 静态模板)
- **SPEC** - 输出项目规格文档
- **FORGE** - 锻造工具隐喻

### 4-Session演进架构

```mermaid
graph LR
    subgraph S1 [Session 1: 生产脚手架]
    A[ASF工具] -->|30-60分钟| B[初始脚手架]
    end
    
    subgraph S2 [Session 2: 推敲与维护]
    B -->|完善细节| C[定稿规格]
    end
    
    subgraph S3 [Session 3: 编译执行规范]
    C -->|智能分解| D[ExecSpec（执行规范）]
    end
    
    subgraph S4 [Session 4: 落实执行规范]
    D -->|Round/TDD| E[代码与测试]
    end
    
    style S1 fill:#e1f5fe,stroke:#01579b
    style S2 fill:#f3e5f5,stroke:#4a148c
    style S3 fill:#e8f5e8,stroke:#1b5e20
    style S4 fill:#fff3e0,stroke:#e65100
```

**简单理解**：就像装修房子，ASF是**装修公司**，先出**初步方案**(脚手架)，您确认后变成**施工图纸**(规格)，再编译为**执行规范**(ExecSpec)，最后施工交付**精装房**(代码)。

---

## 📁 生成的项目结构

```
{您的项目}/
├── SPEC_READ_FIRST.md             # 👨‍💻 人类用户入口
├── SPEC_AI_AGENT_CONTROL.md       # 🤖 AI Agent控制中心
├── spec/                          # 📦 核心产品（可独立交付）
│   ├── requirements/              # 需求文档
│   ├── design/                    # 设计文档
│   └── implementation/            # 实现文档
├── _exec_specs/                   # 📋 ExecSpec 产物（Session 3 生成；Session 4 输入）
│   ├── ExecSpecMasterPlan_L*.md
│   ├── ExecSpecSubPlan_*_L*.md
│   ├── ExecSpecMasterConstraints_L*.md
│   └── ExecSpecMasterDashboard_L*.md
└── _sys/                          # 🛠️ AI协作基础设施
    ├── ENTRY_STAGE_1_REQUIREMENTS.md
    ├── ENTRY_STAGE_2_DESIGN.md
    ├── ENTRY_STAGE_3_IMPLEMENTATION_PLANNING.md
    ├── ENTRY_BUILD_EXEC_SPECS.md   # Session 3 编译执行规范入口
    └── ...                        # 框架支持文件
```

### 双层架构的核心价值

| 目录 | 定位 | 交付性 | 用途 |
|------|------|--------|------|
| **`spec/`** | 核心产品 | ✅ 独立可交付 | 可打包给任何第三方直接使用 |
| **`_sys/`** | AI工具设施 | ❌ 内部使用 | Session 2-4 AI协作支持 |

> 📌 说明：`_exec_specs/` 在 Session 3 生成（`ExecSpec*`），作为 Session 4 的可执行输入，可按需重新编译生成。

---

## 📚 了解更多

### 立即开始
- 📖 [ASF完整指南](https://github.com/tikazyq/agentic-spec-forge/blob/HEAD/AGENTIC_SPEC_FORGE/_docs/getting_started.md) - 5分钟了解核心概念和选择路径
- 🚀 [Session 1: 生产脚手架](https://github.com/tikazyq/agentic-spec-forge/blob/HEAD/AGENTIC_SPEC_FORGE/_docs/session1_scaffold_generation.md) - 30-60分钟快速启动
- 📋 [完整案例：在线书店](https://github.com/tikazyq/agentic-spec-forge/blob/HEAD/AGENTIC_SPEC_FORGE/_docs/_support/spec_end_to_end_workflow_example.md) - 看看实际产出效果

### 深度理解（可选）
- 💡 [ASF设计理念与架构](https://github.com/tikazyq/agentic-spec-forge/blob/HEAD/AGENTIC_SPEC_FORGE/_docs/_support/methodology_overview.md)
- 📋 [Artifact类型详解](https://github.com/tikazyq/agentic-spec-forge/blob/HEAD/AGENTIC_SPEC_FORGE/_docs/_support/core_concepts_glossary.md)
- 🔧 [质量检查工具](https://github.com/tikazyq/agentic-spec-forge/blob/HEAD/AGENTIC_SPEC_FORGE/_docs/_support/skill_usage_guide.md)

---

**🎯 立即开始你的AI-Coding之旅！** 

载入 `ASF_BUILD_SPEC_SCAFFOLD.md` 告诉AI你的项目想法即可 🚀