GStack 学习教程
GStack 学习教程
从零开始掌握 GStack - YC CEO 的 Claude Code 工作流配置
教程日期：2026-03-22（更新）
目录
一、环境准备
1.1 前置知识
学习 GStack 前建议了解：
| 知识领域 | 重要程度 | 说明 |
|---|---|---|
| Claude Code 基础 | ⭐⭐⭐⭐⭐ | 理解 Claude Code CLI 的基本用法 |
| Git 工作流 | ⭐⭐⭐⭐ | PR、分支、合并等概念 |
| 命令行基础 | ⭐⭐⭐⭐ | 能够运行终端命令 |
| 软件开发流程 | ⭐⭐⭐ | 理解规划、开发、测试、发布流程 |
1.2 系统要求
支持平台：
├── macOS (x64/arm64) ✅
├── Linux (x64/arm64) ✅
└── Windows ❌ (浏览器二进制暂不支持)
必需软件：
├── Claude Code CLI (最新版)
├── Git
└── Bun v1.0+ (用于编译浏览器二进制)
1.3 安装 Claude Code
# macOS/Linux
curl -fsSL https://claude.ai/install.sh | sh
# 或使用 npm
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version
1.4 安装 Bun
# macOS/Linux
curl -fsSL https://bun.sh/install | bash
# 验证安装
bun --version
1.5 安装 GStack
打开 Claude Code，粘贴以下命令：
安装 gstack: 运行 `git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup` 然后在 CLAUDE.md 中添加 gstack 配置
或者手动执行：
# 克隆仓库
git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack
# 运行安装脚本
cd ~/.claude/skills/gstack && ./setup
1.6 配置 CLAUDE.md
在 ~/.claude/CLAUDE.md 中添加以下内容：
## gstack
使用 gstack 的 /browse 技能进行所有 Web 浏览，不要使用 mcp__claude-in-chrome__* 工具。
### 可用技能
| 技能 | 用途 |
|------|------|
| /plan-ceo-review | 创始人模式 - 重新思考产品方向，找到 10 星产品 |
| /plan-eng-review | 工程经理模式 - 锁定架构、数据流、边界条件 |
| /review | 偏执审查模式 - 发现通过 CI 但可能爆炸的问题 |
| /ship | 发布模式 - 自动化同步、测试、推送、创建 PR |
| /browse | 浏览器模式 - 让 AI 拥有"眼睛"，自动化浏览 |
| /qa | QA 模式 - 测试应用、发现 Bug、自动修复 |
| /qa-only | 仅报告 QA 模式 - 只报告不修复 |
| /setup-browser-cookies | 导入浏览器 Cookies |
| /retro | 复盘模式 - 团队周度复盘 |
| /document-release | 文档模式 - 更新项目文档 |
1.7 验证安装
# 检查技能文件
ls ~/.claude/skills/gstack/
# 应该看到：
# plan-ceo-review.md
# plan-eng-review.md
# review.md
# ship.md
# browse.md
# qa.md
# ...
# 检查符号链接
ls -la ~/.claude/skills/ | grep -E "browse|qa|review|ship"
二、快速开始
2.1 Hello World：第一次使用
在 Claude Code 中：
你: /plan-ceo-review
Claude: 我现在处于 CEO/创始人模式。
请描述你想要构建的功能或产品，
我会帮助你重新思考问题，
找到隐藏在需求中的 10 星产品。
你: 我想给电商网站添加一个商品收藏功能
Claude: "商品收藏"是一个起点，但让我们思考一下真正的用户需求...
用户真正想要的是什么？
- 他们想记住感兴趣的商品
- 他们想比较不同商品
- 他们想等待降价通知
- 他们想分享给朋友
10 星版本可能包括：
1. 智能收藏 - 自动分类和标签
2. 价格追踪 - 降价时主动通知
3. 比较视图 - 并排对比收藏商品
4. 分享和协作 - 与家人朋友共享收藏夹
5. 智能推荐 - 基于收藏推荐相似商品
你想要实现哪些功能？
2.2 完整工作流演示
# 1. 产品规划
你: /plan-ceo-review
我想添加用户头像上传功能
# 2. 技术规划
你: /plan-eng-review
好的，我们决定了要实现：头像上传、裁剪、压缩、CDN 存储
# 3. 实现
你: [退出计划模式，开始编码]
请实现头像上传功能
# 4. 代码审查
你: /review
# 5. 发布
你: /ship
# 6. 测试
你: /qa
三、核心概念
3.1 概念图谱
┌─────────────────┐
│ GStack │
│ (工具集) │
└────────┬────────┘
│
┌────────────────────────┼────────────────────────┐
│ │ │
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ Plan 技能 │ │ Execute 技能 │ │ Review 技能 │
│ (规划阶段) │ │ (执行阶段) │ │ (审查阶段) │
├───────────────┤ ├───────────────┤ ├───────────────┤
│/plan-ceo-review│ │ /ship │ │ /review │
│/plan-eng-review│ │ /browse │ │ /qa │
│ │ │ /qa │ │ /qa-only │
└───────────────┘ └───────────────┘ └───────────────┘
│ │ │
└────────────────────────┼────────────────────────┘
│
▼
┌───────────────┐
│ Supporting │
│ 技能 │
├───────────────┤
│/setup-browser │
│ -cookies │
│ /retro │
│/document- │
│ release │
└───────────────┘
3.2 核心概念详解
认知模式 (Cognitive Mode)
GStack 的核心思想是让 AI 在不同的"认知模式"之间切换：
┌─────────────────────────────────────────────────────────────────┐
│ 认知模式切换 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 创始人模式 工程经理模式 审查员模式 │
│ /plan-ceo-review /plan-eng-review /review │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 用户同理心 │ │ 技术严谨 │ │ 偏执审查 │ │
│ │ 产品愿景 │ │ 架构设计 │ │ 风险发现 │ │
│ │ 长期思考 │ │ 边界条件 │ │ 安全意识 │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ 发布模式 QA 模式 文档模式 │
│ /ship /qa /document-release │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 执行效率 │ │ 质量保证 │ │ 清晰表达 │ │
│ │ 自动化 │ │ Bug 发现 │ │ 一致性 │ │
│ │ 可靠性 │ │ 修复验证 │ │ 完整性 │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
技能 (Skill)
GStack 中的每个技能都是一个精心设计的 Markdown 提示词文件：
技能文件结构：
~/.claude/skills/gstack/
├── plan-ceo-review.md
│ └── 内容：系统提示词 + 行为指南 + 示例
├── plan-eng-review.md
├── review.md
├── ship.md
└── ...
工作流 (Workflow)
GStack 推荐的工作流顺序：
标准工作流：
1. 规划阶段
┌─────────────────┐
│ /plan-ceo-review │ → 确保方向正确
└────────┬────────┘
↓
┌─────────────────┐
│ /plan-eng-review │ → 确保架构可行
└────────┬────────┘
↓
2. 实现阶段
┌─────────────────┐
│ 正常编码 │ → Claude Code 标准模式
└────────┬────────┘
↓
3. 审查阶段
┌─────────────────┐
│ /review │ → 发现潜在问题
└────────┬────────┘
↓
4. 发布阶段
┌─────────────────┐
│ /ship │ → 自动化发布
└────────┬────────┘
↓
5. 验证阶段
┌─────────────────┐
│ /qa │ → 功能验证
└────────┬────────┘
↓
6. 文档阶段
┌─────────────────┐
│ /document-release │ → 更新文档
└─────────────────┘
3.3 术语表
| 术语 | 英文 | 解释 |
|---|---|---|
| 技能 | Skill | Claude Code 的可调用提示词模块 |
| 认知模式 | Cognitive Mode | AI 的思维方式（创始人/工程师/审查员等） |
| 工作流 | Workflow | 技能的组合使用顺序 |
| 浏览器自动化 | Browser Automation | 通过 Playwright 控制 Chromium |
| 冒烟测试 | Smoke Test | 快速验证核心功能的测试 |
| 复盘 | Retro | 团队周期性回顾和总结 |
四、技能详解
4.1 /plan-ceo-review - 创始人模式
设计目的
重新思考问题，找到隐藏在需求中的 10 星产品。
使用场景
- 开始新功能开发前
- 不确定产品方向时
- 想要挑战现有假设时
使用示例
你: /plan-ceo-review
我想给博客添加评论功能
Claude: 让我们重新思考这个问题...
用户真正想要的是什么？
- 他们想要与作者互动
- 他们想要表达观点
- 他们想要看到其他读者的想法
- 他们想要建立社区感
"评论功能"是实现这些目标的一种方式，但不是唯一方式。
10 星版本可能包括：
1. 智能回复建议 - AI 帮助用户写出更好的评论
2. 评论质量评分 - 过滤低质量评论
3. 线程式讨论 - 支持深度对话
4. 作者互动标记 - 作者回复时高亮显示
5. 社区徽章 - 活跃评论者获得认可
6. 评论订阅 - 追踪感兴趣的讨论
你想要实现哪些功能？还是坚持基本评论功能？
4.2 /plan-eng-review - 工程经理模式
设计目的
锁定架构、数据流、边界条件和测试矩阵。
使用场景
- 产品方向确定后
- 需要技术方案时
- 准备开始实现前
使用示例
你: /plan-eng-review
我们决定实现：智能回复建议 + 线程式讨论 + 作者互动标记
Claude: 好的，让我设计技术方案...
## 架构图
┌─────────────────────────────────────────────┐
│ Frontend │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │CommentList│ │ReplyBox │ │AITips │ │
│ └────┬────┘ └────┬────┘ └────┬────┘ │
└───────┼────────────┼────────────┼──────────┘
│ │ │
┌───────┴────────────┴────────────┴──────────┐
│ API Layer │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │Comments │ │ Threads │ │ AI │ │
│ │Controller│ │Service │ │Service │ │
│ └────┬────┘ └────┬────┘ └────┬────┘ │
└───────┼────────────┼────────────┼──────────┘
│ │ │
┌───────┴────────────┴────────────┴──────────┐
│ Storage │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │PostgreSQL│ │ Redis │ │OpenAI │ │
│ │Comments │ │ Cache │ │ API │ │
│ └─────────┘ └─────────┘ └─────────┘ │
└─────────────────────────────────────────────┘
## 数据流
1. 用户提交评论
→ 验证内容
→ 存储到 PostgreSQL
→ 更新 Redis 缓存
→ 触发 AI 回复建议生成
2. 加载评论列表
→ 检查 Redis 缓存
→ 缓存未命中则查询 PostgreSQL
→ 组装嵌套结构
→ 返回给前端
## 边界条件
- 最大嵌套深度：5 层
- 评论长度：1-5000 字符
- 每用户每小时评论数：100
- AI 建议超时：5 秒
## 测试矩阵
| 场景 | 测试用例 |
|------|----------|
| 正常评论 | 提交、显示、嵌套 |
| 边界值 | 空评论、超长评论 |
| 并发 | 同时回复同一条 |
| 性能 | 1000 条评论加载 |
| AI | 建议生成、超时处理 |
4.3 /review - 偏执审查模式
设计目的
发现能通过 CI 但在生产环境爆炸的 Bug。
使用场景
- 代码实现完成后
- 准备发布前
- 代码审查时
使用示例
你: /review
Claude: 正在审查当前分支的代码变更...
## 审查结果
### 🔴 严重问题 (2)
1. **竞态条件** - `comments_controller.rb:47`
```ruby
# 问题：两个请求可能同时创建相同的嵌套结构
parent = Comment.find(params[:parent_id])
comment = parent.children.create!(...)
```
建议：使用数据库级别的 advisory lock
2. **N+1 查询** - `comment_serializer.rb:23`
```ruby
# 问题：每条评论都会查询作者信息
comments.map { |c| { author: c.user.name } }
```
建议：使用 `includes(:user)` 预加载
### 🟡 中等问题 (1)
3. **信任边界** - `ai_suggestions_service.rb:15`
```ruby
# 问题：用户输入直接传给 AI API
prompt = "用户说：#{comment.body}"
```
建议：对用户输入进行清理和转义
### ✅ 良好实践
- 使用了事务处理
- 添加了索引
- 有单元测试覆盖
需要我帮你修复这些问题吗？
4.4 /ship - 发布模式
设计目的
自动化同步、测试、推送、创建 PR 的流程。
使用场景
- 代码审查完成
- 准备合并到主分支
- 需要创建 PR
使用示例
你: /ship
Claude: 正在执行发布流程...
[1/6] 同步 main 分支...
git fetch origin main
git rebase origin/main
✅ 成功
[2/6] 运行测试...
bundle exec rspec
47 examples, 0 failures
✅ 通过
[3/6] 检查 Greptile 评论...
发现 2 条评论
- [已修复] N+1 查询问题
- [已处理] 竞态条件已添加锁
✅ 全部处理
[4/6] 推送分支...
git push origin feature/comments
✅ 成功
[5/6] 创建 Pull Request...
标题: feat: Add comment system with AI suggestions
✅ 创建成功
[6/6] 更新 PR 描述...
添加了变更摘要和测试说明
✅ 完成
┌─────────────────────────────────────────────┐
│ 🎉 发布完成！ │
│ │
│ PR: https://github.com/owner/repo/pull/42 │
│ 分支: feature/comments │
│ 变更: 8 files, +342/-56 │
└─────────────────────────────────────────────┘
4.5 /browse - 浏览器模式
设计目的
让 AI 拥有"眼睛"，能够浏览和测试 Web 应用。
使用场景
- 测试 UI 功能
- 验证部署
- 截图记录
- 检查控制台错误
使用示例
你: /browse https://staging.myapp.com
请测试登录流程，然后检查用户仪表板
Claude: [启动浏览器会话]
> browse goto https://staging.myapp.com
✅ 页面加载成功 (1.2s)
> browse snapshot
检测到登录表单：
- Email 输入框
- Password 输入框
- Submit 按钮
> browse fill @email "test@example.com"
> browse fill @password "testpass123"
> browse click @submit
✅ 登录成功，重定向到仪表板
> browse screenshot /tmp/dashboard.png
✅ 截图已保存
> browse console
控制台输出：
- [info] User authenticated: test@example.com
- [warn] Chart data loading slow (2.3s)
无错误 ✅
> browse goto /settings
> browse snapshot
设置页面正常加载
所有表单元素可交互 ✅
## 测试报告
| 页面 | 状态 | 耗时 | 控制台 |
|------|------|------|--------|
| 登录 | ✅ | 1.2s | 无错误 |
| 仪表板 | ✅ | 0.8s | 1 警告 |
| 设置 | ✅ | 0.5s | 无错误 |
建议优化：仪表板图表数据加载可以异步化
4.6 /qa - QA 模式
设计目的
测试应用、发现 Bug、自动修复、重新验证。
使用场景
- 功能实现完成后
- 发布前验证
- 回归测试
使用示例
你: /qa
Claude: 正在分析分支差异...
检测到 12 个文件变更：
- 3 个控制器
- 2 个视图
- 4 个服务
- 3 个测试
受影响路由：
- /comments
- /comments/:id
- /api/comments
[启动 QA 测试]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100%
## QA 报告
### 健康评分: 85/100
### 测试的路由
| 路由 | 状态 | 问题 |
|------|------|------|
| /comments | ✅ | 无 |
| /comments/:id | ⚠️ | 1 个中等 |
| /api/comments | ✅ | 无 |
### 发现的问题
🟡 中等: 评论详情页在移动端显示异常
- 位置: /comments/:id
- 描述: 嵌套评论超出屏幕宽度
- 影响: 移动端用户体验
需要我修复这个问题吗？
你: 是的，请修复
Claude: [修复中...]
> 编辑 app/views/comments/show.html.erb
> 添加响应式样式
> 提交: fix: responsive comment nesting on mobile
[重新验证]
> browse goto /comments/123
> resize 375x812 # iPhone 尺寸
> screenshot
✅ 修复成功
## 最终报告
健康评分: 95/100 (+10)
所有路由正常工作 ✅
修复已提交到当前分支
4.7 /retro - 复盘模式
设计目的
团队周度复盘，分析工作模式和成长机会。
使用场景
- 周末复盘
- 团队总结
- 个人成长追踪
使用示例
你: /retro
Claude: 正在分析本周的 Git 历史...
## 周度复盘 (3月11日 - 3月17日)
### 总览
| 指标 | 数值 |
|------|------|
| 提交数 | 47 |
| 贡献者 | 3 |
| 代码行数 | +3,200 / -560 |
| 测试比例 | 38% |
| PR 数量 | 12 |
| 活跃天数 | 5/7 |
### 你的本周
📊 **统计**
- 32 次提交
- +2,400 行代码
- 41% 测试覆盖率
- 峰值时段: 晚上 9-11 点
- 连续活跃: 47 天 🔥
🚀 **最大成就**
评论系统完整实现
- AI 回复建议
- 线程式讨论
- 作者互动标记
- 18 个单元测试
💪 **做得好的地方**
- 一次性完成完整功能
- 测试覆盖充分
- 代码审查及时响应
📈 **成长机会**
- 考虑在上午安排更多编码时间
- 可以尝试更小的 PR 粒度
### 团队成员
#### Alice
- 12 次提交，集中在 app/services/
- 每个 PR 都小于 200 行 ✨
- 机会: 测试比例 12%，建议提升
#### Bob
- 3 次提交
- 修复了仪表板的 N+1 查询
- 机会: 本周只活跃 1 天，需要了解是否阻塞
### 下周建议
1. 继续保持高测试覆盖率
2. 考虑代码评审会议
3. 关注 Bob 的工作状态
复盘快照已保存到 .context/retros/2026-03-17.json
五、实战案例
5.1 案例：电商网站购物车功能
完整示例：从规划到发布的工作流。
# ========== 第一步：产品规划 ==========
你: /plan-ceo-review
我想给电商网站添加购物车功能
Claude: 让我们重新思考...
用户真正想要的是什么？
- 临时保存想买的商品
- 比较价格和选项
- 方便结算
- 追踪价格变化
10 星购物车可能包括：
1. 智能推荐 - "经常一起购买"
2. 价格追踪 - 降价时通知
3. 库存预警 - 即将售罄提示
4. 多设备同步 - 手机加购，电脑结算
5. 分享购物车 - 给家人朋友看
你: 我们先实现基础功能：添加商品、修改数量、删除商品、结算
# ========== 第二步：技术规划 ==========
你: /plan-eng-review
Claude: 好的，设计技术方案...
## 架构
┌─────────────────────────────────────────────┐
│ ShoppingCart System │
├─────────────────────────────────────────────┤
│ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Cart │ │ Cart │ │ Order │ │
│ │ Service │───▶│ Item │───▶│ Service │ │
│ └─────────┘ └─────────┘ └─────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Redis │ │PostgreSQL│ │Payment │ │
│ │ Session │ │ Data │ │ Gateway │ │
│ └─────────┘ └─────────┘ └─────────┘ │
│ │
└─────────────────────────────────────────────┘
## API 设计
POST /api/cart/items # 添加商品
PUT /api/cart/items/:id # 修改数量
DELETE /api/cart/items/:id # 删除商品
POST /api/cart/checkout # 结算
## 数据模型
Cart:
- id: UUID
- user_id: UUID (nullable for guest)
- created_at: timestamp
- updated_at: timestamp
CartItem:
- id: UUID
- cart_id: UUID
- product_id: UUID
- quantity: integer
- price_at_add: decimal
## 边界条件
- 最大商品种类：50
- 单品最大数量：99
- 购物车有效期：30 天（登录用户）/ 7 天（游客）
# ========== 第三步：实现 ==========
你: [退出计划模式]
请实现购物车功能，按照上面的技术方案
Claude: [开始实现...]
创建文件：
- app/models/cart.rb
- app/models/cart_item.rb
- app/services/cart_service.rb
- app/controllers/api/cart_controller.rb
- ...
[实现完成]
# ========== 第四步：代码审查 ==========
你: /review
Claude: 正在审查...
## 发现的问题
🔴 严重:
1. 库存检查竞态条件 - 两个用户可能同时购买最后一件商品
2. 价格缓存过期 - 用户可能看到旧价格
🟡 中等:
3. 游客购物车迁移 - 登录时需要合并购物车
建议先修复严重问题
你: 请修复这些问题
Claude: [修复中...]
- 添加了库存锁
- 添加了价格刷新机制
- 实现了购物车合并
[修复完成]
# ========== 第五步：发布 ==========
你: /ship
Claude: [发布流程...]
✅ 同步 main
✅ 运行测试 (82 examples, 0 failures)
✅ 推送分支
✅ 创建 PR #43
PR: https://github.com/owner/shop/pull/43
# ========== 第六步：测试 ==========
你: /setup-browser-cookies staging.shop.com
/qa https://staging.shop.com
Claude: [QA 测试...]
## QA 报告
健康评分: 92/100
测试场景：
✅ 添加商品到购物车
✅ 修改数量
✅ 删除商品
✅ 结算流程
✅ 价格更新
所有功能正常！
# ========== 第七步：文档 ==========
你: /document-release
Claude: 正在更新文档...
更新的文件：
- README.md: 添加购物车功能说明
- API.md: 添加购物车 API 文档
- CHANGELOG.md: 记录本次变更
文档更新完成！
5.2 案例：使用 Conductor 并行开发
# 场景：同时处理多个任务
# 终端 1：运行 QA 测试
你: /qa https://staging.myapp.com
# 终端 2：审查 PR
你: /review
# 在另一个 PR 分支上
# 终端 3：开发新功能
你: 请实现用户通知功能
# 终端 4：浏览测试
你: /browse https://staging.myapp.com/new-feature
# 每个终端有独立的工作空间和浏览器实例
# 互不干扰，同时运行
六、进阶主题
6.1 自定义技能
创建自己的 GStack 技能：
# 创建自定义技能
mkdir -p ~/.claude/skills/my-custom
# 创建技能文件
cat > ~/.claude/skills/my-custom/custom-review.md << 'EOF'
# Custom Code Review
你是一个专注于安全性的代码审查员。
## 审查重点
1. SQL 注入
2. XSS 攻击
3. CSRF 保护
4. 敏感数据暴露
5. 认证和授权
## 输出格式
### 安全问题
- [严重程度] 问题描述
- 代码位置
- 修复建议
### 最佳实践建议
- ...
EOF
# 创建符号链接
ln -s ~/.claude/skills/my-custom/custom-review.md ~/.claude/skills/custom-review.md
6.2 项目级配置
为团队共享 GStack 配置：
# 复制到项目
cp -Rf ~/.claude/skills/gstack .claude/skills/gstack
rm -rf .claude/skills/gstack/.git
# 团队成员克隆项目后运行
cd .claude/skills/gstack && ./setup
项目级 CLAUDE.md：
## 项目 GStack 配置
本项目使用 GStack 工作流。
### 必须使用的技能
- 所有 PR 必须通过 `/review`
- 所有 UI 变更必须通过 `/qa`
### 禁止的操作
- 不要直接推送到 main
- 不要跳过测试
6.3 与 CI/CD 集成
# .github/workflows/ai-review.yml
name: AI Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run GStack Review
run: |
# 安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 运行审查
claude /review --ci-mode
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
6.4 Greptile 集成配置
# 1. 在 greptile.com 安装 GitHub 应用
# 2. GStack 自动读取 Greptile 评论
# 3. 误报历史记录在
~/.gstack/greptile-history.md
# 4. /retro 会追踪 Greptile 准确率
七、常见问题
Q1: 技能不显示怎么办？
# 重新运行安装脚本
cd ~/.claude/skills/gstack && ./setup
# 检查符号链接
ls -la ~/.claude/skills/ | grep -E "browse|qa|review"
# 如果缺失，手动创建
for skill in browse qa review ship retro; do
ln -sf ~/.claude/skills/gstack/${skill}.md ~/.claude/skills/${skill}.md
done
Q2: 浏览器二进制编译失败？
# 确保 Bun 已安装
bun --version
# 手动编译
cd ~/.claude/skills/gstack
bun install
bun run build
# 检查二进制
ls -la browse/dist/browse
Q3: Cookies 导入失败？
问题：macOS Keychain 阻止访问
解决：
1. 当系统提示时，点击"始终允许"
2. 或在系统偏好设置 > 安全性与隐私 > 隐私 > 完全磁盘访问
添加终端应用
Q4: 如何升级 GStack？
# 在 Claude Code 中运行
/gstack-upgrade
# 或手动升级
cd ~/.claude/skills/gstack
git pull
./setup
Q5: Windows 支持吗？
目前不支持 Windows，因为浏览器二进制
只支持 macOS 和 Linux。
替代方案：
1. 使用 WSL2 (Windows Subsystem for Linux)
2. 使用远程 Linux 服务器
Q6: 如何卸载？
在 Claude Code 中粘贴：
卸载 gstack: 运行以下命令
for s in browse plan-ceo-review plan-eng-review review ship retro qa qa-only setup-browser-cookies document-release; do
rm -f ~/.claude/skills/$s
done
rm -rf ~/.claude/skills/gstack
然后从 CLAUDE.md 中移除 gstack 配置
八、参考资料
官方资源
相关工具
社区
学习路线图
Week 1: 基础入门
├── Day 1: 安装 GStack，运行 Hello World
├── Day 2-3: 熟悉 /plan-ceo-review 和 /plan-eng-review
├── Day 4-5: 练习 /review 和 /ship
└── Day 6-7: 尝试 /browse 和 /qa
Week 2: 工作流整合
├── Day 1-2: 完整功能开发工作流
├── Day 3-4: 浏览器自动化测试
├── Day 5-6: 团队协作配置
└── Day 7: 周度复盘 /retro
Week 3: 进阶应用
├── Day 1-2: Conductor 并行会话
├── Day 3-4: Greptile 集成
├── Day 5-6: 自定义技能开发
└── Day 7: CI/CD 集成
Week 4: 精通
├── 优化个人工作流
├── 团队最佳实践
└── 持续改进
教程持续更新中，如有问题请在 GitHub 提 Issue