教程概述

系列索引: gstack 教程系列

这是 gstack 系列的第一篇教程，涵盖所有支持平台的安装与配置。

你将学到

• ✅ gstack 的高层工作原理
• ✅ 如何在 4 个主流平台上安装 gstack
• ✅ 如何验证安装成功
• ✅ 如何使用安全护栏：/careful、/freeze、/guard
• ✅ 如何排查常见问题

gstack 是什么？

gstack 是一个代理技能框架。本质上，它是一组精心设计的提示和工作流规则，引导 AI 编程助手遵循经过验证的工程实践。

核心特点

1. 虚拟团队 — 23 位专家和 8 个强力工具，扮演 CEO、工程经理、设计师、QA、安全官、发布工程师
2. 冲刺工作流 — 思考 → 规划 → 构建 → 审查 → 测试 → 发布 → 复盘
3. 跨平台 — 支持 Claude Code、Codex、Cursor、OpenCode、OpenClaw 等
4. 开源 — MIT 许可，永久免费

工作流概览

flowchart TD
    A[用户请求] --> B{/office-hours}
    B --> C[产品审问]
    C --> D{/plan-ceo-review}
    D --> E[战略范围挑战]
    E --> F{/plan-eng-review}
    F --> G[架构锁定]
    G --> H[实现]
    H --> I{/review}
    I --> J[发现 bug，自动修复]
    J --> K{/qa}
    K --> L[实时浏览器测试]
    L --> M{/ship}
    M --> N[发布]

    style B fill:#e1f5ff
    style D fill:#e1f5ff
    style F fill:#e1f5ff
    style I fill:#e1f5ff
    style K fill:#e1f5ff
    style M fill:#e1f5ff

安装前准备

系统要求

必需工具

# Git 必须已配置
git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"

# 必须安装 Bun v1.0+
bun --version

# Node.js（仅 Windows，用于 Playwright）
node --version

平台 1：在 Claude Code 上安装

全局安装（推荐）

步骤 1：克隆并设置

在 Claude Code 中运行：

git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup

步骤 2：添加到 CLAUDE.md

在项目的 CLAUDE.md 中添加 “gstack” 部分：

## gstack
使用 gstack 的 /browse 进行所有网页浏览。不要使用 mcp__claude-in-chrome__* 工具。
可用技能：/office-hours, /plan-ceo-review, /plan-eng-review, /plan-design-review, /design-consultation, /design-shotgun, /design-html, /review, /ship, /land-and-deploy, /canary, /benchmark, /browse, /open-gstack-browser, /qa, /qa-only, /design-review, /setup-browser-cookies, /setup-deploy, /retro, /investigate, /document-release, /codex, /cso, /autoplan, /pair-agent, /careful, /freeze, /guard, /unfreeze, /gstack-upgrade, /learn。

步骤 3：验证

开始一个新会话并询问：

帮我规划一个新功能

如果 AI 使用 /office-hours 开始询问澄清问题而不是直接写代码，安装就成功了。

团队模式 — 共享仓库自动更新

每个开发者全局安装，更新自动发生：

cd ~/.claude/skills/gstack && ./setup --team

然后引导你的仓库，让队友获得它：

cd <你的仓库>
~/.claude/skills/gstack/bin/gstack-team-init required
git add .claude/ CLAUDE.md && git commit -m "require gstack for AI-assisted work"

平台 2：在 Codex CLI 上安装

安装提示：

告诉 Codex：

Fetch and follow instructions from https://raw.githubusercontent.com/garrytan/gstack/refs/heads/main/.codex/INSTALL.md

或直接运行：

git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.codex/skills/gstack
cd ~/.codex/skills/gstack && ./setup --host codex

平台 3：在 Cursor 上安装

安装：

git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.cursor/skills/gstack
cd ~/.cursor/skills/gstack && ./setup --host cursor

然后重启 Cursor 并加载项目。

平台 4：在 OpenClaw 上安装

选项 A：Claude Code 会话

OpenClaw 通过 ACP 生成 Claude Code 会话，所以当 Claude Code 安装了 gstack 时就能工作。将此粘贴到你的 OpenClaw 代理：

Install gstack: run `git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup`

选项 B：原生 OpenClaw 技能（通过 ClawHub）

四个方法论技能直接在 OpenClaw 代理中工作：

clawhub install gstack-openclaw-office-hours gstack-openclaw-ceo-review gstack-openclaw-investigate gstack-openclaw-retro

