gstack 安装到cursor环境中
gstack 是 Garry Tan 发布的一个“偏执流程化”的 Claude Code 技能包:用明确的角色/阶段(例如规划、审查、发布、QA 等)把软件开发流程拆开,让代理按阶段工作,从而减少上下文腐化、提升交付稳定性。
当你说“安装到 Cursor 环境中”,通常有两层含义:
- Cursor 作为你的编辑器/代码管理工具(你仍然在 Cursor 里改代码)
- gstack 实际运行在 Claude Code(因为 gstack 官方就是为 Claude Code 的 slash commands / skills 设计的)
因此:本文给出的是“Cursor + gstack(Claude Code)共用同一项目目录”的落地做法。
参考: - gstack 官方仓库:https://github.com/garrytan/gstack - gstack 安装指南:https://gstacks.org/gstack-setup-install-guide.html
1. 准备条件
gstack 安装指南要求你准备:
- Claude Code(gstack 的运行时)
- Git
- Bun v1.0+(用于编译
/browse相关的浏览器能力)
Cursor 本身不提供 gstack 的安装方式;你需要的是让 Claude Code 装好 gstack,然后让 Claude Code 在你的项目目录里读取同一套代码。
2. 安装 gstack 到 Claude Code
按安装指南执行下面步骤(建议在本机上完成):
git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack
~/.claude/skills/gstack/setup
安装完成后,gstack 的 slash commands/技能应当在任意 Claude Code 会话中可用。
3. 验证是否安装成功
在 Claude Code 新开一个会话,直接输入:
/help
或尝试触发 gstack 的核心模式(例如 planning / review / ship 等)。如果你能看到相关命令/说明,说明 gstack 已就绪。
4. 在 Cursor 环境里使用 gstack:共用同一项目目录
目标是:Cursor 里编辑代码,Claude Code 里用 gstack 驱动你把阶段做完。
4.1 在 Cursor 里打开你的项目
确保 Cursor 打开的是你的项目根目录(例如有 src/、package.json、pyproject.toml 等)。
4.2 在 Claude Code 里对同一目录启动
让 Claude Code 进入同一个项目目录(同样的路径下运行)。
然后在 Claude Code 里直接用 gstack 命令组织工作(示例命令以官方技能为准):
/plan-ceo-review
/plan-eng-review
/review
/qa
/ship
4.3 工作方式建议
- 让 Cursor 负责:写/改代码、查看差异、确认文件结构
- 让 gstack + Claude Code 负责:按照阶段去“理解 - 决策 - 实现 - 验证 - 发布”
- 在一个阶段里把需求说清楚:输入要尽量具体,避免让代理在不同阶段混用上下文思考
5. “把 gstack 真正装进 Cursor skills”的可能性
你可能会想到:Cursor 有自己的 skills 机制(例如 OpenSkills 这类 SKILL.md 体系),那能不能把 gstack 直接作为 Cursor skills 来安装?
从目前公开资料看,gstack 的主要实现是面向 Claude Code 的 slash commands/skills 结构,因此不建议假设它已原生兼容 Cursor 的 skills 目录格式。
如果你确实想做“Cursor 原生技能”,通常需要:
- 找到 gstack 是否提供可转换的 SKILL.md/agent skills 形式
- 或者编写适配层,把 Claude Code 的阶段命令转为 Cursor 可加载的 skill
这部分实现是否存在、是否稳定,取决于具体仓库/适配层支持情况;建议你先采用本文的“Cursor + Claude Code 共用目录”方案,确保流程跑通再谈深度集成。
6. 常见问题
Q1:装完后 Claude Code 没出现 gstack 命令?
- 检查是否已完成
~/.claude/skills/gstack/setup - 确保你运行的是同一用户目录(
~/.claude/) - 重新启动 Claude Code 会话再试
Q2:Claude Code 和 Cursor 路径不一致怎么办?
- 最简单:让两者都在同一项目根目录运行
- 如果你用容器/远程开发,确保 Claude Code 运行环境能读到同一份代码目录
参考
- gstack 官方仓库:https://github.com/garrytan/gstack
- gstack 安装指南:https://gstacks.org/gstack-setup-install-guide.html