前言
YC前CEO Garry Tan最近开源了他的Claude Code完整配置方案 gstack,用23个精心设计的工具让Claude Code扮演CEO、设计师、工程经理、发布经理、文档工程师和QA六个角色。这套配置在GitHub上迅速获得数千星标,本文将带你从零开始搭建这套AI驱动开发工作流。
一、前置条件
- 已安装 Claude Code(
- npm install -g @anthropic-ai/claude-code
复制代码 )
- GitHub 账号(用于fork配置仓库)
- 基本的命令行操作能力
- 推荐:已配置好 Claude API Key
二、核心架构理解
Garry Tan的gstack核心理念是:把AI当作团队成员,而非代码补全工具。23个工具分为六大职能模块:
CEO — 产品决策与战略规划
Designer — UI/UX设计与原型
Eng Manager — 技术方案评审与任务分配
Release Manager — 版本发布与CI/CD
Doc Engineer — 文档维护与知识库
QA — 测试用例生成与质量把控
三、安装配置步骤
步骤1:克隆gstack仓库
打开终端,执行以下命令:
- # 克隆仓库
- git clone https://github.com/garrytan/gstack.git
- cd gstack
- # 查看目录结构
- ls -la
复制代码
你会看到类似这样的结构:
- gstack/
- ├── .claude/ # Claude Code 配置目录
- │ ├── commands/ # 自定义命令
- │ ├── tools/ # 23个工具定义
- │ └── system-prompt.md # 系统级提示词
- ├── templates/ # 项目模板
- ├── scripts/ # 辅助脚本
- └── README.md
复制代码
步骤2:配置Claude Code工具
将gstack的工具配置复制到Claude Code的配置目录:
- # 创建Claude Code配置目录(如果不存在)
- mkdir -p ~/.claude
- # 复制工具配置
- cp -r gstack/.claude/* ~/.claude/
- # 验证配置
- ls ~/.claude/tools/
复制代码
你应该能看到23个以结尾的工具定义文件,每个文件描述了一个AI角色的能力和使用场景。
步骤3:配置系统提示词
编辑- ~/.claude/system-prompt.md
复制代码 ,这是Claude Code每次启动时读取的核心配置:
- # 打开系统提示词文件
- nano ~/.claude/system-prompt.md
复制代码
文件内容大致如下(已简化):
- You are a senior full-stack developer working in a team of AI agents.
- Each agent has a specific role defined in the tools/ directory.
- When asked to perform a task:
- 1. First identify which role(s) are needed
- 2. Use the appropriate tool definitions
- 3. Follow the workflow described in each tool
- 4. Always write tests before implementation
- 5. Document your decisions in the project log
复制代码
你可以根据自己的项目需求修改这个提示词。
步骤4:测试工具调用
进入任意项目目录,启动Claude Code测试:
- # 进入你的项目
- cd your-project
- # 启动Claude Code
- claude
- # 在Claude Code中测试工具调用
- > 使用 CEO 工具分析这个项目的技术债务
复制代码
如果配置正确,Claude会加载CEO角色的工具定义,并以产品负责人的视角分析你的代码库。
步骤5:自定义工具(进阶)
以创建自定义的"代码审查工具"为例:
- # 创建新工具文件
- nano ~/.claude/tools/code-review.md
复制代码
写入以下内容:
- # Code Review Agent
- ## Role
- Senior code reviewer with 10+ years experience
- ## Capabilities
- - Review PRs for code quality
- - Check for security vulnerabilities
- - Verify test coverage
- - Suggest refactoring opportunities
- ## Workflow
- 1. Read the changed files
- 2. Check against project coding standards
- 3. Identify potential bugs
- 4. Suggest improvements
- 5. Output a structured review report
- ## Output Format
- ```
- ## Review Summary
- - Files reviewed: {count}
- - Issues found: {count}
- - Severity: {high|medium|low}
- ## Detailed Findings
- 1. [File:path] [Line: number] - [Issue description]
- ## Recommendations
- 1. [Specific actionable suggestion]
- ```
复制代码
保存后,Claude Code会自动识别这个新工具。
四、实战场景演示
场景1:新功能开发
- > 作为CEO,分析用户反馈并制定新功能优先级
- > 作为Designer,为新功能设计UI原型
- > 作为Eng Manager,制定技术实现方案
- > 实现功能并编写测试
- > 作为QA,运行测试并生成测试报告
复制代码
场景2:代码重构
- > 分析当前代码架构的问题
- > 制定重构计划(Eng Manager)
- > 执行重构
- > 运行完整测试套件(QA)
- > 更新文档(Doc Engineer)
复制代码
五、常见问题
Q1:Claude Code提示找不到工具?
检查目录是否存在,以及文件扩展名是否为。Claude Code只识别文件作为工具定义。
Q2:如何禁用某个角色?
临时禁用:将对应的工具文件重命名,例如永久禁用:删除该工具文件或移动到备份目录
Q3:工具之间的调用顺序可以自定义吗?
可以。在中定义你的工作流规则。例如:
- When implementing a feature:
- 1. Always start with CEO analysis
- 2. Then Designer creates mockups
- 3. Eng Manager approves the approach
- 4. Only then start coding
- 5. QA must pass before marking complete
复制代码
Q4:这套配置适合小团队吗?
非常适合!实际上,小团队最能感受到AI代理的价值——你相当于免费获得了6个专职团队成员。建议从3-4个核心工具开始,逐步扩展。
Q5:与Cursor、GitHub Copilot相比有什么优势?
- 角色分离:每个AI角色有明确的职责边界
- 工作流驱动:不是简单的代码补全,而是完整的工作流
- 可定制:23个工具都可以根据团队需求调整
- 开源:完全免费,社区持续贡献新工具
六、总结
gstack代表了AI辅助开发的下一个阶段——从"代码补全"进化到"团队协作"。通过23个精心设计的工具,你可以让Claude Code真正成为你的虚拟团队成员。
关键要点:
- 先理解六大角色的分工,再开始使用
- 从核心工具开始,逐步扩展
- 根据项目需求自定义工具定义
- 定期回顾和优化系统提示词
- 结合Git工作流使用效果更佳
相关链接:
- gstack GitHub仓库:https://github.com/garrytan/gstack
- Claude Code官方文档:https://docs.anthropic.com/claude-code
- Claude Code安装指南:https://www.npmjs.com/package/@anthropic-ai/claude-code
互动话题: 你目前在用什么AI编程工具?有没有尝试过让AI扮演不同角色?欢迎在评论区分享你的经验! |