摸着羊的笔记

GSD 快速入门

三步启动你的下一个项目

/gsd-new-project /gsd-plan-phase 1 /gsd-execute-phase 1

核心工作流

/gsd-new-project /gsd-plan-phase /gsd-execute-phase repeat

最常用命令

📦 项目初始化

命令说明
/gsd-new-project 初始化新项目(深度提问 → 研究 → 需求 → 路线图) HOT
/gsd-map-codebase [--fast] 映射现有代码库(棕地项目)

📋 阶段规划

命令说明
/gsd-discuss-phase <N> 在规划前表达你对阶段的愿景
/gsd-mvp-phase <N> 将阶段规划为垂直 MVP 切片
/gsd-plan-phase <N> 创建阶段的详细执行计划 HOT

🚀 执行

命令说明
/gsd-execute-phase <N> 执行阶段的所有计划 HOT
/gsd-execute-phase <N> --wave N 仅执行指定波次

📊 进度追踪

命令说明
/gsd-progress 查看项目状态,智能路由到下一步 HOT
/gsd-progress --next 自动进入下一步
/gsd-resume-work 从上一会话恢复工作
/gsd-pause-work 创建上下文交接文档

🎯 快速模式

命令说明
/gsd-quick 执行小型临时任务(跳过可选代理)
/gsd-quick --full 完整质量管道
/gsd-fast "<描述>" 执行微小任务(无子代理,无开销)

🏁 里程碑管理

命令说明
/gsd-new-milestone "<名称>" 开始新里程碑
/gsd-complete-milestone <版本> 完成里程碑并归档

📝 阶段管理

命令说明
/gsd-phase "<描述>" 在里程碑末尾添加新阶段
/gsd-phase --insert <N> "<描述>" 在阶段 N 后插入紧急阶段
/gsd-phase --remove <N> 删除未来阶段并重新编号

💡 捕获想法/任务

命令说明
/gsd-capture 从对话捕获想法为结构化 todo
/gsd-capture --note <文本> 零摩擦笔记捕获
/gsd-capture --list [区域] 列出待处理 todo

🔍 调试

命令说明
/gsd-debug "<问题描述>" 系统化调试(持久状态)
/gsd-debug 恢复调试会话

🧪 探索/原型

命令说明
/gsd-spike "<想法>" 快速原型验证可行性
/gsd-sketch "<想法>" 快速 UI 设计草图
/gsd-explore 苏格拉底式构思和想法路由

🚢 发布

命令说明
/gsd-ship <阶段> 创建 PR(自动生成摘要)
/gsd-pr-branch 创建干净的 PR 分支
/gsd-review --phase N --all 跨 AI 代码审查

⚙️ 配置

命令说明
/gsd-settings 配置工作流开关和模型
/gsd-config --profile <profile> 快速切换模型(quality/balanced/budget)

🔧 维护

命令说明
/gsd-cleanup 归档已完成里程碑的阶段目录
/gsd-update 更新 GSD 到最新版本
/gsd-health [--repair] 诊断规划目录健康状态

🧠 智能路由

命令说明
/gsd-progress --do "<描述>" 自动路由到正确的 GSD 命令
📁

文件结构

.planning/ ├── PROJECT.md # 项目愿景 ├── ROADMAP.md # 当前阶段分解 ├── STATE.md # 项目记忆和上下文 ├── config.json # 工作流模式配置 ├── phases/ # 阶段目录 │ └── 01-foundation/ │ ├── 01-01-PLAN.md │ └── 01-01-SUMMARY.md ├── todos/ # 捕获的想法 ├── spikes/ # 原型实验 ├── debug/ # 调试会话 └── milestones/ # 归档的里程碑
🔄

常见工作流

开始新项目

/gsd-new-project /clear /gsd-plan-phase 1 /clear /gsd-execute-phase 1

恢复工作

/gsd-progress

插入紧急工作

/gsd-phase --insert 5 "Critical security fix" /gsd-plan-phase 5.1 /gsd-execute-phase 5.1

完成里程碑

/gsd-complete-milestone 1.0.0 /clear /gsd-new-milestone

调试问题

/gsd-debug "form submission fails" /clear /gsd-debug # 恢复
⬆️

更新 GSD

# 方法 1: NPM 更新 npx get-shit-done-cc@latest # 方法 2: 命令更新 /gsd-update