第一步：规划阶段（15-30 分钟）
🌟现在安装了/superpowers:brainstorm 插件，可以直接在 Claude Code 里规划
1.1 打开任意笔记工具，回答这两个问题
1
2
3
4
5
6
7
| 问题 1：我到底想做什么？
- 这是原型验证还是要上线？
- 写一句话描述项目核心价值
问题 2：MVP 包含哪些功能？
- 列出 3-5 个核心功能
- 其他功能放到 v1.1、v1.2
|
1.2 让 AI 帮你理清思路
打开 Claude，输入：
1
2
3
| 我想做一个 [你的项目描述]。
请问我 3 个最重要的问题，帮我理清没想明白的地方。
|
认真回答这些问题，把答案记下来。
1.3 生成项目规格文档
继续让 Claude 帮你整理：
1
2
3
4
5
6
7
8
9
10
11
12
| 基于我们的讨论，帮我生成一份项目规格文档，包含：
1. 产品需求
- 解决什么问题
- 目标用户
- 核心功能列表（MVP）
- 用户交互流程
2. 技术需求
- 技术栈选择（请用：[你偏好的技术栈，比如 Python + FastAPI + SQLite]）
- 项目结构建议
- 第三方服务/API
|
把输出保存为 docs/spec.md。
第二步：配置阶段（10-15 分钟）
2.1 创建 GitHub 仓库
1
2
3
4
5
6
7
|
gh repo create my-project --private --clone
cd my-project
mkdir my-project && cd my-project
git init
|
2.2 创建目录结构
1
2
3
| mkdir docs
mkdir .claude
mkdir .claude/commands
|
2.3 创建环境变量文件
1
2
3
| touch .env
touch .env.example
echo ".env" >> .gitignore
|
在 .env 中提前填好所有 API key：
1
2
3
| OPENAI_API_KEY=xxx
DATABASE_URL=xxx
# 其他需要的 key...
|
填入以下内容：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
| # 项目名称
一句话描述：[从 spec.md 复制]
## 项目目标
[MVP 要实现的 3-5 个核心功能]
## 技术栈
- 语言：Python 3.11
- 框架：FastAPI
- 数据库：SQLite
- [其他...]
## 项目结构
src/
main.py
models/
routes/
docs/
tests/
## 开发规范
- 代码风格：[你的偏好]
- 提交规范：feat/fix/docs 前缀
- 测试要求：[有/无]
## 约束条件
- 不要使用 [某个你不想用的库]
- 不要 [其他限制]
## 当前状态
见 [project-status.md](./docs/project-status.md)
## 相关文档
- [项目规格](./docs/spec.md)
- [架构设计](./docs/architecture.md)
- [变更日志](./docs/changelog.md)
|
2.5 创建自动化文档
1
2
3
| touch docs/architecture.md
touch docs/changelog.md
touch docs/project-status.md
|
docs/project-status.md 模板：
1
2
3
4
5
6
7
8
9
10
11
12
13
| # 项目状态
## 已完成
- [ ] 项目初始化
## 进行中
- [ ] [当前任务]
## 待开始
- [ ] [下一个任务]
## 下次继续
从这里开始：[具体描述]
|
2.6 创建自定义命令（可选但推荐）
1
| touch .claude/commands/update-docs.md
|
内容：
1
2
3
4
5
| 请更新以下文档以反映最新的代码变更：
1. docs/architecture.md - 更新系统架构
2. docs/changelog.md - 添加本次变更记录
3. docs/project-status.md - 更新完成状态和下次继续点
|
2.7 首次提交
1
2
3
| git add .
git commit -m "init: 项目初始化"
git push -u origin main
|
第三步：构建阶段
3.1 启动 Claude Code
3.2 让 Claude 先熟悉项目
1
| 请阅读 CLAUDE.md 和 docs/spec.md，确认你理解了项目目标和技术栈。
|
3.3 进入计划模式（重要！）
1
2
3
| 我要开始实现 [第一个功能]。
请先进入 plan 模式，列出实现步骤，不要直接写代码。
|
等 Claude 列出计划后，确认没问题再说：
3.4 每完成一个功能后
或者手动说：
1
| 请更新 changelog.md 和 project-status.md，记录刚才的变更。
|
3.5 遇到 Claude 犯错时
立即在 CLAUDE.md 的约束条件里添加：
1
2
3
4
| ## 约束条件
- 不要使用 print 调试，用 logging
- 不要把密钥硬编码 # ← 新增的规则
|
完整流程图
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
| ┌─────────────────────────────────────────────────────────┐
│ 第一步：规划（15-30分钟） │
│ ├─ 回答两个核心问题 │
│ ├─ 让 AI 问你问题 │
│ └─ 输出 spec.md │
└─────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ 第二步：配置（10-15分钟） │
│ ├─ 创建 GitHub 仓库 │
│ ├─ 配置 .env │
│ ├─ 创建 CLAUDE.md │
│ ├─ 创建 docs/ 文档 │
│ └─ 首次提交 │
└─────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ 第三步：构建（循环） │
│ ├─ 让 Claude 熟悉项目 │
│ ├─ plan 模式列计划 │
│ ├─ 确认后实现 │
│ ├─ 更新文档 │
│ └─ 犯错时添加规则 │
└─────────────────────────────────────────────────────────┘
|