第 09 课 | GSD 问答 20 题（下）：实战技巧与排错
💡 进群学习加 wx: agentupdate
(申请发送: agentupdate)
(申请发送: agentupdate)
第三章：实战技巧与排错
出了问题怎么办、已有项目怎么接入、日常使用技巧。
Q15：执行出错怎么回滚？GSD 能撤销吗？
GSD 没有专门的"撤销"命令。但原子提交让 git 回滚很方便：
# 查看最近的提交
git log --oneline -10
# 回退到某个 commit（保留工作区修改）
git reset --soft <commit-hash>
# 回退到某个 commit（丢弃所有修改）
git reset --hard <commit-hash>
# 只回退一个 commit
git revert <commit-hash>
每个 Task 是独立 commit，所以可以精确回退到出错的那个 Task 之前。
建议：重大 Phase 开始前手动 git tag，比如 git tag before-phase-3。回退时直接 git reset --hard before-phase-3。
Q16：AI 写的代码质量不好怎么办？能要求重写吗？
能。三种方式：
/gsd-code-review+/gsd-code-review-fix：自动审查 + 自动修复。审查报告按严重性分级，修复 agent 只改有问题的部分。- 直接改：用
/gsd-quick告诉 AI 哪里不好、怎么改。或者手动改。 - 重新执行：
git revert回退有问题的 commit，重新/gsd-execute-phase --wave N重跑那一波。
实用建议：不要等到整个 Phase 完成才看代码。用 --interactive 模式，每个 Task 完成后检查一次。
Q17：研究 agent 失败了怎么办？能手动补吗？
研究 agent 可能因网络问题、API 限制失败（本教程项目就遇到过）。
应对方式：
- 重试：直接重新
/gsd-new-project，研究阶段会重新跑 - 手动补：自己查资料，把结果写到
.planning/research/目录下。格式不限，AI 能读懂 Markdown。 - 跳过：
--skip-research跳过研究，直接进需求阶段。你自己的领域知识够用就行。
研究失败不阻塞后续流程。需求文档可以手动编写或补充。
Q18：已有项目怎么开始用 GSD？要重构吗？
不需要重构。两步接入：
- 在项目根目录创建
CLAUDE.md，写明项目约束 - 运行
/gsd-new-project，GSD 会读取现有代码生成规划
GSD 不会修改已有代码。它只生成 .planning/ 目录下的规划文件。后续 Phase 可以增量添加功能。
注意：已有项目可能需要补充需求文档。GSD 会根据代码分析推断需求，但推断可能不完全准确。建议手动检查 REQUIREMENTS.md。
Q19：GSD 生成的文件太多，.planning/ 能精简吗？
能。.planning/ 里的文件分两类：
核心文件（不要删）：
STATE.md— 项目状态，新会话恢复进度必需ROADMAP.md— 路线图，执行 Phase 必需REQUIREMENTS.md— 需求，验证 Phase 必需phases/*/CONTEXT.md— 冻结决策，下游 Phase 依赖
可删文件（删了不影响功能）：
research/— 研究产出，决策做完后可删phases/*/DISCUSSION-LOG.md— 讨论记录，仅供参考phases/*/VERIFICATION.md— 验证报告，已通过的 Phase 可删phases/*/REVIEW.md— 审查报告，修复完可删
实用技巧：Phase 验证通过后，只保留 PLAN.md 和 CONTEXT.md，删掉研究、讨论、验证文件。STATE.md 永远保留。
Q20：一个人用 GSD 和团队协作有什么不同？
一个人用（本教程场景）：
- GSD 替代的是"计划 → 执行 → 检查"的自律
- 所有角色（产品/设计/开发/QA）由 AI 扮演
.planning/是给自己看的备忘录
团队协作：
.planning/目录可以提交到 git，团队成员共享上下文CONTEXT.md相当于设计文档，团队可审阅PLAN.md相当于任务分配，可多人并行执行不同 PhaseVERIFICATION.md相当于验收标准REVIEW.md相当于 Code Review 记录
核心差异：一个人用时 GSD 是"AI 帮你管项目"。团队用时 GSD 是"AI 帮团队对齐上下文"。
教程完结！全系列 14 集 + 4 附录，6 幕，20个 Q&A 问答结束。