114 lines
4.9 KiB
Markdown
114 lines
4.9 KiB
Markdown
# AI编程项目全流程编排
|
||
|
||
`AI编程` `项目编排` `代码智能体` `Claude Code` `开发流程`
|
||
|
||
# Software Forge
|
||
|
||
**AI 编程智能体的编排与教学层。**
|
||
|
||
Software Forge 对整个项目生命周期进行排序，确保你不会跳过任何阶段，不会在 API 设计定稿前就开始做 UI，也不会在未经安全校验的情况下上线。它在每个阶段调用最合适的专业工具——无论是你自己的还是生态中的——并可选在每个决策节点向你传授工程原则。
|
||
|
||
> "我有一个想法。接下来怎么做？按什么顺序？各部分如何衔接？能在过程中教我原因吗？"
|
||
|
||
|
||
|
||
## 安装
|
||
|
||
支持 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 |