林子雨编著《AI编程与智能体开发》（访问教材官网）
6.4 Superpowers的安装与配置
6.4.1 环境要求与安装
npx superpowers-zh --tool trae6.4.2 工作流配置
## User
本对话中，你必须使用 Superpowers。Superpowers 是一套专门用于结构化软件开发的工具，由一系列的 skills 构成。
它们是你工作流程的一部分，你必须在每个阶段激活和使用它们。
使用以下流程：
1. 使用 brainstorming skill，采用苏格拉底式的提问方法，通过反复提问帮我理清缓存数据库的具体需求、数据结构和API设计。直到需求完全明确后才进入步骤2
2. 使用 using-git-worktrees skill，创建隔离的Git工作树环境，确保开发工作不污染主干。然后使用 writing-plans skill，根据 brainstorming 的结果，创建详细的实现计划，将整个开发过程分解为可以2-5分钟完成的小任务。在开发期间，必须使用 test-driven-development skill，采用其 RED-GREEN-REFACTOR 循环开发，不得跳过测试步骤
3. 使用 subagent-driven-development 或 dispatching-parallel-agents skill，对步骤3中的每个小任务，自动创建独立的实施任务，逐任务执行。只有当前任务完成后才进行下一个
4. 使用 requesting-code-review skill，对开发过程中完成的每个子任务，在合并前进行代码审查，确保代码质量
5. 使用 finishing-a-development-branch skill，合并到master分支，清理工作树
**重要规则**：
- 当我提出查询时，你必须使用 brainstorming skill 首先探索问题空间，不要急于生成代码
- 开始任何开发工作前，确保已设置正确的Node.js环境（`nvm use 20`）
- 所有开发工作都必须在对应的子目录中完成
- 绝对不要主动发起git提交、推送等改变仓库状态的操作6.5 缓存数据库开发实践
以下是缓存数据库项目的项目说明书（AGENTS.md）完整内容（请把AGENTS.md放置到CacheDB项目的根目录下）：
# AGENTS.md
## 项目简介
这是一个Python缓存数据库（CacheDB），提供简单易用的键值对缓存服务。
## 技术栈
- Python 3
- pytest（测试框架）
## 目录结构
cachedb/
├── src/cachedb/
│ ├── __init__.py # 包初始化文件
│ ├── database.py # CacheDB 核心实现
│ └── exceptions.py # 自定义异常类
├── tests/
│ └── test_cachedb.py # 测试文件
├── example/
│ └── demo.py # 使用示例
├── docs/
│ └── superpowers/ # Superpowers生成的文档
│ ├── specs/ # 设计规格文件
│ └── plans/ # 实现计划文件
├── AGENTS.md # 项目说明书
└── README.md # 项目自述文件
## 开发约定
- 遵循Python社区编码规范
- 所有代码修改前必须先编写测试
- 不得直接修改master分支
## AI编程行为规范
- 每次AI交互都必须按照Superpowers工作流规则处理
- 开始任何开发工作前，确保已设置正确的Node.js环境（`nvm use 20`）
- 所有开发工作都必须在对应的子目录中完成
- 绝对不要主动发起git提交、推送等改变仓库状态的操作6.5.1 需求澄清与设计
为了避免TRAE迭代以后过于聪明抢活干，建议在提示词里面再强调一下，严格按照Superpowers的七个步骤去执行接下来的开发任务。因此，可以在TRAE的智能体交互界面的对话框中输入如下提示词并提交：
严格遵循Superpowers七步法串行开发Python缓存数据库，无确认绝不主动推进、不超前写代码、不跳过任何一个步骤。
固定流程顺序，缺一不可，仅完成当前步骤，等待我确认后再进入下一环。
1. 需求对齐时调用 /skill:brainstorming 苏格拉底追问敲定全部开发需求，输出需求文档，待确认
2. 环境隔离 /skill:using-git-worktrees 建立Git工作树/独立开发分支，确定项目目录，待确认
3. 任务拆解 /skill:writing-plans 拆分细粒度开发任务，明确文件、逻辑、校验方式，待确认
4. 逐任务开发 /skill:subagent-driven-development 单任务完成后自检复盘，不批量编写，待确认
5. TDD测试 /skill:test-driven-development 先写测试用例再实现代码，完成功能校验，待确认
6. 代码评审 /skill:requesting-code-review 排查漏洞、规范、性能问题并优化，待确认
7. 项目收尾 /skill:finishing-a-development-branch 完成整合、持久化、整理交付，流程结束
1.输出首行标注当前所处步骤
2.每步结束统一话术：本步骤完成，请确认进入下一步
3.未收到确认指令，仅限完善当前内容，禁止输出后续内容与代码
4.严禁自主提速、合并步骤、提前完成开发
现在开始第1步，逐条澄清本缓存数据库的需求。6.5.2 分支隔离
cd /path/to/cachedb
git init
git add .
git commit -m "Initial commit: empty project structure"