# Agent Forge

**Repository Path**: han-liming/agent-forge

## Basic Information

- **Project Name**: Agent Forge
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-30
- **Last Updated**: 2026-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent Forge ⚒️

Agent Forge 是一个**工具无关（AI-Agnostic）、多层架构的命令行编排器**。它专为大语言模型（如 Cursor, Claude Code, GitHub Copilot）时代的软件开发生命周期（SDLC）提供结构化引导与质量门控。

通过充当项目的 **“单一事实来源”(SSoT)** 和 **上下文编译器**，Agent Forge 在本地为您生成高度定制的 Markdown 提示词。您无需直接消耗 API Token，只需让您偏好的 AI IDE 读取这些编译好的指令即可。

---

## 🌟 四大核心引擎

Agent Forge 将 AI 辅助开发提炼为四个健壮的层次：

1. **基础骨架层 (Skills & Configs)**
   - 统一配置中心（`.forge/config.yaml`），一套配置，多端同步生成 (`CLAUDE.md`, `.cursorrules` 等)。
   - **技能系统** (内置 TDD、Web-App 等技能) 为大模型提供最佳实践。
   - 内置轻量级 SQLite，实现团队级 `decision`, `pattern`, `lesson` 记忆沉淀。

2. **规格层 (Spec Engine)**
   - 灵感来自 OpenSpec，使用 Markdown 将复杂需求结构化为 Proposal, Tech Design 和 Tasks。
   - 命令: `forge propose`, `forge apply`, `forge archive`, `forge specs list`。
   - 命令行动态解析 Markdown 复选框追踪任务进度。

3. **治理层 (Agent Engine)**
   - 定义多种专业角色（如需求分析师、架构师、核心开发、QA）。
   - `forge agent <role> <task>`: 将全局项目宪法与特定角色 Persona 混合，输出 `.forge/active-task.md` 供 IDE 大模型阅读。
   - 包含交互式向导：`forge workflow start`。

4. **质量层 (Quality Engine)**
   - 本地化、隐私优先的安全门控。
   - `forge security-scan`: 毫秒级本地静态扫描，阻断暴露的 AWS 密钥、JWT 和密码。
   - `forge review`: 自动生成含有质量门控核对单的代码审查上下文。
   - `forge test`: 跨包管理器统一 TDD 测试入口。

---

## 🚀 快速开始

### 1. 安装

全局安装 CLI (当前为本地 monorepo 开发阶段):
```bash
npm install -g @rx-agent-forge/cli
```

### 2. 初始化

在项目根目录下初始化 Agent Forge 工作区：
```bash
forge init --mode standard --lang zh-CN
```

### 3. 标准开发工作流

一键开启结构化的特性开发向导：
```bash
forge workflow start --lang zh-CN
```
*根据提示依次完成 Analyst -> Architect -> Developer -> QA 阶段的任务分配。*

### 4. 记忆系统

保存关键的技术决策，避免大模型“失忆”：
```bash
forge memory save decision "使用 PostgreSQL，因为后续强依赖 JSONB 聚合查询。" --lang zh-CN
forge memory list --lang zh-CN
```

### 5. 安全门控

在提交代码前进行本地极速依赖与密钥扫描：
```bash
forge security-scan --lang zh-CN
```

## 📝 开源协议

[MIT](LICENSE)