596 lines
15 KiB
Markdown
596 lines
15 KiB
Markdown
# YC全流程开发工作流套件
|
||
|
||
`开发工作流` `AI辅助` `代码审查` `自动化部署` `OpenClaw`
|
||
|
||
# gstack-openclaw-skills
|
||
|
||
**Y Combinator CEO Garry Tan 的 gstack 完整开发工作流套件，适配 OpenClaw/WorkBuddy。**
|
||
|
||
[English](README.md) | 简体中文
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/AICreator-Wind/gstack-openclaw-skills/stargazers"><img src="https://img.shields.io/github/stars/AICreator-Wind/gstack-openclaw-skills" alt="Stars"></a>
|
||
<a href="https://github.com/AICreator-Wind/gstack-openclaw-skills/network/members"><img src="https://img.shields.io/github/forks/AICreator-Wind/gstack-openclaw-skills" alt="Forks"></a>
|
||
<a href="https://github.com/AICreator-Wind/gstack-openclaw-skills/blob/main/LICENSE"><img src="https://img.shields.io/github/license/AICreator-Wind/gstack-openclaw-skills" alt="License"></a>
|
||
<img src="https://img.shields.io/badge/平台-OpenClaw%20%7C%20WorkBuddy-blue" alt="OpenClaw | WorkBuddy">
|
||
<img src="https://img.shields.io/badge/版本-2.0.0-green" alt="版本 2.0.0">
|
||
</p>
|
||
|
||
## 目录
|
||
|
||
- [什么是 gstack-skills？](#什么是-gstack-skills)
|
||
- [v2.0 新特性](#v20-新特性)
|
||
- [快速开始](#快速开始)
|
||
- [可用命令](#可用命令)
|
||
- [完整工作流示例](#完整工作流示例)
|
||
- [安装](#安装)
|
||
- [设计理念](#设计理念)
|
||
- [文档](#文档)
|
||
- [贡献](#贡献)
|
||
- [许可证](#许可证)
|
||
|
||
## 什么是 gstack-skills？
|
||
|
||
gstack-skills 是 [gstack](https://github.com/garrytan/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 从文档转变为**完全可执行的技能**：
|
||
|
||
### 新增能力
|
||
|
||
1. **自动执行**：技能现在自动执行，而不仅仅是提供指导
|
||
2. **命令路由**：解析用户输入并路由到对应技能
|
||
3. **状态管理**：在技能之间共享数据和上下文
|
||
4. **工作流编排**：通过单个命令运行完整工作流
|
||
5. **原生集成**：从底层为 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](INSTALL.md)
|
||
|
||
---
|
||
|
||
### 方式二：一键安装
|
||
|
||
**最快方式** - 运行单个脚本：
|
||
|
||
#### macOS/Linux
|
||
|
||
```bash
|
||
git clone https://github.com/AICreator-Wind/gstack-openclaw-skills.git
|
||
cd gstack-openclaw-skills
|
||
./install.sh
|
||
```
|
||
|
||
#### Windows
|
||
|
||
```batch
|
||
git clone https://github.com/AICreator-Wind/gstack-openclaw-skills.git
|
||
cd gstack-openclaw-skills
|
||
install.bat
|
||
```
|
||
|
||
---
|
||
|
||
### 方式三：手动安装
|
||
|
||
```bash
|
||
# 克隆仓库
|
||
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 命令：
|
||
|
||
```python
|
||
# 获取帮助并查看所有命令
|
||
用户: "/gstack"
|
||
|
||
# 验证一个想法
|
||
用户: "/office-hours 我有一个 AI 代码审查工具的想法"
|
||
|
||
# 代码审查
|
||
用户: "/review 当前分支"
|
||
|
||
# 部署
|
||
用户: "/ship 用户认证功能"
|
||
```
|
||
|
||
### 查看可用命令
|
||
|
||
```python
|
||
用户: "/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](CONVERSATION_GUIDE.md) 获取详细示例和技巧。
|
||
|
||
---
|
||
|
||
## 完整工作流示例
|
||
|
||
以下是使用 gstack-skills 开发并发布新功能的完整流程：
|
||
|
||
```python
|
||
# 第一步：验证想法
|
||
用户: "/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 分钟
|
||
|
||
## 安装
|
||
|
||
### 方式一：复制到技能目录
|
||
|
||
```bash
|
||
# OpenClaw
|
||
cp -r gstack-skills ~/.openclaw/skills/
|
||
|
||
# WorkBuddy
|
||
cp -r gstack-skills ~/.workbuddy/skills/
|
||
```
|
||
|
||
### 方式二：符号链接（开发模式）
|
||
|
||
```bash
|
||
# 创建符号链接
|
||
ln -s /path/to/gstack-openclaw-skills/gstack-skills ~/.openclaw/skills/gstack-skills
|
||
```
|
||
|
||
### 方式三：项目级安装
|
||
|
||
复制到你的项目根目录：
|
||
|
||
```bash
|
||
cp -r gstack-skills/ /path/to/your/project/
|
||
```
|
||
|
||
### 验证安装
|
||
|
||
```python
|
||
# 在 OpenClaw/WorkBuddy 中测试安装
|
||
用户: "/gstack"
|
||
|
||
# 若安装正确，你将看到命令概览
|
||
```
|
||
|
||
## 设计理念
|
||
|
||
### 煮沸整片湖原则
|
||
|
||
> "不要只投入一半，要把整片湖煮沸" —— Garry Tan
|
||
|
||
AI 辅助开发应追求**完整实现**，而非走捷径。
|
||
|
||
- **发现问题，真正修复它**（不只是记录下来）
|
||
- **完成任务**（不留下"待优化"注释）
|
||
- **借助 AI 辅助，100% 的质量是可以实现的**（不接受"差不多就行"）
|
||
|
||
### 智慧借鉴
|
||
|
||
借鉴其他产品的功能时，始终要问：
|
||
|
||
1. **它为什么在原产品中奏效？**
|
||
2. **它在你的产品中会成功还是失败？**
|
||
3. **要获得成功，需要做哪些适配？**
|
||
|
||
### 具体性是唯一的货币
|
||
|
||
- **要求具体的证据**，而非模糊的描述
|
||
- **"10 个人说他们想要"** 比 **"所有人都想要"** 更有价值
|
||
- **聚焦实际行为**，而非口头意向
|
||
|
||
## 文档
|
||
|
||
- **[USAGE.md](USAGE.md)**：带示例的完整使用指南
|
||
- **[SKILL.md](gstack-skills/SKILL.md)**：主要技能文档
|
||
- **[CONTRIBUTING.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 # 贡献指南
|
||
```
|
||
|
||
## 工作原理
|
||
|
||
### 命令路由
|
||
|
||
当你输入命令时：
|
||
|
||
```python
|
||
用户: "/review 我的改动"
|
||
```
|
||
|
||
`command_router.py` 脚本会：
|
||
|
||
1. 解析输入：`/review` + `我的改动`
|
||
2. 路由到对应技能：`review/SKILL.md`
|
||
3. 加载技能指令
|
||
4. AI 自动执行技能工作流
|
||
|
||
### 状态管理
|
||
|
||
技能可以通过工作流状态共享数据：
|
||
|
||
```python
|
||
# 工作流开始
|
||
/state_manager.py init → 创建工作流 ID: abc12345
|
||
|
||
# 每个技能可读写状态
|
||
/office-hours → 保存验证结果
|
||
/plan-eng-review → 读取验证，保存架构
|
||
/review → 读取架构，保存代码问题
|
||
/qa → 读取代码问题，保存测试结果
|
||
/ship → 读取所有状态，创建部署包
|
||
```
|
||
|
||
### 自动化执行
|
||
|
||
与 v1.0（仅提供指导）不同，v2.0 技能会：
|
||
|
||
1. **分析上下文**（git 状态、项目结构等）
|
||
2. **自动执行工作流**
|
||
3. **做出决策**（运行哪些测试、修复哪些 Bug）
|
||
4. **执行操作**（运行测试、修复 Bug、创建 PR）
|
||
5. **报告结果**（全面的状态报告）
|
||
|
||
## 与原版 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](USAGE.md) 的故障排除部分。
|
||
|
||
### 问：可以自定义工作流吗？
|
||
|
||
**答**：可以！每个技能都是一个独立的 Markdown 文件，你可以自由定制。详见 [CONTRIBUTING.md](CONTRIBUTING.md)。
|
||
|
||
### 问：支持 CI/CD 吗？
|
||
|
||
**答**：`/ship` 专门设计为与现有 CI/CD 流水线配合使用。它运行测试、生成 PR、更新文档——完全兼容 CI/CD。
|
||
|
||
## 贡献
|
||
|
||
欢迎贡献！详见 [CONTRIBUTING.md](CONTRIBUTING.md)。
|
||
|
||
我们希望在以下方面获得帮助：
|
||
- 添加更多专项技能
|
||
- 改善错误处理
|
||
- 添加更多示例
|
||
- 编写测试
|
||
- 翻译文档
|
||
|
||
## 许可证
|
||
|
||
MIT 许可证——详见 [LICENSE](LICENSE) 文件。
|
||
|
||
## 致谢
|
||
|
||
- **Garry Tan**，感谢他创建了 [gstack](https://github.com/garrytan/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
|
||
**状态**：✅ 生产就绪 |