15 KiB
YC全流程开发工作流套件
开发工作流 AI辅助 代码审查 自动化部署 OpenClaw
gstack-openclaw-skills
Y Combinator CEO Garry Tan 的 gstack 完整开发工作流套件,适配 OpenClaw/WorkBuddy。
English | 简体中文
目录
什么是 gstack-skills?
gstack-skills 是 gstack 的 OpenClaw/WorkBuddy 适配版,gstack 是由 Y Combinator CEO Garry Tan 创建的开源开发工作流。
Garry Tan 用 gstack 在 60 天内编写了超过 60 万行生产代码(其中 35% 为测试代码)。
本适配版让任何运行在 OpenClaw 或 WorkBuddy 平台上的 AI 智能体都能使用这套强大的工作流。
核心特性
- 15 个专项工具:从产品构思到部署的完整工具套件
- 自动化工作流:AI 根据自然语言指令自动执行工作流
- 一键访问:只需输入
/ship、/review、/qa等命令 - 状态管理:在工作流步骤之间共享上下文
- OpenClaw 原生:专为 OpenClaw/WorkBuddy 技能系统构建
v2.0 新特性
v2.0 是一次完全重写,将 gstack 从文档转变为完全可执行的技能:
新增能力
- 自动执行:技能现在自动执行,而不仅仅是提供指导
- 命令路由:解析用户输入并路由到对应技能
- 状态管理:在技能之间共享数据和上下文
- 工作流编排:通过单个命令运行完整工作流
- 原生集成:从底层为 OpenClaw/WorkBuddy 构建
与 v1.0 的对比
| 特性 | v1.0 | v2.0 |
|---|---|---|
| 执行方式 | 手动 | 自动 |
| 集成方式 | 仅文档 | 原生技能 |
| 状态管理 | 无 | 完整状态管理 |
| 命令数量 | 15 个命令 | 15 个命令 + 路由 |
| 工作流 | 静态 | 动态 & 编排 |
快速开始
方式一:交互式安装(最简单)
直接告诉 OpenClaw/WorkBuddy 帮你安装:
请帮我安装 gstack-skills
或:
帮我从 GitHub 安装 gstack-skills:AICreator-Wind/gstack-openclaw-skills
OpenClaw/WorkBuddy 会自动:
- 克隆仓库
- 检测你的平台
- 将技能复制到正确位置
- 验证安装
- 告知安装完成!
就这么简单! 然后重启 OpenClaw/WorkBuddy,输入 /gstack 开始使用。
详细说明请参见 INSTALL.md
方式二:一键安装
最快方式 - 运行单个脚本:
macOS/Linux
git clone https://github.com/AICreator-Wind/gstack-openclaw-skills.git
cd gstack-openclaw-skills
./install.sh
Windows
git clone https://github.com/AICreator-Wind/gstack-openclaw-skills.git
cd gstack-openclaw-skills
install.bat
方式三:手动安装
# 克隆仓库
git clone https://github.com/AICreator-Wind/gstack-openclaw-skills.git
cd gstack-openclaw-skills
# 复制到 OpenClaw 技能目录
cp -r gstack-skills ~/.openclaw/skills/
# 或 WorkBuddy
cp -r gstack-skills ~/.workbuddy/skills/
开始使用
安装后,重启 OpenClaw/WorkBuddy,直接使用任意 gstack 命令:
# 获取帮助并查看所有命令
用户: "/gstack"
# 验证一个想法
用户: "/office-hours 我有一个 AI 代码审查工具的想法"
# 代码审查
用户: "/review 当前分支"
# 部署
用户: "/ship 用户认证功能"
查看可用命令
用户: "/gstack"
# AI 展示所有可用命令:
# /office-hours - 产品构思与验证
# /plan-ceo-review - CEO 视角规划
# /plan-eng-review - 工程架构审查
# /review - 合并前代码审查
# /qa - 测试应用并修复 Bug
# /ship - 自动化发布工作流
# ... (以及另外 9 个)
可用命令
产品构思阶段
| 命令 | 用途 |
|---|---|
/office-hours |
YC 办公室答疑,产品创意验证 |
/plan-ceo-review |
CEO 视角的功能规划 |
/plan-eng-review |
工程架构审查 |
/plan-design-review |
设计审查 |
开发阶段
| 命令 | 用途 |
|---|---|
/review |
合并前代码审查并自动修复 |
/investigate |
系统性根因分析 |
/design-consultation |
设计系统咨询 |
测试与发布阶段
| 命令 | 用途 |
|---|---|
/qa |
测试应用并修复 Bug |
/qa-only |
仅报告 Bug(不修复) |
/ship |
全自动化发布工作流 |
文档与复盘
| 命令 | 用途 |
|---|---|
/document-release |
更新项目文档 |
/retro |
团队复盘与周报 |
高级工具
| 命令 | 用途 |
|---|---|
/codex |
OpenAI Codex 独立审查(第二意见) |
/careful |
危险操作警告 |
/freeze |
锁定文件编辑范围 |
/guard |
完全安全模式(careful + freeze) |
如何使用 gstack-skills
安装后,使用 gstack-skills 非常简单——直接与 OpenClaw/WorkBuddy 对话即可!
开始使用
安装后,重启 OpenClaw/WorkBuddy 并输入:
用户: /gstack
你将看到所有可用命令。
示例对话
快速代码审查
用户: /review
AI: 正在审查你的当前分支...
变更文件:3
新增行数:+127,删除行数:-45
发现严重问题:
❌ 1. src/db/queries.py:42 存在 SQL 注入风险
已自动修复:
✅ 修复了 SQL 注入
✅ 添加了速率限制
状态:⚠️ 完成(有待关注项)
下一步:运行 /qa 进行测试
测试
用户: /qa
AI: 正在运行系统性 QA 测试...
测试结果:
• 单元测试:42/42 通过 ✅
• 集成测试:15/15 通过 ✅
健康分:95/100
状态:✅ 可以发布
部署
用户: /ship
AI: 正在准备自动化发布...
1. 合并基础分支... ✅
2. 运行测试... ✅(57/57 通过)
3. 更新版本... ✅(v2.2.0)
4. 创建 PR... ✅(#247)
状态:✅ 已部署
自然语言同样有效!
你不需要精确的命令,自然语言也可以:
用户: 审查我的代码
AI: 正在审查你的当前分支...
[与 /review 相同]
用户: 部署到生产环境
AI: 正在准备自动化发布...
[与 /ship 相同]
完整指南
请参见 CONVERSATION_GUIDE.md 获取详细示例和技巧。
完整工作流示例
以下是使用 gstack-skills 开发并发布新功能的完整流程:
# 第一步:验证想法
用户: "/office-hours 我想为我的应用添加用户资料功能"
AI: 使用 YC 的 6 个问题来验证你的创业想法:
1. 用户最大的痛点是什么?
2. 你的方案如何解决这个问题?
3. 现有方案为什么不够好?
4. 你能触达这些用户吗?
5. 用户愿意付费吗?
6. 用户如何发现你的产品?
[引导完成所有问题]
# 第二步:CEO 视角审查
用户: "/plan-ceo-review 用户资料功能"
AI: 从 CEO 视角分析...
- 战略对齐:✅
- 市场机会:✅
- 资源需求:中等
- 风险:识别出 3 个关键风险
# 第三步:工程架构审查
用户: "/plan-eng-review 用户资料功能架构"
AI: 审查技术架构...
- 数据库设计:PostgreSQL with JSONB
- API 结构:RESTful + GraphQL 备选
- 安全:JWT + OAuth2
- 可扩展性:支持水平扩展
# 第四步:实现功能
[开发者编写代码...]
# 第五步:代码审查
用户: "/review"
AI: 正在审查你的当前分支...
变更文件:12
新增行数:+342
删除行数:-89
发现严重问题:
1. src/db/queries.py:42 存在 SQL 注入风险 ❌
2. src/api/routes.py:87 缺少身份验证 ❌
已自动修复:
1. ✅ 修复了 2 个未使用的导入
2. ✅ 使用 black 格式化代码
状态:⚠️ 完成(有待关注项)
请在合并前修复严重问题。
# 第六步:QA 测试
用户: "/qa 用户资料功能"
AI: 正在运行系统性 QA 测试...
测试结果:
- 健康分:87/100
- 发现 Bug:5 个
- 已修复 Bug:5 个
- 通过测试:42/42
状态:✅ 可以发布
# 第七步:部署
用户: "/ship"
AI: 正在准备自动化发布...
1. ✅ 合并基础分支
2. ✅ 运行所有测试(42/42 通过)
3. ✅ 更新版本至 v2.1.0
4. ✅ 生成变更日志
5. ✅ 创建 PR #234
6. ✅ 更新文档
状态:✅ 已发布
PR: https://github.com/your/repo/pull/234
总耗时:端到端功能开发与部署约 15 分钟
安装
方式一:复制到技能目录
# OpenClaw
cp -r gstack-skills ~/.openclaw/skills/
# WorkBuddy
cp -r gstack-skills ~/.workbuddy/skills/
方式二:符号链接(开发模式)
# 创建符号链接
ln -s /path/to/gstack-openclaw-skills/gstack-skills ~/.openclaw/skills/gstack-skills
方式三:项目级安装
复制到你的项目根目录:
cp -r gstack-skills/ /path/to/your/project/
验证安装
# 在 OpenClaw/WorkBuddy 中测试安装
用户: "/gstack"
# 若安装正确,你将看到命令概览
设计理念
煮沸整片湖原则
"不要只投入一半,要把整片湖煮沸" —— Garry Tan
AI 辅助开发应追求完整实现,而非走捷径。
- 发现问题,真正修复它(不只是记录下来)
- 完成任务(不留下"待优化"注释)
- 借助 AI 辅助,100% 的质量是可以实现的(不接受"差不多就行")
智慧借鉴
借鉴其他产品的功能时,始终要问:
- 它为什么在原产品中奏效?
- 它在你的产品中会成功还是失败?
- 要获得成功,需要做哪些适配?
具体性是唯一的货币
- 要求具体的证据,而非模糊的描述
- "10 个人说他们想要" 比 "所有人都想要" 更有价值
- 聚焦实际行为,而非口头意向
文档
- USAGE.md:带示例的完整使用指南
- SKILL.md:主要技能文档
- CONTRIBUTING.md:如何贡献
架构
gstack-openclaw-skills/
├── gstack-skills/ # 主技能包
│ ├── SKILL.md # 主入口与路由
│ ├── office-hours/ # 产品构思
│ ├── plan-ceo-review/ # CEO 视角
│ ├── plan-eng-review/ # 工程审查
│ ├── review/ # 代码审查
│ ├── qa/ # 测试与 QA
│ ├── ship/ # 部署
│ ├── investigate/ # 调试
│ └── scripts/ # 辅助脚本
│ ├── command_router.py # 命令路由
│ └── state_manager.py # 状态管理
├── USAGE.md # 使用指南
├── README.md # 本文件
└── CONTRIBUTING.md # 贡献指南
工作原理
命令路由
当你输入命令时:
用户: "/review 我的改动"
command_router.py 脚本会:
- 解析输入:
/review+我的改动 - 路由到对应技能:
review/SKILL.md - 加载技能指令
- AI 自动执行技能工作流
状态管理
技能可以通过工作流状态共享数据:
# 工作流开始
/state_manager.py init → 创建工作流 ID: abc12345
# 每个技能可读写状态
/office-hours → 保存验证结果
/plan-eng-review → 读取验证,保存架构
/review → 读取架构,保存代码问题
/qa → 读取代码问题,保存测试结果
/ship → 读取所有状态,创建部署包
自动化执行
与 v1.0(仅提供指导)不同,v2.0 技能会:
- 分析上下文(git 状态、项目结构等)
- 自动执行工作流
- 做出决策(运行哪些测试、修复哪些 Bug)
- 执行操作(运行测试、修复 Bug、创建 PR)
- 报告结果(全面的状态报告)
与原版 gstack 的对比
| 特性 | 原版 gstack | gstack-skills v2.0 |
|---|---|---|
| 平台 | Claude Code | OpenClaw/WorkBuddy |
| 执行方式 | 手动脚本 | AI 执行工作流 |
| 命令 | 斜杠命令 | 命令 + 自然语言 |
| 集成 | Bun/Git 专用 | 平台无关 |
| 状态 | 基于文件 | 托管状态系统 |
| 学习曲线 | 高 | 低 |
常见问题
问:这与原版 gstack 有何不同?
答:原版 gstack 是为 Claude Code 构建的,需要手动运行脚本。gstack-skills v2.0 是针对 OpenClaw/WorkBuddy 的完全重写,实现了自动执行。你不需要 Bun 或特定脚本——只需使用自然语言命令即可。
问:可以在任何 OpenClaw/WorkBuddy 项目中使用吗?
答:可以!gstack-skills 是平台无关的,适用于任何项目。
问:需要安装依赖吗?
答:不需要,gstack-skills 无需外部依赖。它使用你已有的工具(git、你的测试框架等)。
问:如果命令失败了怎么办?
答:每个技能都提供清晰的错误信息并建议修复方式。常见问题已记录在 USAGE.md 的故障排除部分。
问:可以自定义工作流吗?
答:可以!每个技能都是一个独立的 Markdown 文件,你可以自由定制。详见 CONTRIBUTING.md。
问:支持 CI/CD 吗?
答:/ship 专门设计为与现有 CI/CD 流水线配合使用。它运行测试、生成 PR、更新文档——完全兼容 CI/CD。
贡献
欢迎贡献!详见 CONTRIBUTING.md。
我们希望在以下方面获得帮助:
- 添加更多专项技能
- 改善错误处理
- 添加更多示例
- 编写测试
- 翻译文档
许可证
MIT 许可证——详见 LICENSE 文件。
致谢
- Garry Tan,感谢他创建了 gstack 并分享了"煮沸整片湖"的理念
- Y Combinator,感谢其办公室答疑框架
- 所有贡献者,感谢他们对 gstack-skills 的贡献
链接
- GitHub:https://github.com/AICreator-Wind/gstack-openclaw-skills
- 原版 gstack:https://github.com/garrytan/gstack
- OpenClaw:https://openclaw.ai
- WorkBuddy:https://codebuddy.cn
版本:2.0.0 最后更新:2026-03-21 状态:✅ 生产就绪