mc-skills/catalog
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
catalog/repos/aicreator-wind--gstack-openclaw-skills.md

596 lines
15 KiB
Markdown
Raw Permalink Normal View History

catalog: 更新 2026-04-07 11:44
2026-04-07 11:44:56 +08:00
# 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
**状态**：✅ 生产就绪
Reference in New Issue Copy Permalink