# AI编程项目全流程编排

`AI编程` `项目编排` `代码智能体` `Claude Code` `开发流程`

# Software Forge

**AI 编程智能体的编排与教学层。**

Software Forge 对整个项目生命周期进行排序，确保你不会跳过任何阶段，不会在 API 设计定稿前就开始做 UI，也不会在未经安全校验的情况下上线。它在每个阶段调用最合适的专业工具——无论是你自己的还是生态中的——并可选在每个决策节点向你传授工程原则。

> "我有一个想法。接下来怎么做？按什么顺序？各部分如何衔接？能在过程中教我原因吗？"

![Software Forge 演示](assets/demo.gif)

## 安装

支持 Claude Code、Cursor、Codex、Copilot 以及任何兼容 Agent Skills 标准的智能体。

```bash
# 插件安装（推荐）
/plugin install software-forge@AhmedHamadto/software-forge
```

```bash
# 或通过 npx
npx add-skill AhmedHamadto/software-forge
```

```bash
# 或克隆后安装
git clone https://github.com/AhmedHamadto/software-forge.git
cd software-forge && ./install.sh

# 按组安装
./install.sh --core    # 编排器 + TDD + 调试 + 代码审查（15 个技能）
./install.sh --web     # Core + UI/UX + 安全（20 个技能）
./install.sh --mobile  # Core + iOS/macOS 设计 + 安全（20 个技能）
./install.sh --learn   # Core + 工程导师（16 个技能）
```

## 使用

在 Claude Code 中输入：`/software-forge`

它会询问你正在构建什么，对你的项目进行分类，选择合适的阶段，并引导你逐一完成。

独立命令：`/brainstorm` | `/system-design` | `/write-plan` | `/security-audit` | `/stack-audit`

## 与众不同之处

- **它是编排器，而非又一个技能。** 对 30 个内置技能进行排序，并与 349+ 个生态技能集成——包括 Figma MCP、Motion AI Kit、Trail of Bits、Context7 等。
- **它教你工程知识。** 学习模式在每个阶段都包裹了自适应教学——苏格拉底式提问、决策关卡，以及覆盖 17 本书中 31 个概念领域的能力追踪。
- **它与生态深度集成。** 在每个阶段检查可用的 MCP 服务器和技能，使用真实的设计令牌、最新文档，或退回到以书籍为基础的提问。

## 阶段

| # | 阶段 | 参考依据 |
|---|------|---------|
| 0 | 项目分类 | 路由逻辑 |
| 0.5 | 现有系统评估 | 仅棕地项目 |
| 1 | 头脑风暴 | — |
| 2 | 领域建模 | *领域驱动设计*（Evans） |
| 3 | 系统设计 + 安全 | *数据密集型应用系统设计*（Kleppmann） |
| 4 | 弹性模式 | *Release It!*（Nygard） |
| 5 | ML 流水线设计 | *设计机器学习系统*（Huyen） |
| 6 | 边缘架构 | IoT 模式 |
| 7 | API 规范 | 契约优先设计 |
| 8 | 语音提示设计 | — |
| 9 | 基础设施设计 | *基础设施即代码*（Morris） |
| 10 | UI 设计 | *Refactoring UI*、*Every Layout*、*设计系统* |
| 11 | UX 设计 | *点石成金*、*About Face*、*包容性设计模式* |
| 12 | 动效设计 | *生命的幻觉*、*Animation at Work*、*设计界面动画* |
| 13 | 成本分析与风险 | 单位经济学、风险登记册 |
| 14 | 实施规划 | *测试驱动的面向对象软件开发*（Freeman & Pryce） |
| 15 | 实施 | — |
| 16 | 安全验证 | — |
| 17 | 可观测性设计 | *可观测性工程*（Majors） |
| 18 | ML 验证 | *可靠的机器学习*（Chen 等） |
| 19 | 打磨与审查 | *Refactoring UI*、*点石成金* |
| 20 | 回顾复盘 | 流程审查 |

## 配套工具

与 [developer-guard](https://github.com/AhmedHamadto/developer-guard) 搭配使用，提供提交前安全检查和上线前审计。

```bash
/plugin install developer-guard@AhmedHamadto/developer-guard
```

## 文档

- [快速参考](docs/QUICK-REFERENCE.md) — 单页速查表——命令、技能、工作流、注意事项
- [完整指南](docs/FULL-GUIDE.md) — 全部 30 个技能、阶段详情、书籍参考、故障排查
- [架构说明](docs/ARCHITECTURE.md) — 编排器、阶段与技能的连接方式
- [推荐 MCP](docs/recommended-mcps.md) — 增强特定阶段的免费工具
- [贡献指南](CONTRIBUTING.md) — 如何添加技能或改进阶段
- [改进计划](docs/improvement.md) — 当前路线图

## 致谢

**参考自：**
- 执行流水线技能（写计划、执行计划、子智能体驱动开发、TDD、调试、git worktree、代码审查）来自 Jesse Vincent 的 [obra/superpowers](https://github.com/obra/superpowers)
- 插件打包结构和多平台配置来自 Affaan Mustafa 的 [everything-claude-code](https://github.com/affaan-m/everything-claude-code)

**由 Software Forge 自主构建：**
- 编排器——项目分类、路由表、阶段排序、恢复协议
- 20 个生命周期阶段，按项目类型进行条件路由
- 10 个内联设计阶段，以 17 本工程书籍为基础
- 覆盖 31 个概念领域的自适应工程导师与能力追踪
- 生态集成层——Figma MCP、Motion AI Kit、Context7 等

## 许可证

MIT