SillySpec

Appearance

绿地项目流程 ​

绿地项目（Greenfield）= 从零开始的新项目。本教程用一个"Todo App"贯穿全部流程。

总览 ​

init → brainstorm → propose → plan → execute → verify → archive

每个阶段生成明确文档，AI 的输出自动成为下一阶段的输入。

第 1 步：init — 项目初始化 ​

命令：

/sillyspec:init

AI 做什么：

  • 向你提出 5-10 个深度问题（目标用户、核心功能、技术偏好、非功能需求等）
  • 根据你的回答，生成三份核心文档

你做什么：

  • 回答 AI 的问题，尽量具体
  • 可以随时补充约束条件（"不用数据库"、"必须支持 PWA"等）

生成文件：

docs/specs/
├── REQUIREMENTS.md   # 需求文档：用户故事、功能清单、非功能需求
├── ROADMAP.md        # 路线图：Wave 划分、里程碑、时间预估
└── PROJECT.md        # 项目概览：技术栈、架构决策、约束条件

示例对话：

AI： 你想做一个什么样的 Todo App？目标用户是谁？
你： 个人用的极简 Todo，要快、要离线可用、要有分类。
AI： （生成 REQUIREMENTS.md、ROADMAP.md、PROJECT.md）

第 2 步：brainstorm — 需求探索 ​

命令：

/sillyspec:brainstorm

AI 做什么：

  • 基于 REQUIREMENTS.md 展开探索
  • 提出设计选项和取舍建议
  • 对比不同技术方案的优劣

你做什么：

  • 选择或否决方案
  • 补充 AI 没考虑到的边界情况

生成文件：

docs/specs/
└── BRAINSTORM.md     # 头脑风暴记录：方案对比、决策理由、待确认项

示例：

AI： 数据存储有三个方案：localStorage / IndexedDB / SQLite（via WASM）。各有取舍……
你： 用 IndexedDB，支持离线且容量够。

第 3 步：propose — 生成提案 ​

命令：

/sillyspec:propose

AI 做什么：

  • 综合前面所有文档，生成正式提案
  • 拆分成可执行的任务列表
  • 按依赖关系排序

你做什么：

  • 审阅提案，确认或调整
  • 可以要求拆分/合并任务

生成文件：

docs/specs/
├── PROPOSAL.md       # 正式提案：目标、范围、风险、假设
├── DESIGN.md         # 技术设计：架构图、API 设计、数据模型
└── TASKS.md          # 任务清单：每条任务的描述、验收标准、预估

第 4 步：plan — 制定计划 ​

命令：

/sillyspec:plan

AI 做什么：

  • 将 TASKS.md 中的任务按 Wave 组织
  • 每个 Wave 独立可交付
  • 生成执行计划

你做什么：

  • 确认 Wave 划分
  • 调整优先级

生成文件：

docs/specs/
├── PLAN.md           # 执行计划：Wave 划分、依赖图、执行顺序
└── waves/
    └── wave-1/
        └── tasks.json  # 当前 Wave 的任务详情

第 5 步：execute — TDD 执行 ​

命令：

/sillyspec:execute

AI 做什么：

  • 按 TDD 红-绿-重构流程执行任务
  • 自动派发 Subagent 并行开发
  • 实时汇报进度

你做什么：

  • 监控进度
  • 在关键节点做决策（如架构调整）

TDD 流程：

对于每个任务：
  1. 🔴 RED    → 写失败测试
  2. 🟢 GREEN  → 写最简实现让测试通过
  3. 🔵 REFACTOR → 优化代码结构

生成文件：

src/                    # 源代码
tests/                  # 测试代码

第 6 步：verify — 验证 ​

命令：

/sillyspec:verify

AI 做什么：

  • 运行全部测试
  • 对照 REQUIREMENTS.md 检查功能覆盖
  • 检查代码质量（复杂度、命名、结构）

你做什么：

  • 审阅报告
  • 决定是否需要修复或补充

💡 可运行校验脚本进行自动化验证：bash .claude/sillyspec/scripts/validate-all.sh

生成文件：

docs/specs/
└── VERIFY.md          # 验证报告：测试结果、覆盖率、问题清单

第 7 步：archive — 归档 ​

命令：

/sillyspec:archive

AI 做什么：

  • 归档当前 Wave 的文档和代码
  • 更新 ROADMAP.md 标记完成项
  • 准备下一 Wave 的任务

你做什么：

  • 确认归档
  • 可以启动回顾 /sillyspec:retro

生成文件：

docs/specs/archive/
└── wave-1/
    ├── snapshot.md    # 本 Wave 完成快照
    └── changes.md     # 变更记录

多 Wave 迭代 ​

完成 Wave 1 后，重复 plan → execute → verify → archive 进入下一波。每个 Wave 都独立可交付，你的 Todo App 会逐步完善：

Wave内容交付物
Wave 1基础 CRUD能增删改查 Todo
Wave 2分类与筛选按类别查看
Wave 3离线与 PWA脱离网络可用
Wave 4打磨上线UI 优化、性能调优