# 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
**状态**：✅ 生产就绪