第7章 AI驱动的全栈项目实战-代码和提示词-林子雨编著《AI编程》
内容提要
本文介绍使用TRAE与Superpowers七步法开发微服务活动平台，涵盖环境初始化、规则配置、需求对齐、任务拆解、TDD开发、代码评审与合并。通过Docker Compose启动服务，利用curl和Playwright测试API及前端，人工审查修复架构问题，最终实现活动发布、报名、海报上传等功能。
延伸解读
规则文件与插件复用
项目初始化时，代码规范文件（js-code-style.md和python-code-style.md）可直接从教材官网下载，无需手动编写。Superpowers插件需为每个项目单独安装，即使之前已安装过也要重新执行安装命令。pre-commit钩子配置也可复用6.3节的文件，体现了项目间配置的复用性。
提示词约束AI行为
由于AI倾向于自动推进，提示词中明确要求严格遵循Superpowers七步法，每一步需用户确认后才进入下一步，禁止超前写代码或合并步骤。这种约束有助于控制开发流程，确保需求对齐、任务拆解、TDD开发等环节按序进行，减少意外偏差。
人工审查与架构修正
AI生成代码后，人工审查发现架构不一致（如未启用Consul服务发现），通过向AI提问确认问题，并选择方案一进行修改。这体现了AI辅助开发中人工监督的重要性，AI可提供分析及解决方案，但最终决策和验证仍需人工参与。
容器运行环境与镜像源选择
启动服务时，AI会根据操作系统选择容器环境（如Windows用Rancher Desktop，mac用Colima，Linux用Podman），并优先使用国内镜像源（如阿里云、DaoCloud）下载工具和镜像，必要时修改Dockerfile和docker-compose.yml中的镜像地址，以应对网络问题。
Q&A
如何使用Docker Compose启动和停止微服务项目？
在项目根目录执行 `docker compose up -d` 启动所有服务（后台运行），执行 `docker compose down` 停止并删除所有容器。
在TRAE中如何初始化项目环境并配置代码规范？
在项目根目录创建 `.TRAE/rules` 目录，放入 `js-code-style.md` 和 `python-code-style.md` 规则文件（可从教材官网下载）。然后执行 `npx superpowers-zh --tool TRAE` 安装Superpowers插件，执行 `git init` 初始化仓库，并配置pre-commit钩子。
Superpowers七步法开发流程的具体步骤是什么？
七步法包括：1. 需求对齐（brainstorming）；2. 环境隔离（using-git-worktrees）；3. 任务拆解（writing-plans）；4. 逐任务开发（subagent-driven-development，配合TDD）；5. TDD测试（test-driven-development）；6. 代码评审（requesting-code-review）；7. 项目收尾（finishing-a-development-branch）。每一步都需要用户确认后才能进入下一步。
如何验证微服务API和前端页面是否正常？
使用docker compose启动服务后，用curl测试所有API；前端页面使用Playwright Test进行端到端测试，可让AI根据FastAPI源码生成测试代码并执行。
在人工审查中发现架构不一致（如未启用Consul）时如何处理？
在TRAE对话框中描述问题，AI会分析并给出解决方案。用户选择方案后，指示AI修改代码，并确保所有测试通过。
如何一键启动开发完成后的项目？
在TRAE对话框中输入提示词，要求AI作为SRE根据操作系统选择容器环境（如Windows用Rancher Desktop，mac用Colima，Linux用Podman），初始化测试数据，使用docker compose启动服务，并检查服务可用。
