首先需要说明一个关键区别：你之前问的 gstack 和现在问的 gsd 是两个不同的工具。
| 工具 | 定位 | 运行环境 |
|---|---|---|
| gstack | 角色化团队工作流（CEO、工程师、QA等6个角色） | Claude Code 专属 |
| GSD | 原子化任务管理 + 上下文工程系统 | iFlow / Claude Code / Codex / Gemini CLI |
简单来说：gstack 是"角色扮演团队"，GSD 是"任务原子化执行系统"。两者可以配合使用，但不是同一个东西。
1、GSD 的核心概念
GSD 解决的核心问题是 上下文衰减 ------即 AI 上下文窗口被填满后质量下降的问题-1。
核心机制：
-
✅ 原子化任务：每个功能拆成独立小任务，全新上下文执行
-
✅ 自动验证：每步生成可测试交付物，失败自动诊断修复
-
✅ 状态记忆 ：通过
PROJECT.md、STATE.md持久化项目上下文
2、安装步骤
1. 安装 iFlow CLI（推荐）
一键安装
bash -c "$(curl -fsSL https://gitee.com/iflow-ai/iflow-cli/raw/main/install.sh)"
或使用 npm（需要 Node.js 22+）
npm i -g @iflow-ai/iflow-cli@latest
2. 安装 GSD
npx get-shit-done-cc@latest
安装过程中会提示选择运行环境（Claude Code / Codex / Gemini CLI 等）-1。
3. 验证安装
在项目目录启动 iFlow：
iflow
然后运行：
/skills list
如果看到 GSD 相关命令，说明安装成功-1。
3、GSD 核心命令及使用场景
📁 项目管理类
| 命令 | 功能 | 何时使用 |
|---|---|---|
gsd-new-project |
初始化新项目，创建 PROJECT.md | 开始全新项目 |
gsd-new-milestone |
开始新的里程碑周期 | 启动一个功能版本 |
gsd-complete-milestone |
归档已完成里程碑 | 完成一个版本后 |
gsd-audit-milestone |
审计里程碑完成情况 | 归档前质量检查 |
🔧 阶段执行类
| 命令 | 功能 | 何时使用 |
|---|---|---|
gsd-plan-phase |
创建详细阶段计划（PLAN.md） | 规划具体任务 |
gsd-execute-phase |
执行阶段中的所有计划 | 开始写代码 |
gsd-validate-phase |
回溯审计已完成阶段 | 代码完成后验证 |
gsd-add-tests |
为已完成阶段生成测试 | 补充测试覆盖 |
🔄 工作流类
| 命令 | 功能 | 何时使用 |
|---|---|---|
gsd-progress |
检查项目进度，路由到下一步 | 不确定下一步做什么时 |
gsd-quick |
执行快速任务（带原子提交保证） | 小改动、bug修复 |
gsd-verify-work |
通过 UAT 验证构建的功能 | 功能完成后验收 |
gsd-debug |
系统性调试（跨上下文重置） | 遇到复杂 bug |
📝 待办事项类
| 命令 | 功能 |
|---|---|
gsd-check-todos |
列出待办事项 |
gsd-add-todo |
从当前对话捕获任务作为待办 |
⚙️ 配置类
| 命令 | 功能 |
|---|---|
gsd-settings |
配置工作流开关和模型 |
gsd-set-profile |
切换模型配置（quality / balanced / budget） |
gsd-health |
诊断规划目录健康状况 |
gsd-update |
更新到最新版本 |
4、典型使用流程
以开发一个新功能为例：
1. 初始化项目（如果是新项目）
gsd-new-project
2. 开始里程碑
gsd-new-milestone
3. 规划阶段
gsd-plan-phase
4. 执行开发
gsd-execute-phase
5. 验证工作
gsd-verify-work
6. 完成里程碑
gsd-complete-milestone
遇到问题时：
检查当前进度，获取下一步建议
gsd-progress
系统性调试
gsd-debug
5、与 GStack 的关系
这两个工具不是互斥的，可以配合使用：
-
GSD 负责：任务拆分、状态持久化、原子化执行
-
gstack 负责：角色分工（CEO、QA、工程师等）
你可以在 GSD 的每个阶段中，调用 gstack 的不同角色命令来完成具体工作。
6、快速上手建议
-
先跑通一个完整流程 ：用
gsd-new-project→gsd-new-milestone→gsd-plan-phase→gsd-execute-phase走一遍 -
善用
gsd-progress：这个命令会告诉你下一步该做什么，对新手最友好 -
遇到问题用
gsd-health：检查项目目录是否完整，自动修复常见问题
需要帮助时运行：
gsd-help
总结：GSD 是一套帮你"把大任务拆成小任务、每步验证、永不丢失上下文"的工程化系统。它与 gstack 是互补关系，可以一起使用构建完整的 AI 驱动开发工作流。
7、GStack + GSD 配合使用指南
核心思想 ：用 GSD 作为项目的"流程骨架"和"状态存储器"，管理里程碑、阶段、任务和验证；用 gstack 作为每个阶段内部的"执行团队"，调用不同角色完成具体工作。
前提条件
-
已安装 iFlow 和 GSD（在 Claude Code 环境中）
-
已安装 gstack（在 Claude Code 中）
验证方式：
在 Claude Code 中运行
/skills list
应看到 gstack 相关命令（/office-hours, /plan-ceo-review, /review, /qa 等）
以及 GSD 相关命令（gsd-*）
配合流程示例：开发一个"用户登录"功能
假设你要为一个 Web 应用添加"用户登录"功能。我们将用 GSD 管理整个开发周期，在每个阶段内使用 gstack 的角色命令。
步骤 1：初始化项目（GSD）
在项目根目录启动 iFlow 或直接进入 Claude Code，运行：
创建新项目（如果项目目录不存在）
gsd-new-project 或
开始一个新的里程碑（例如"添加用户登录"）
gsd-new-milestone
GSD 会生成 PROJECT.md、STATE.md 和规划目录结构。此时你可以查看当前进度：
gsd-progress
输出：当前里程碑未规划阶段，建议运行 gsd-plan-phase
步骤 2：规划阶段（GSD + gstack）
运行 gsd-plan-phase 创建阶段计划。在规划过程中，你可以将 gstack 的角色任务嵌入到阶段描述中。
gsd-plan-phase
系统会提示你输入阶段名称和任务。建议按以下顺序规划：
| 阶段名称 | 阶段任务（包含 gstack 命令） | 产出 |
|---|---|---|
| 1. 设计 | 运行 /plan-ceo-review 对登录功能进行产品和技术评审 |
PLAN.md 中的架构决策 |
| 2. 实现 | 使用 /office-hours 描述实现细节，编写代码 |
代码变更 |
| 3. 审查 | 在代码分支上运行 /review |
审查报告，修复意见 |
| 4. QA | 在 staging URL 上运行 /qa |
测试报告，Bug 清单 |
| 5. 发布 | 手动或使用 GSD 完成里程碑 | PR 合并，里程碑归档 |
在 GSD 的 PLAN.md 中，你可以用 Markdown 记录每个阶段要执行的 gstack 命令及其预期输出。
步骤 3：执行每个阶段（gstack 嵌套在 GSD 流程中）
阶段 1：设计
使用 GSD 标记阶段开始（自动记录时间戳）
gsd-execute-phase
系统会提示你正在执行哪个阶段，选择"设计"
现在调用 gstack 的角色命令
/plan-ceo-review
按提示描述登录功能：例如"我要为现有的 Express 应用添加邮箱+密码登录，使用 JWT，需要支持记住我"
/plan-ceo-review 会输出一份详细的架构评审，包括技术选型、安全考虑、潜在风险等。将这份输出保存到 GSD 的规划目录中（例如作为阶段产出）。
完成后，在 GSD 中标记阶段完成（可选）：
gsd-validate-phase
系统会要求确认阶段产出，确认后标记完成
阶段 2：实现
gsd-execute-phase # 选择"实现"
使用 gstack 的 office-hours 进行实现
/office-hours
描述：我要实现 /plan-ceo-review 中确定的登录 API，包括路由、控制器、JWT 签发、密码哈希等
/office-hours 会启动一个虚拟工程师对话，你可以逐步指导它编写代码。所有代码变更会被记录。
实现完成后，手动运行测试确保代码工作正常。然后回到 GSD：
gsd-validate-phase
确认代码已提交，阶段完成
阶段 3：审查
gsd-execute-phase # 选择"审查"
切换到包含变更的分支（如果有 PR 分支）
运行 gstack 的 review
/review
/review 会分析当前分支的代码变更，发现潜在 bug、样式问题、安全漏洞等。它会输出一份审查报告。根据报告进行修复（可以再次进入 /office-hours 修复）。
修复后，再次运行 /review 直到满意。然后：
gsd-validate-phase
阶段 4：QA
gsd-execute-phase # 选择"QA"
假设功能已部署到 staging 环境（例如 https://staging.example.com）
运行 gstack 的 qa
/qa
输入 staging URL
/qa 会打开真实浏览器进行端到端测试（如果配置了 Playwright 等），生成测试报告和截图。根据报告修复问题，直到 QA 通过。
然后：
gsd-validate-phase
阶段 5：发布
如果使用 GSD 管理发布，可以手动完成里程碑
gsd-complete-milestone
系统会归档当前里程碑，更新 PROJECT.md 中的历史记录。你还可以使用 gstack 的 release engineer 角色（如果有相应命令）来提交 PR 并合并。
步骤 4：状态同步与记录
GSD 的 STATE.md 和 PROJECT.md 会自动记录每个阶段的开始/结束时间、产出摘要。你可以在这些文件中附加 gstack 命令的输出（例如 /plan-ceo-review 的完整结果），这样即使上下文重置，也能追溯决策。
建议在每个阶段完成后，手动将 gstack 的输出复制到 GSD 的规划目录中（如 planning/phase_1_design/artifacts.md）。GSD 的验证命令也会提示你记录产出。
步骤 5：遇到问题时使用 GSD 的调试能力
如果在某个阶段卡住（例如 QA 发现复杂 bug），可以使用 GSD 的调试命令，它会跨上下文重置分析问题：
gsd-debug
描述问题，GSD 会基于历史状态和当前阶段产出给出诊断建议
然后你可以继续用 gstack 的角色来解决具体问题。
总结：两者分工
| 工具 | 职责 | 典型命令 |
|---|---|---|
| GSD | 流程管理、状态持久化、任务原子化、进度跟踪 | gsd-new-project, gsd-plan-phase, gsd-execute-phase, gsd-progress |
| gstack | 角色化执行、专项审查、测试、架构评审 | /plan-ceo-review, /review, /qa, /office-hours |
配合效果：
-
GSD 保证你不会在上下文混乱中迷失方向，每个阶段都有明确的输入、输出和验证。
-
gstack 保证每个阶段都有专业角色（CEO、工程师、QA）介入，提升产出质量。
这种组合特别适合：
-
个人开发者需要系统性管理复杂项目
-
团队想统一开发流程，但不想引入复杂的外部工具
-
希望最大化利用 Claude Code 的能力，同时避免上下文窗口爆炸
快速命令备忘
开始项目
gsd-new-project && gsd-new-milestone
规划阶段（手动创建阶段，或在提示中说明）
gsd-plan-phase
执行某个阶段
gsd-execute-phase # 然后选择阶段，并在内部使用 gstack 命令
例如：
/plan-ceo-review
/office-hours
/review
/qa
验证阶段完成
gsd-validate-phase
完成里程碑
gsd-complete-milestone
任何时候查看进度
gsd-progress
遇到复杂问题
gsd-debug