16gagent/README.md

Software Generator

需求文本 → 可发布软件。一条命令，370ms。

7 个 Agent 组成的端到端软件生成管线，从自然语言需求到可发布的桌面应用。

快速开始

# 生成完整项目（以 PetCare 为例）
node scripts/project-intake-agent.mjs --input "做一个宠物护理管理平台" --output /tmp/petcare/prd.json
node scripts/architecture-agent.mjs --input /tmp/petcare/prd.json --output /tmp/petcare/arch.json
node scripts/frontend-builder-agent.mjs --prd /tmp/petcare/prd.json --arch /tmp/petcare/arch.json --output /tmp/petcare/frontend
node scripts/backend-builder-agent.mjs --prd /tmp/petcare/prd.json --arch /tmp/petcare/arch.json --output /tmp/petcare/backend
node scripts/fullstack-composer-agent.mjs --prd /tmp/petcare/prd.json --arch /tmp/petcare/arch.json --output /tmp/petcare/fullstack
node scripts/electron-builder-agent.mjs --input /tmp/petcare/fullstack --output /tmp/petcare/electron --prd /tmp/petcare/prd.json
node scripts/release-builder-agent.mjs --input /tmp/petcare/fullstack --output /tmp/petcare/release

架构

需求文本
  ↓ SF-01 project-intake-agent
PRD JSON
  ↓ SF-02 architecture-agent
Architecture JSON
  ↓ SF-03 frontend-builder-agent
Web Frontend (Next.js)
  ↓ SF-04 backend-builder-agent
API Backend (Express + SQLite)
  ↓ SF-05 fullstack-composer-agent
Fullstack Monorepo
  ↓ SF-06 electron-builder-agent
Desktop App (Electron)
  ↓ SF-07 release-builder-agent
Release Package

7 个 Agent

Agent	文件	职责
SF-01	scripts/project-intake-agent.mjs	需求分析 → PRD JSON
SF-02	scripts/architecture-agent.mjs	PRD → 架构设计
SF-03	scripts/frontend-builder-agent.mjs	PRD + 架构 → Next.js 前端
SF-04	scripts/backend-builder-agent.mjs	PRD + 架构 → Express 后端
SF-05	scripts/fullstack-composer-agent.mjs	前端 + 后端 → Monorepo
SF-06	scripts/electron-builder-agent.mjs	全栈项目 → Electron 桌面应用
SF-07	scripts/release-builder-agent.mjs	桌面应用 → Release 包

各 Agent 用法

SF-01 — 需求分析

node scripts/project-intake-agent.mjs --input "需求描述" --output prd.json
node scripts/project-intake-agent.mjs --input prd.md --output prd.json  # 从文件读取

输出: prd.json — 包含 projectName, domain, features, pages, apiRequirements, personas, userStories

SF-02 — 架构设计

node scripts/architecture-agent.mjs --input prd.json --output arch.json

输出: arch.json — 包含 modules, dataFlows, directoryStructure, databaseSchema, apiDesign

SF-03 — 前端生成

node scripts/frontend-builder-agent.mjs --prd prd.json --arch arch.json --output frontend/

输出: Next.js 项目 — app/, components/, hooks/, services/, types/

SF-04 — 后端生成

node scripts/backend-builder-agent.mjs --prd prd.json --arch arch.json --output backend/

输出: Express + SQLite 项目 — src/routes/, src/services/, src/db/, src/middleware/

SF-05 — 全栈组装

node scripts/fullstack-composer-agent.mjs --prd prd.json --arch arch.json --output fullstack/

输出: Monorepo — apps/web/, apps/api/, packages/shared-types/, packages/shared-config/

SF-06 — 桌面封装

node scripts/electron-builder-agent.mjs --input fullstack/ --output electron/ --prd prd.json

输出: Electron 项目 — electron/main.ts, preload.ts, ipc.ts, tray.ts, updater.ts

SF-07 — 发布打包

node scripts/release-builder-agent.mjs --input fullstack/ --output release/

输出: Release 包 — version.json, manifest.json, checksums.txt, release-notes.md, build-info.json, windows/, macos/, linux/

输出结构

Fullstack Monorepo

fullstack/
├── apps/
│   ├── web/          # Next.js 前端
│   │   ├── app/      # 页面路由
│   │   ├── components/
│   │   ├── hooks/
│   │   ├── services/
│   │   └── types/
│   └── api/          # Express 后端
│       └── src/
│           ├── routes/
│           ├── services/
│           ├── db/
│           └── middleware/
├── packages/
│   ├── shared-types/
│   └── shared-config/
└── package.json

Release Package

release/
├── version.json          # 版本元数据
├── build-info.json       # 构建环境信息
├── README.md
├── manifests/
│   └── manifest.json     # 文件列表 + SHA256
├── checksums/
│   └── checksums.txt     # SHA256 校验
├── release-notes/
│   └── release-notes.md  # 发布说明
├── windows/              # Windows 安装器占位
├── macos/                # macOS DMG 占位
└── linux/                # Linux AppImage 占位

测试

# 单元测试（各 Agent）
node --test test/project-intake-agent.test.mjs
node --test test/architecture-agent.test.mjs
node --test test/frontend-builder-agent.test.mjs
node --test test/backend-builder-agent.test.mjs
node --test test/fullstack-composer-agent.test.mjs
node --test test/electron-builder-agent.test.mjs
node --test test/release-builder-agent.test.mjs

# E2E 回归测试（10 领域 × 7 阶段 = 170 检查）
node --test test/e2e-regression.test.mjs

Benchmark

# E2E Benchmark（10 领域全量）
node scripts/e2e-benchmark-v1.mjs

# 单领域 Benchmark
node scripts/domain-benchmark.mjs --domain petcare

# Release Benchmark
node scripts/release-benchmark.mjs

技术栈

层	技术
前端	Next.js 15 + React 19 + Tailwind CSS 4
后端	Express + better-sqlite3 + JWT
桌面	Electron 35 + electron-builder
测试	Node.js built-in test runner

已验证领域

领域	特性	页面	API	文件
PetCare	7	6	5	162
CRM	5	4	5	144
Inventory	6	5	6	164
Ticket	7	5	6	162
Blog CMS	5	3	3	136
Project Mgmt	5	4	5	126
HR	7	5	6	162
Asset	5	4	5	126
Course	6	5	6	158
Appointment	5	4	5	126

里程碑

• v1.0.0-mvp — Software Generator MVP v1 (2026-06-05)
  • 7 Agents, 7,941 LoC
  • 10/10 领域 E2E PASS
  • 170/170 回归测试 PASS