gstack (Claude Code角色工具集)
项目能做什么
使用说明 查看原始 README 原仓库文档
项目简介
gstack 是由 Y Combinator 总裁兼 CEO Garry Tan 开源的 Claude Code 工具套件(采用 MIT 协议)。它将 Claude Code 及其他 coding agent 转化为一个由 23 个专用工具组成的“虚拟工程团队”,包含产品 CEO、架构工程主管、设计审核、代码审查员、QA 主管、安全官和发布工程师等角色。所有功能均通过斜杠命令(slash commands)和纯 Markdown 驱动,为独立开发者提供完整的工程团队协作体验。
核心功能
- 全角色工程团队支持:通过 23 个专项工具分工协作,涵盖产品重构、架构敲定、设计防 AI 糊化(AI slop)、代码审查、OWASP + STRIDE 安全审计及 PR 发布。
- 捕获 CI 遗漏的缺陷:在部署前找出能够跑通测试用例、但在生产环境下会崩溃的隐蔽 Bug。
- 真实浏览器驱动的 QA 测试:
/qa命令支持对 staging 环境、本地 API、CLI、任务或 Webhook 进行自动化测试,可启动真实浏览器复现并修复缺陷。 - 快捷流程命令:
/office-hours:梳理产品逻辑并撰写设计文档供后续流程读取。/review:审查当前改动分支,拦截生产缺陷并自动修复明显问题。/autoplan:端到端审查完整开发计划。/ship:一体化执行测试、代码审查并提交 PR。/cso:运行 OWASP + STRIDE 安全合规审查(需本地编译工具链)。/browse、/make-pdf、/diagram:提供网页浏览与文档图表生成能力。
适合谁用
- 创始人与 CEO:特别是仍希望亲自写代码、交付产品的技术型创始人。
- Claude Code 初学者:无需面对空白 prompt,通过现成的结构化角色辅助开发。
- Tech Lead 与 Staff 工程师:为每个 PR 提供更严格的 Review、QA 和自动化发布流程。
安装步骤
环境要求:
- Claude Code 与 Git
- Bun v1.4.2+(最低要求 v1.3.3,低于该版本 setup 脚本会拒绝安装,防止编译工具读取项目中的 .env)
- Windows 系统需额外安装 Node.js
- macOS 推荐(macOS 15+):推荐安装 Aside 浏览器,支持带真实登录状态的测试;未安装时 ./setup 会构建内置浏览器。
步骤 1:本机安装(约 30 秒)
打开 Claude Code,直接粘贴执行以下提示词,Claude 会自动完成安装:
Install gstack: run
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setupthen add a "gstack" section to CLAUDE.md that says to use the /browse skill from gstack for all web browsing and never use mcp__claude-in-chrome__* tools. Claude Code lists the installed skills itself, so the section needs no skill list. Then ask the user if they also want to add gstack to the current project so teammates get it.
步骤 2:配置团队模式(推荐)
在项目仓库内运行以下命令,设置仓库自动更新,团队成员可即开即用:
(cd ~/.claude/skills/gstack && ./setup --team) && ~/.claude/skills/gstack/bin/gstack-team-init required && git add .claude/ CLAUDE.md && git commit -m "require gstack for AI-assisted work"
配置说明
- CLAUDE.md:安装时需在项目的
CLAUDE.md中添加说明,指定使用 gstack 的/browse处理所有网页浏览,且禁止使用mcp__claude-in-chrome__*系列工具。 - 更新渠道(Update Channel):新安装默认跟随
stable(稳定发布)通道。如需调整,可运行: - 跟随最新合并:
~/.claude/skills/gstack/bin/gstack-config set update_channel main - 仅跟随发布版本:
~/.claude/skills/gstack/bin/gstack-config set update_channel stable - 其他详细配置参数:此部分原文未说明,请查看原仓库。
常见问题
- Q: 为什么必须用指定版本的 Bun?
A: 安装脚本强制校验 Bun 版本不低于 1.3.3,以避免旧版本 Bun 在编译工具时意外读取到项目的.env敏感文件。 - Q: 为什么
/cso命令不可用?
A:/cso依赖本地编译工具链(native toolchain),若环境中未检测到该工具链,安装程序会提示并在当前环境跳过此功能。 - 其他问题:此部分原文未详细列出,请查看原仓库文档。
原始 README 摘录(英文原文,节选前 3000 字符)
# gstack gstack turns Claude Code (and other coding agents) into a virtual engineering team: a CEO who rethinks the product, an eng manager who locks architecture, a designer who catches AI slop, a reviewer who finds production bugs, a QA lead who opens a real browser, a security officer who runs OWASP + STRIDE audits, and a release engineer who ships the PR. All slash commands, all Markdown, all free, MIT license. I'm [Garry Tan](https://x.com/garrytan), President & CEO of [Y Combinator](https://www.ycombinator.com/). This is the open source software factory I use every day, and I'm sharing it because these tools should be available to everyone. The story, the productivity numbers and how I run ten sprints at once are in [Why gstack](docs/why-gstack.md). Fork it. Improve it. Make it yours. And if you want to hate on free open source software — you're welcome to, but I'd rather you just try it first. **Who this is for:** - **Founders and CEOs** — especially technical ones who still want to ship - **First-time Claude Code users** — structured roles instead of a blank prompt - **Tech leads and staff engineers** — rigorous review, QA, and release automation on every PR ## What gstack is for - **A whole team's judgment for one builder.** Product, design, engineering, QA, security and release reviews, each from a specialist role. - **Catch what CI misses.** Find the bugs that pass tests but break in production, before they ship. - **AI-written changes you can trust.** Every change carries its tests, its review and the evidence for both, so you can merge without rereading every line. - **Free, open and portable.** MIT-licensed, and it runs on Claude Code and the other major coding agents. ## Quick start 1. Install gstack (two pastes, about 30 seconds of setup; see below). 2. Run `/office-hours` and describe what you're building. It pushes back on your framing and writes a design doc the other skills read. 3. Run `/review` on any branch with changes. It finds the bugs that pass CI but break in production, and fixes the obvious ones. 4. Run `/qa` on your staging URL, or on an isolated local API, CLI, job or webhook. It opens a real browser, reproduces bugs and fixes them. Stop there. You'll know if this is for you. When you want the whole sprint, `/autoplan` reviews a plan end to end and `/ship` runs tests, review and the PR. ## Install — about 30 seconds **Requirements:** [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Git](https://git-scm.com/), [Bun](https://bun.sh/) v1.4.2+ (the tested version; setup refuses Bun older than 1.3.3, which would let compiled tools read a project's `.env`), and [Node.js](https://nodejs.org/) on Windows. **Recommended on macOS:** the [Aside](https://aside.com) browser (macOS 15+), which the browser skills, `/make-pdf` and `/diagram` drive first with your real logged-in sessions; without it, `./setup` builds gstack's own bundled browser. `/cso` needs a native toolchain as well; setup says so and l阅读完整原文
商业机会分析 AI 生成
企业/团队版 Claude Code 研发管控与协同平台 (SaaS/On-Prem)
| 产品构想 | 基于 gstack 的理念,构建面向产研团队的集中式 Agent 流程管理后台,统一审计日志、团队专属 Prompts/Skills 库以及 CI/CD 自动门禁(如必须通过 /review 和 /cso 才允许合并)。 |
| 核心功能 | 集中化 Skill 配置分发、GitHub PR 自动触发审查与审计记录生成、团队安全/合规规则注入、多开发者 Agent 效能大盘分析。 |
| 目标用户 | 采用 AI Agent 研发的中小软件公司、需要规范 AI 提交质量的工程总监/Tech Lead。 |
| 难度/周期 | 高 · 2 - 3 个月 · 成本:中等(主要是云端服务器、多租户架构与企业级权限系统开发) |
| 收费模式 | 按团队席位收费(Per Seat B2B SaaS)或按企业私有化部署买断/年费服务。 |
| 竞争风险 | 销售周期较长,且高度依赖 Claude Code 官方开放接口与协议的稳定性。 |
| 依据 | 已验证事实 |
垂类定制化 Agent Skills 扩展市场与高阶模板包
| 产品构想 | 针对特定行业或技术栈(如 Web3 合约审计、出海金融合规、特定云原生架构优化),开发即插即用的高质量垂直领域 gstack 衍生角色包与私有规则集。 |
| 核心功能 | 定制化的行业专属 Slash Commands(如 /audit-web3、/gdpr-check)、开箱即用的专家提示词与本地分析脚本、持续更新的漏洞与规范规则库。 |
| 目标用户 | 细分技术领域的全栈/独立开发者、外包服务团队。 |
| 难度/周期 | 低 · 2 - 4 周 · 成本:低(主要为领域知识梳理与 Prompt/Script 编写测试) |
| 收费模式 | 数字资产销售(Gumroad / 独立站售卖)、赞助订阅或按年提供规则库更新订阅制。 |
| 竞争风险 | 开源社区模仿门槛低,容易被快速平替和传播(难以做版权保护)。 |
| 依据 | AI推测 |
云端无头 QA 与多 Agent 隔离沙箱服务 (Cloud Testing Runner)
| 产品构想 | 针对项目中 /qa、/browse 依赖真实浏览器及原生依赖(Bun, Aside, native toolchain)的繁琐配置痛点,提供云端沙箱 API/CLI,一键代理 Agent 的本地浏览器与编译执行过程。 |
| 核心功能 | 云端一键托管测试浏览器沙盒、跨平台免环境依赖代理运行、自动化测试截屏/录屏报告汇总、与 Claude Code 插件无缝桥接。 |
| 目标用户 | 不愿在本地搭建复杂环境的开发者、Windows 平台用户、频繁需要多环境并行 QA 的团队。 |
| 难度/周期 | 中等 · 1 - 2 个月 · 成本:中等(涉及无头浏览器集群、容器化运行资源成本) |
| 收费模式 | Usage-based 计费(按测试时长/并发沙箱数量订阅)。 |
| 竞争风险 | 云端测试资源并发成本较高,若定价过高开发者倾向于留在本地运行。 |
| 依据 | 尚需验证的假设 |
竞品与相似项目 GitHub Search 真实检索
| 项目 | 中文简介 | Stars | 语言 |
|---|---|---|---|
| huytieu/COG-second-brain | 中文介绍暂未生成 Self-evolving second brain with 35 AI skills, 10 agents, and |
1,410 | Python |
| rihebty/flow-kit | 中文介绍暂未生成 一套融合了bmad、spec-kit、OpenSpec、GSD、claude-task-master、superpowe |
413 | - |
| loperanger7/gstack-auto | 中文介绍暂未生成 Semi-Autonomous gstack Orchestration: Build with a strong pr |
262 | Python |
| garagon/nanostack | 中文介绍暂未生成 A workflow harness that helps AI coding agents plan, review, |
208 | Shell |
| no-session/pstack | 中文介绍暂未生成 The solo founder's AI engineering stack. Fork of gstack, reb |
154 | TypeScript |
| sumit-ai-ml/claude-md-starter | 中文介绍暂未生成 A CLAUDE.md built on Karpathy's principles and gstack, addin |
133 | - |
项目优势与风险
| 技术成熟度 | 创建于 ,最近推送 ,发布过 7 个 Release |
| 社区活跃 | Star 141,259 / Fork 0 / Issue 0(数据支持,可自行核实) |
| 许可证 | 未检测到(需人工确认) |
| 主要风险 | 上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价 |
安装与使用
git clone https://github.com/garrytan/gstack.git cd gstack # 请阅读仓库 README 获取确切安装步骤(依赖、配置、启动命令)