satisficing-dev-workflow

name	satisficing-dev-workflow
description	满意解标准化软件开发流程。基于第一性原理的工程化开发方法论。 适用场景: 1. 构建任何新功能或应用 —— 触发 头脑风暴 → 计划 → 子代理执行循环 2. 调试 Bug 或测试失败 —— 触发系统化根因分析流程 3. 用户说"开发""添加功能""修复问题" 不适用: 单行修复(直接编辑)、只读代码、非编码任务 要求: exec工具、sessions_spawn工具

满意解开发流程 —— Satisficing Dev Workflow

基于 obra/superpowers 改编 | 适配 OpenClaw 环境 | 第一性原理工程化

---

核心理念

不是写代码，是解决问题。

Vibe Coding 能出原型，但生产系统需要工程化。 原型占软件工程的 1%，剩下 99% 在边界情况、竞态条件、错误处理。

本流程确保:

• 需求清晰再动手
• 设计评审再编码
• 测试先行再实现
• 双重审查再合并

---

五阶段流程

想法 → 头脑风暴 → 写作计划 → 子代理构建(TDD) → 代码审查 → 完成分支

每个编码任务必须经过此流程。 "太简单不需要设计" —— 永远是错的。

---

Phase 1: 头脑风暴 (Brainstorming)

触发: 用户想构建某物。触碰任何代码前激活。

执行步骤:

1. 探索项目上下文

   • 检查现有文件、文档、近期提交
   • 理解项目结构和约束

2. 澄清问题 —— 每次只问一个，优先选择题

   • 你真正想做什么？(目的)
   • 有什么约束？(时间、技术栈、依赖)
   • 成功是什么样子？(成功标准)
   • 不应该做什么？(范围边界)

3. 提出 2-3 种方案 —— 带权衡分析和推荐

   • 方案A: [简述]
   • 方案B: [简述]
   • 方案C: [简述]
   • 推荐: [方案X]，因为...

4. 分阶段呈现设计 —— 按复杂度逐步展开，每阶段获得批准

   • 架构概览
   • 组件及职责
   • 数据流
   • 错误处理策略
   • 测试策略

5. 写入设计文档

   • 路径: docs/plans/YYYY-MM-DD-<主题>-design.md
   • 提交 commit