平台差异

安全护栏

gstack 包含防止意外损坏的安全功能。

/careful — 破坏性命令警告

/careful

在任何破坏性命令前警告：

• rm -rf
• DROP TABLE
• git push --force
• git reset --hard

示例：

你: rm -rf node_modules
AI: ⚠️ 破坏性命令警告
    这将永久删除 node_modules/
    输入 "proceed" 确认，或描述你想实现什么以获得更安全的替代方案。

/freeze — 编辑锁定到指定目录

/freeze src/components/

将文件编辑限制在指定目录。在调试或实现聚焦功能时防止意外更改范围外的内容。

示例：

你: /freeze src/auth/
AI: 🔒 编辑锁定已激活
    编辑限制在: src/auth/
    尝试编辑 src/utils/helper.ts 将被阻止
    使用 /unfreeze 移除此限制

/guard — 完全安全

/guard

组合 /careful + /freeze。生产工作的最大安全性。

flowchart TD
    A[/guard] --> B[/careful]
    A --> C[/freeze]
    B --> D[破坏性命令警告]
    C --> E[限制编辑到目录]
    D --> F[最大安全]
    E --> F

/unfreeze — 移除编辑锁定

/unfreeze

移除 /freeze 边界，允许再次在任何地方编辑。

验证安装

测试 1：/office-hours 触发

输入：

我想给博客添加评论系统

预期行为：

• ❌ 立即开始写评论 UI 代码 → 失败
• ✅ 开始询问澄清问题（提供商选择、审核策略、存储） → 通过

测试 2：/careful 警告

输入：

/careful
rm -rf build/

预期行为：

• ❌ 立即删除 → 失败
• ✅ 显示警告，要求确认 → 通过

测试 3：/browse 工作

输入：

/browse https://example.com

预期行为：

• ❌ 关于缺少浏览器的错误 → 失败
• ✅ 打开 Chromium，导航，显示截图 → 通过

故障排除

问题 1：技能不显示

症状：AI 不识别 /office-hours 或其他 gstack 技能。

修复：

1. 确认插件已加载：

   ls ~/.claude/skills/gstack/SKILL.md
   

2. 确认 CLAUDE.md 有 gstack 部分。

3. 重启 Claude Code 会话。

问题 2：/browse 失败

症状：运行 /browse 时浏览器错误。

修复：

cd ~/.claude/skills/gstack && bun install && bun run build

问题 3：安装过时

症状：技能行为与文档不同。

修复：

/gstack-upgrade

或在配置中设置自动升级：

# ~/.gstack/config.yaml
auto_upgrade: true

问题 4：Codex 技能加载失败

症状：“Skipped loading skill(s) due to invalid SKILL.md”

修复：

cd ~/.codex/skills/gstack && git pull && ./setup --host codex

配置

前缀与无前缀模式

默认情况下，gstack 技能使用短名称（/office-hours）。你可以命名空间它们：

# 命名空间: /gstack-office-hours
cd ~/.claude/skills/gstack && ./setup --prefix

# 短名称: /office-hours
cd ~/.claude/skills/gstack && ./setup --no-prefix

遥测

gstack 包含可选的使用遥测：

• 默认关闭 — 除非你说否则不发送任何内容
• 发送内容：技能名称、持续时间、成功/失败、gstack 版本、操作系统
• 从不发送：代码、文件路径、仓库名、提示

随时更改：

gstack-config set telemetry off  # 禁用
gstack-config set telemetry on   # 启用

最佳实践

1. 从安全开始

对于生产工作：

/guard

这可以防止在专注于任务时发生意外损坏。

2. 对共享仓库使用团队模式

每个开发者自动获得相同的 gstack 版本。没有版本漂移。

3. 保持 CLAUDE.md 更新

当 gstack 添加新技能时，更新你的 CLAUDE.md gstack 部分。

下一步

安装完成后，继续：

• 📖 教程 2：office-hours — YC 风格产品审问
• 📖 教程 3：plan-ceo-review — 战略范围挑战

参考资料

• 官方仓库：github.com/garrytan/gstack
• 作者：Garry Tan (@garrytan)
• Y Combinator：ycombinator.com

遇到问题？ 留言或查看 GitHub Issues！

系列导航：

• ← 上一篇: 系列前言：Garry Tan 的 23 专家 AI 编程框架
• → 下一篇: 教程 2：office-hours — YC 风格产品审问
• 返回: 系列索引