项目开发流程

开发域专用流程。通用生命周期框架见 proc-lifecycle.md。

流程总图

阶段           手动路径                    AI 辅助路径               门禁
────────────────────────────────────────────────────────────────────────────────
1. 价值        写价值文档                  让 AI 帮忙调研竞品、算ROI   能说清为什么做
2. 学习        看文档/试demo              让 AI 找资料、解释概念       搞清楚技术方案
3. 需求        调研→spec→WBS             让 AI 分析需求、拆任务       WBS 每个≤3天
4. 设计        画架构→定API→画页面        让 AI 生成原型               API 定了才编码
5. 编码        just → 写代码 → test      编码 Agent 辅助             lint 0错、测试全绿
6. 部署        配服务→容器化              让 AI 写部署脚本             curl 200
7. 运维        健康检查→备份              cron 自动检查               备份启用
8. 归档        写总结→关任务→移归档       postmortem 模板             文档完整、代码归档
9. 实施（客户现场）部署→培训→验收         process-impl                客户签字
                    ↕
              归纳总结（贯穿全程）

阻塞处理

步骤卡住	处理方式	可选操作
价值不明确	缩到最小可行版本	放弃项目
学不会	换更简单的方案	做 spike 验证
需求确认不了	拆成更小的子问题	跳过模糊需求
设计不确定	做原型再设计	选最简单的方案
编码遇到瓶颈	问 AI 工具	换实现方案
部署失败	回滚到上次稳定版本	换部署策略

被阻塞不是失败。

各步骤详解

第 1 步：价值设计

目标：确认值不值得做

cp ~/DEV/templates/docs/process/process-value.md docs/项目设计/00-价值设计.md

完成标准：

解决什么问题
目标用户
成功指标

门禁：能一句话说清”为什么要做”，否则回去想清楚。

第 2 步：学习研究

目标：搞懂要用什么技术

需要学什么	怎么做
新语言/框架	看官方文档 + 让 AI 总结
新库/工具	试 demo + Claude Code 写示例
业务领域知识	让 AI 搜资料、解释概念
不确定的技术方案	先做 spike（实验性原型）

门禁：

知道用什么技术方案了？
核心概念理解了吗？
不确定的部分做了 spike 验证？

第 3 步：需求工程

目标：知道要做什么、拆成可执行的任务

# 调研
cp ~/DEV/templates/docs/process/process-survey.md docs/项目设计/01-调研记录.md
 
# 规格
cp ~/DEV/templates/docs/process/process-spec.md docs/项目设计/02-需求规格.md
 
# 任务分解
cp ~/DEV/templates/docs/process/process-wbs.md docs/项目设计/03-任务分解.md
 
# 开 Issue
gh issue create --repo OoSunoO/DEV --title "feat: 子任务1" --label feature

门禁：

调研记录完整？
验收标准 Given/When/Then 格式？
WBS 每个子任务 ≤ 3天？
每个子任务都有 Issue？
依赖关系标注了？

第 4 步：设计工程

目标：知道怎么做

# 业务设计
cp ~/DEV/templates/docs/planning/planning-biz.md docs/项目设计/04-业务设计.md
# 功能概要
cp ~/DEV/templates/docs/architecture/arch-function.md docs/项目设计/05-功能概要.md
# 数据概要
cp ~/DEV/templates/docs/architecture/arch-data.md docs/项目设计/06-数据概要.md
# 概要架构
cp ~/DEV/templates/docs/architecture/arch-highlevel.md docs/项目设计/07-概要架构.md
# 详细设计
cp ~/DEV/templates/docs/architecture/arch-detail.md docs/项目设计/08-详细设计.md
# 应用设计（有前端才写）
cp ~/DEV/templates/docs/architecture/arch-app.md docs/项目设计/09-应用设计.md
# 安全设计
cp ~/DEV/templates/docs/ops/ops-safety.md docs/项目设计/10-安全设计.md
# 质量设计
cp ~/DEV/templates/docs/process/process-quality.md docs/项目设计/11-质量设计.md

门禁：

防止跑偏：API 没定之前不要开始写代码。

第 5 步：编码

目标：把设计变成可运行的代码

# 手动开发
cp -r ~/DEV/templates/python-project ~/DEV/active/项目名
just install
 
# AI 辅助
"用 Claude Code 实现这个功能"
"让 Codex 帮我写单元测试"

门禁：

防止跑偏：测试不过不提交。lint 有错不提交。

第 6 步：部署

cp ~/DEV/templates/docs/ops/ops-deploy.md docs/项目设计/12-部署方案.md
just deploy

门禁：

服务启动正常
curl 返回 200
日志无异常
回滚方案已确认

第 7 步：运维

bash ~/DEV/scripts/health-check.sh

门禁：

Uptime Kuma 监控配置了
每日备份启用了
日志轮转配置了

第 8 步：归档

# 写总结
cp ~/DEV/templates/docs/process/process-postmortem.md ~/DEV/docs/项目总结/项目名.md
# 移动项目代码
mv ~/DEV/active/项目名 ~/DEV/archives/
# 关闭 Issue
gh issue close --repo OoSunoO/DEV <号码>

门禁：

总结写完了
好功能已记到 reuse-template
踩坑已记到经验积累
Issue 已关闭

第 9 步：实施（客户现场）

详见 ~/DEV/templates/docs/process/process-impl.md

门禁：客户签字

总体规则

不可跳过的门禁

❌ 验收标准没写 → 不进设计
❌ API 没定 → 不写代码
❌ 测试没写 → 不提交
❌ CI 没跑 → 不合并
❌ 没验证 → 不说完成

什么时候可以简化

MVP / 原型:    只需 spec → 编码 → 测试，跳过完整设计
内部工具:      只需 spec → 编码，但测试不能跳
正式产品:      全流程

Definition of Done

□ 代码已合并
□ 文档已更新（设计决策、API 变更）
□ 部署已验证（对应环境 curl 200）
□ 经验已记录（踩坑或好实践）
□ 如有技术债务 → 已开 Issue 跟踪

快速启动

# 新建项目，一键创建全部文档占位
mkdir -p docs/项目设计
for f in process-value process-survey process-spec process-wbs \
         planning-biz arch-function arch-data arch-highlevel \
         arch-detail arch-app ops-safety process-quality ops-deploy; do
    cp ~/DEV/templates/docs/*/$f.md docs/项目设计/ 2>/dev/null
done
echo "✅ 项目创建完成，按流程指引逐步填写"

Agent 编排参考

编码阶段任务	推荐 Agent	说明
写功能代码	Codex / Claude Code	Codex 先试，复杂任务换 Claude
写测试	Codex	批量生成效率高
代码审阅	Claude Code	深度推理
调研	OpenCode	免费
文档	Hermes	统一格式

孙雪健的数字花园

探索

proc-dev-flow