gstack AI 全流程工程使用教程
gstack AI 全流程工程使用教程
单人开发想实现团队级交付？不用再为流程混乱、效率低下、质量难控发愁！gstack——由 YC 总裁 Garry Tan 开源的AI 驱动软件工程流水线工具（官网地址：https://github.com/garrytan/gstack），正是为解决这一痛点而生。它能将 Claude Code 等 AI 编码助手转化为专属虚拟工程团队，覆盖从产品规划、架构设计、编码、评审、测试到发布的全研发流程，让单人开发者轻松实现传统20人团队的交付效率，更难得的是，它采用 MIT 开源协议，完全免费可用，收藏本文，手把手教你用 AI 解锁高效开发新姿势！
无论你是 solo 创业者、技术负责人，还是刚接触 AI 编码的新手，本文都能帮你快速上手 gstack——从环境准备、快速安装，到全流程实战、核心技能速查、高级功能解锁，再到常见问题排查，全程干货无冗余，读完就能直接落地使用。
一、前置环境要求
gstack 依赖基础工具，安装前请确保本地已配置：
Claude Code：核心 AI 编码环境
Git：代码版本管理
Bun v1.0+：运行时依赖
Windows 系统额外：需安装 Node.js（兼容 Playwright 传输）
二、30 秒快速安装
gstack 支持个人模式、团队模式、OpenClaw 集成三种安装方式，按需选择。
2.1 个人模式（单人开发）
打开 Claude Code，直接执行以下命令，自动完成克隆、配置：
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup安装后在CLAUDE.md添加 gstack 配置段，声明可用技能。
2.2 团队模式（协作开发）
进入项目仓库，执行命令开启团队自动更新，避免版本不一致：
(cd ~/.claude/skills/gstack && ./setup --team) && ~/.claude/skills/gstack/bin/gstack-team-init required && git add .claude/ CLAUDE.md && git commit -m "require gstack for AI-assisted work"required：强制团队成员使用；替换为optional为推荐使用无冗余文件、无版本漂移，会话自动静默检查更新
2.3 OpenClaw 集成
在 OpenClaw 代理中执行安装命令，即可直接调用 gstack 技能：
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup并在AGENTS.md配置编码任务默认调用 gstack 技能。
2.4 多 AI 代理适配
gstack 支持 Codex、Cursor、GBrain 等 10+AI 代理，指定代理安装：
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/gstack
cd ~/gstack && ./setup --host <代理名称>示例：./setup --host codex适配 OpenAI Codex CLI。
三、全流程开发实战（核心）
gstack 遵循Think→Plan→Build→Review→Test→Ship→Reflect标准研发流程，每个环节对应专属技能，前后技能自动衔接上下文。
3.1 思考阶段：产品需求梳理
命令：/office-hours
6 个引导性问题，重构产品需求，挑战不合理预设
自动生成设计文档，供下游技能直接读取
示例：输入 “开发日历每日简报应用”，AI 会提炼核心需求、给出 3 种实现方案
3.2 规划阶段：分层评审
CEO 视角评审：
/plan-ceo-review
聚焦产品战略，4 种模式（扩展 / 选择性扩展 / 控 scope / 缩减），挖掘核心价值工程架构评审：
/plan-eng-review
输出数据流图、状态机、异常处理、测试矩阵，明确技术方案设计体验评审：
/plan-design-review
维度打分、AI 低质内容检测，优化交互方案一键全流程规划：
/autoplan
自动执行 CEO→设计→工程→DX 评审，仅需确认审美决策
3.3 构建阶段：设计与编码
设计系统搭建：
/design-consultation
从零生成完整设计系统、产品原型视觉方案探索：
/design-shotgun
生成 4-6 种 AI 设计稿，浏览器对比，学习用户偏好生产级 HTML 输出：
/design-html
设计稿转无依赖、响应式 HTML，适配 React/Vue 等框架
3.4 评审阶段：代码质量把关
命令：/review
Staff 工程师级代码审查，自动修复基础问题
排查生产环境隐性 Bug，补全功能缺口
跨模型复核：
/codex调用 OpenAI Codex 独立评审
3.5 测试阶段：真实环境验证
全量测试：
/qa <测试URL>
启动真实 Chromium 浏览器，自动化点击流程，定位并修复 Bug，生成回归测试仅报告测试：
/qa-only
仅输出 Bug 报告，不修改代码安全审计：
/cso
执行 OWASP Top10+STRIDE 威胁建模，零误报安全检测
3.6 发布阶段：自动化上线
代码合并发布：
/ship
同步主干、运行测试、覆盖率审计、推送代码、创建 PR部署验证：
/land-and-deploy
合并 PR、等待 CI、验证生产环境可用性发布后监控：
/canary
监控控制台错误、性能衰退、页面故障
3.7 复盘阶段：持续优化
命令：/retro
每周工程复盘，统计交付数据、测试健康度、成长点
retro global跨项目、跨 AI 工具全局复盘
四、核心技能分类速查
| 技能类型 | 核心命令 | 功能说明 |
|---|---|---|
| 规划类 | /autoplan /plan-eng-review | 自动完成全维度规划、架构锁定 |
| 设计类 | /design-shotgun /design-html | 视觉探索、生产级前端输出 |
| 评审类 | /review /codex | 代码审查、跨模型复核 |
| 测试类 | /qa /cso | 功能测试、安全审计 |
| 发布类 | /ship /land-and-deploy | 自动化发布、部署验证 |
| 安全类 | /careful /guard | 破坏性操作预警、编辑范围锁定 |
| 工具类 | /learn /gstack-upgrade | 记忆管理、版本自更新 |
五、高级功能解锁
5.1 GBrain 持久化记忆
命令：/setup-gbrain
三种部署方式：Supabase 云服务、自动新建 Supabase、本地 PGLite
为 AI 代理提供跨会话记忆，支持仓库级权限管控（读写 / 只读 / 拒绝）
5.2 并行冲刺管理
通过 Conductor 并行运行多个 Claude Code 会话，同时处理 10-15 个任务：
一个会话做需求规划、一个做代码评审、一个做测试验证
流程化管控避免多代理混乱，单人管理多任务并行
5.3 真实浏览器能力
命令：
/open-gstack-browser
启动带反爬机制、侧边栏 AI 助手的专属浏览器，无验证码干扰会话迁移：
$B handoff/$B resume
遇到验证码、MFA 时转交人工处理，完成后恢复 AI 执行跨代理协同：
/pair-agent
多 AI 代理共享浏览器，标签隔离、安全可控
5.4 安全防护
4 层提示注入防御：本地 ML 分类器、Haudi 会话校验、令牌检测
紧急开关：
GSTACK\_SECURITY\_OFF=1关闭安全防护
六、常见问题与卸载
6.1 常见问题
技能不显示：重新执行
cd ~/.claude/skills/gstack && ./setup/browse失败：执行bun install && bun run build版本过时：运行
/gstack-upgrade或配置auto\_upgrade: true
6.2 卸载方法
- 自动卸载：
~/.claude/skills/gstack/bin/gstack-uninstall- 手动卸载：
停止进程→删除技能链接→清理全局状态→移除各代理集成→清理临时文件
七、总结
gstack 不是简单的 AI 辅助工具，而是完整的 AI 软件工程流水线，它把研发全流程标准化、AI 自动化，解决单人开发效率低、流程不规范、质量难保障的问题。
从需求规划到上线复盘，仅需一系列 slash 命令即可完成，配合 GBrain 记忆、并行冲刺、真实浏览器能力，真正实现单人开发者等效传统团队的交付效率。