GudaStudio Commands 收录了 GudaStudio 开发的 Claude Code 自定义命令集合。核心命令 gudaspec 实现了基于RPI(Research-Plan-Implementation)编码理论的完整流程,并融合openspec和多模型协作以让claued code更适用于复杂场景、长时间编码任务。同时,本项目引入了 以人为本 的操作理念,允许用户通过多阶段手动分割上下文,让claude code的有效上下文(约80K)被极致利用!完整功能请查看使用示例!

• Claude Code (v2.1.15+)
• Auggie MCP

git clone https://github.com/GuDaStudio/commands
cd commands

# 用户级安装(所有项目生效)
./install.sh --user
# 项目级安装(仅当前项目生效)
./install.sh --project
# 自定义路径
./install.sh --target /your/custom/path

# 用户级安装(所有项目生效)
.\install.ps1 -User
# 项目级安装(仅当前项目生效)
.\install.ps1 -Project
# 自定义路径
.\install.ps1 -Target C:\your\custom\path

启动 Claude Code 后输入 /gudaspec 即可查看可用命令。

在 ~/.claude/CLAUDE.md 中使用以下提示词。

# CLAUDE.md
## 0. Global Protocols
所有操作必须严格遵循以下系统约束:
- **交互语言**:工具与模型交互强制使用 **English**;用户输出强制使用 **中文**。
- **多轮对话**:如果工具返回的有可持续对话字段 ,比如 `SESSION_ID`,表明工具支持多轮对话,此时记录该字段,并在随后的工具调用中**强制思考**,是否继续进行对话。例如, Codex/Gemini有时会因工具调用中断会话,若没有得到需要的回复,则应继续对话。
- **沙箱安全**:严禁 Codex/Gemini 对文件系统进行写操作。所有代码获取必须请求 `unified diff patch` 格式。
- **代码主权**:外部模型生成的代码仅作为逻辑参考(Prototype),最终交付代码**必须经过重构**,确保无冗余、企业级标准。
- **风格定义**:整体代码风格**始终定位**为,精简高效、毫无冗余。该要求同样适用于注释与文档,且对于这两者,严格遵循**非必要不形成**的核心原则。
- **仅对需求做针对性改动**:严禁影响用户现有的其他功能。
- **上下文检索**: 调用 `mcp__auggie-mcp__codebase-retrieval`,必须减少search/find/grep的次数。
- **判断依据**:始终以项目代码、grok的搜索结果作为判断依据,严禁使用一般知识进行猜测,允许向用户表明自己的不确定性。在调用编程语言的非内置库时,必须启用grok搜索,以文档作为判断依据进行编码。例如,在调用fastapi库对api接口进行封装时,必须使用联网搜索的最新结果作为依据、阅读官方文档说明编写代码,严禁使用已知的一般知识进行直接编码,这样会直接造成用户项目的崩坏。
- **MUST** ultrathink in English.

本项目的核心观念是将有效的上下文专注于一件事,本节将会以 从零生成一个可视化天气页面 为例,带您感受本项目的独特魅力!😀

以下示例均使用claude opus 4.5进行,并强烈建议您开启推理模式以加强claude的指令服从能力!

0.1 进入项目,打开claude code,键入 /gudaspec:init,为该项目进行gudaspec初始化。

0.2 claude会为您自动安装openspec,并检测Codex-MCP 和 Gemini-MCP是否可用。

0.3 本阶段任务已完成,键入/clear,清空当前上下文并新开对话。

该阶段旨在根据项目的已有代码/掌握的初步信息,对用户的需求进行初步理解,并形成标准OpenSpec文档。

1.1 在新的会话窗口中输入以下内容:

/gudaspec:research
我需要生成一个美观的实时天气展示页面。要求:
 1. 实时天气信息必须为真实信息,包含温度、湿度等
 2. 用户可以选择北京、上海、深圳三个城市
 3. 四种不同的基础天气(大风、降雨、晴天、下雪),有不同的页面展示。
 4. UI设计极具美感,参考苹果公司的顶级前端设计。

claude会帮您自动调研并生成openspec格式的初步提案。

1.2 当您的需求中含有明显歧义时,claude会主动征求您的意见。

1.3 最终claude会为您生成初步的spec文档,此时只用了59.5K上下文,距离claude的最专注上下文长度80K还有不少距离。🥳

本阶段的任务是彻底消除用户需求中的不确定性,并生成可执行计划。同时为计划提供可验证属性。

2.1 在新的会话窗口中输入以下内容,claude会自动帮您找到待完成的需求。

/gudaspec:plan

2.2 claude会启动多模型(codex/gemini)协作,来对初步需求报告中的实现方案进行分析细化。

2.3 获取到多模型的分析方案后,claude会进一步细化需求,彻底消除技术上的模糊性。

2.4 在所有决策项完成后,claude会提取 Property-Based Testing 属性,供后续阶段验证使用。

2.5 直至计划方案变成后续可零决策顺序执行的pipeline,claude会生成完整的spec文档,该阶段任务完成,输入/clear,清空当前上下文,新开会话窗口。

本阶段的目标是执行具体的代码实现,直至完成用户需求。

3.1 在新会话窗口中,执行以下命令,claude会自动帮您识别待完成的需求提案。

/gudaspec:implementation

3.2 claude会自动识别最小可验证任务来进行逐步实现,以更好的帮助您控制上下文!

3.3 在完成一阶段任务后,claude会暂停询问您是否继续的意见,此时我们强烈建议您关注上下文窗口,若小于80k则可以继续下一阶段的实现;反之,可以输入/clear新开会话窗口,从3.1继续实现。

3.4 过程中,claude会自动启用多模型代码原型获取(前端/UI → Gemini | 后端/逻辑 → Codex),并在每完成一阶段任务后启用多模型review来保证代码可靠性。

3.5 成果展示。直至所有任务完成,我们就可以获得一个拥有真实数据的天气系统啦!😀(左侧为系统截图,右侧为中央气象台截图)

本项目采用 MIT License 开源协议。

Copyright (c) 2025 guda.studio