How to play with AI vibe coding？

我们要和 AI 沟通，要总结几个经验,供大家参考（血泪教学，迭代无数次）：

三个重点

重设计、三层文档体系、渐进式开发。

第一点

最重要就是设计一定要占据你开发时间的一半以上，包括研究，包括和 AI 的交互讨论，包括提取一些专题，然后跟其他的 AI 交流生成深度的报告，包括自己阅读相关的报告和分析，以及一些范例的 repository。

第二点

要完整的文档体系，不管哪一种，都要跟随文档体系来去不断地迭代你的和 AI 交互的过程；我现在使用的是，嗯，三层的文档管理体系。第一层呢是backlog，管理整体的大目标，每一个目标就是项目为单位的。第二个级别呢，是这个 Task Master，Task Master 呢是把你每一个项目啊通过 PRD 拆分成一系列的这种task。 task 基本上遵循软件工程的这个过程，比如说嗯文档呀，测试用例啊，嗯包括很多的这种架构的 review 啊，这task master。然后呢，实际上是要及时地总结和输出，这就是下面我们提到的渐进式开发的配套文档，例如从一个solution转成PRD，然后再转换成很多的task，每个task开发过程中实际上就更细粒度的文档。比如说我们要有change，就是每一次小版本的迭代都要记录，我们要有test，要记录测试的过程，但是首先要设计测试的case和测试的步骤，并且要review去改进它，然后测试report。同时还有deployment，还有一些user story很多的文档，这个需要你不断地自己迭代。

第三点

一定一定要有完整的这个，这个叫什么测试流程，而且是渐进式的测试，就是从一个纸的汽车啊，变化成硬纸板，变成铁皮，变成钢铁，大概是这个逻辑，而不是一上来就建一个真的汽车。 现在进行式迭代的好处就是你可以回退，因为之前验证了你最核心的东西，你可以回退到上一步。嗯，包括对应的commit机制一定要建立起来，即时地让它commit，记下这个milestone 总结一下就是三层文档体系，项目级或者产品级，然后就是工程级，然后就是执行级。项目或者产品级用backlog，然后工程级别用taskmaster，然后执行级别是要你自己建立对应的文档体系。

如何建立

如何建立这个文档体系并落地到自己开发过程中呢？

第一步

就是要建立一个独立的 report，这个 repository 呢，嗯，完成两个动作。第一个呢就是建立 backlog，第二个呢，就是根据你的项目建立不同的 topic 的 research 和这个 exploration 的目录。然后就是根据这个，因为刚才建立的是二级 backlog 和 task ma-master，task master 会在每一个这个 research topic 目录下建立对应的啊文档体系，把这个文档生成出来。

第二步

建立独立的 report，repository，为每一个 research topic 建立独立的 repository，每一个 repository 一样复制。目前先用复制的方法复制从 solution，从 research 到 solution，到 PRD 到 detail task，最终生成这个 detail task。复制过来之后，然后呢，再去进行执行。啊每一个这个独立的 repository 是一个 research topic 的一个 implementation，然后呢，同时它有反向链接，就是它要向上追溯地建立一个简单的追溯文档，告诉这个 AI，呃我这个项目归属于哪个 research topic，它有哪些背景，呃它的整体目标是什么。

第三步

自动化，建立一个系列的动作，不过这个是不断迭代的过程 我提供一个范例文档

## 🚀 Quick Start Guide / 快速开始指南

### Setup Workflow / 设置工作流程

```bash
# 1. 进入项目根目录
cd /path/to/my-exploration

# 2. 加载研究工作流别名（适用于任何terminal）
source scripts/aliases.sh

# 3. 配置Taskmaster + Claude Code集成
setup-tm all                    # 为所有研究主题配置Claude Code

# 4. 检查环境设置
env-check

# 5. 查看可用研究主题
topic-list
```

### Daily Research Workflow / 日常研究工作流程

```bash
# === 每日开始 ===
morning                          # 显示当前任务和状态

# === 研究主题切换 ===
rcd SuperPaymaster              # 切换到指定研究主题
rws                             # 查看当前研究状态

# === jFlow阶段工作 ===
ji                              # 编辑 idea-*.md
jt                              # 编辑 thinking-*.md
jc                              # 编辑 craft-*.md（学术论文）
js                              # 编辑 Solution.md（产品定义）

# === Taskmaster任务管理 ===
tm parse-prd --input=.taskmaster/design/prd.txt  # 生成开发任务
tml                             # 列出所有任务
tmn                             # 显示下一个任务
tms <id>                        # 查看任务详情
tmst --id=<id> --status=done    # 标记任务完成

# === 桥接到开发阶段 ===
rwb                             # 复制Solution.md到design/项目/PRD.md

# === 每日结束 ===
evening                         # 显示今日完成情况
```

### Create New Research Topic / 创建新研究主题

```bash
# 初始化新研究主题（自动创建完整jFlow结构）
rw init MyNewBlockchainIdea

# 进入新主题目录
rcd MyNewBlockchainIdea

# 查看创建的文件结构
rws
```

### Integration with External Development / 外部开发集成

```bash
# 链接外部开发项目
link ProjectName https://github.com/YourOrg/ProjectRepo

# 查看所有项目链接
cat design/projects.md

# 跨电脑协作工作流程：
# 1. 本电脑：完成research → solution → PRD
# 2. git push同步研究成果
# 3. 开发电脑：git pull + 复制PRD到独立开发repo
# 4. 开发电脑：在独立repo中使用taskmaster管理开发任务
```

### Essential Aliases Reference / 核心别名参考

| 别名 | 完整命令 | 说明 |
|------|----------|------|
| `tm` | `task-master` | Taskmaster主命令 |
| `tml` | `task-master list` | 列出任务 |
| `tmn` | `task-master next` | 下一个任务 |
| `rw` | `scripts/research-workflow.sh` | 研究工作流脚本 |
| `rws` | `rw status` | 研究状态 |
| `rcd` | `research_cd` | 切换研究主题 |
| `ji/jt/jc/js` | `vim idea/thinking/craft/solution` | 编辑jFlow文件 |
| `morning/evening` | `rwd start/end` | 日常工作流程 |

### Help and Troubleshooting / 帮助和故障排除

```bash
rh                              # 显示完整帮助信息
env-check                       # 检查环境配置
status-all                      # 总体状态概览

# 查看详细使用指南
cat design/taskmaster-usage.md

# 运行工作流程演示
scripts/workflow-demo.sh
```