43 lines
2.4 KiB
Markdown
43 lines
2.4 KiB
Markdown
# 从需求到交付：一套基于 AI 辅助的高质量代码生产实践
|
||
|
||
**来源：** [微信公众号 - OLDLIE](https://mp.weixin.qq.com/s/V8AR1ooSgrafZgH6KgEEOw)
|
||
**作者：** oldlie
|
||
**日期：** 2026年4月11日 19:32
|
||
**标签：** #AI编码 #代码质量 #交付流程 #OpenSpec #Superpowers
|
||
|
||
---
|
||
|
||
## 核心流程
|
||
|
||
### 1. 需求分析与关键点识别
|
||
使用 `openspec explore` 指令向 AI 提出概要需求。核心目的是借助 AI 的信息处理能力，快速识别需求中的关键点、潜在风险和边界条件。
|
||
|
||
### 2. 制定分阶段实现路线图
|
||
利用 `superpower` 技能，要求 AI 将需求转化为清晰、可执行的路线图（Roadmap），将整个项目拆解为多个可管理的阶段。
|
||
|
||
### 3. 前置条件确认与详细设计
|
||
进入每个新阶段前，让 AI 确认所有前置条件是否满足。确认后协作进行详细设计，要求 AI 输出包含后台代码详细设计和关键过程时序图的设计文档，并严格参考既定的代码规范。
|
||
|
||
### 4. 设计审查与规范对齐
|
||
设计文档完成后进行严格审查，确保实现方案完全符合代码规范。**"先设计，后编码"** 的模式让问题在早期被发现和解决，效率远高于在代码写完后再去分散阅读源文件。
|
||
|
||
### 5. 代码实现与自动化审查
|
||
AI 完成代码编写后立即执行 `/review` 指令。`/review` 模式关注的维度（安全性、健壮性）与默认编码模式不同，要求更高，能发现单元测试难以覆盖的逻辑问题。
|
||
|
||
此外，AI 有时倾向于使用最简单而非最高效的方式实现功能，或在处理长上下文时出现"偷懒"现象——人工触发的全面审查必不可少。
|
||
|
||
### 6. 查漏补缺与迭代循环
|
||
`/review` 之后让 AI 根据路线图再次检查当前阶段是否存在遗漏，确认无遗漏且满足进入下一阶段的条件后，再开启新一轮循环。
|
||
|
||
---
|
||
|
||
## 流程设计的深层思考
|
||
|
||
| 设计要素 | 价值 |
|
||
|---------|------|
|
||
| **路线图** | 将宏大目标拆解为具体步骤，减少单次交互的上下文信息量，确保整体目标不偏离 |
|
||
| **详细设计文档** | 集中审核设计逻辑比分散阅读代码更高效，更容易发现深层次问题 |
|
||
| **分步设计** | 管理上下文窗口长度，确保 AI 在每个环节保持高效和精准 |
|
||
|
||
**核心理念：** 通过精心设计的步骤、指令和审查机制，引导 AI 成为"结对编程"伙伴，共同交付高质量的代码。
|