GSD 不是脚手架，而是一套给 AI 编程工具用的规格驱动工作流。它的目标很明确：把长任务拆成多个短上下文，降低 context rot，让规划、执行、验证都可追踪。

GSD 解决什么问题

典型 AI 编程失效路径是：

• 一个会话里同时做需求澄清、方案设计、编码、验收
• 上下文越滚越大，后半段质量下降
• 计划过大，执行不可验证
• 写完代码，但没有可靠验收闭环

GSD 的做法是把流程拆成阶段，并把状态落盘到 .planning/。核心文件包括：

• PROJECT.md
• REQUIREMENTS.md
• ROADMAP.md
• STATE.md
• config.json
• phases/

适合需要跨会话推进、分阶段交付、保留验收记录的项目。

支持的运行时

• Claude Code
• Codex
• Gemini CLI
• OpenCode

命令前缀不同：

• Claude Code / Gemini: /gsd:help
• OpenCode: /gsd-help
• Codex: $gsd-help

安装

最简单的方式：

npx get-shit-done-cc@latest

非交互安装：

npx get-shit-done-cc --claude --global
npx get-shit-done-cc --codex --global
npx get-shit-done-cc --gemini --global
npx get-shit-done-cc --opencode --global

只装当前项目，把 --global 换成 --local。

安装完成后验证：

# Claude Code / Gemini
/gsd:help

# OpenCode
/gsd-help

# Codex
$gsd-help

标准工作流

完整链路如下：

/gsd:new-project
/clear
/gsd:discuss-phase 1
/gsd:ui-phase 1
/gsd:plan-phase 1
/gsd:execute-phase 1
/gsd:verify-work 1
/gsd:ui-review 1

非前端阶段可跳过 ui-phase 和 ui-review。

工作流流程图

flowchart TD
    A["/gsd:new-project
初始化项目上下文"] --> B["/gsd:discuss-phase N
锁定实现偏好"]
    B --> C{"是否包含前端/UI?"}
    C -->|是| D["/gsd:ui-phase N
生成 UI-SPEC"]
    C -->|否| E["/gsd:plan-phase N
研究 + 规划 + 校验"]
    D --> E
    E --> F["/gsd:execute-phase N
按 wave 执行计划"]
    F --> G["/gsd:verify-work N
人工验收"]
    G --> H{"验收是否通过?"}
    H -->|否| I["生成修复计划"]
    I --> F
    H -->|是| J{"是否还有下一阶段?"}
    J -->|是| B
    J -->|否| K["/gsd:audit-milestone"]
    K --> L["/gsd:complete-milestone"]

核心命令表

补充命令表

阶段职责表

Demo 1：新建 Todo Web App

目标：

• Next.js + TypeScript + SQLite
• 单用户
• 支持新增、完成、删除

执行顺序：

/gsd:new-project
/gsd:discuss-phase 1
/gsd:ui-phase 1
/gsd:plan-phase 1
/gsd:execute-phase 1
/gsd:verify-work 1

new-project 输入示例：

做一个 Todo Web App。
技术栈是 Next.js + TypeScript + SQLite。
第一版不做登录，只做单用户。
目标是完成增删改查闭环，移动端可用。

discuss-phase 1 输入示例：

页面保持高信息密度，不做营销风格设计。
列表项支持快速完成和删除。
空状态必须给明确操作提示。
移动端点击区域要足够大。

plan-phase 1 之后检查：

• 每个 plan 范围足够小
• 每个 plan 都有明确 verify 步骤

verify-work 1 检查项：

1. 新建待办是否成功
2. 状态切换是否即时生效
3. 删除是否可恢复或至少行为一致
4. 刷新后数据是否存在
5. 移动端交互是否误触

Demo 2：在现有项目中追加功能

/gsd:map-codebase
/gsd:new-project
/gsd:discuss-phase 1
/gsd:plan-phase 1
/gsd:execute-phase 1
/gsd:verify-work 1

map-codebase 会生成：

• STACK.md
• ARCHITECTURE.md
• STRUCTURE.md
• CONVENTIONS.md
• TESTING.md
• INTEGRATIONS.md
• CONCERNS.md

后续规划会直接基于现有结构。

小需求可直接用：

/gsd:quick

例如：

为博客新增文章搜索页，支持标题和摘要匹配，保持现有站点风格。

适用场景：

• 小功能
• bug 修复
• 配置改动
• 一次性维护任务

最值得先掌握的命令

• /gsd:help
• /gsd:new-project
• /gsd:discuss-phase
• /gsd:plan-phase
• /gsd:execute-phase
• /gsd:verify-work
• /gsd:map-codebase
• /gsd:quick

命令体系思维导图

mindmap
  root((GSD))
    初始化
      /gsd:new-project
      /gsd:map-codebase
    阶段推进
      /gsd:discuss-phase
      /gsd:ui-phase
      /gsd:plan-phase
      /gsd:execute-phase
      /gsd:verify-work
      /gsd:ui-review
    导航恢复
      /gsd:progress
      /gsd:resume-work
      /gsd:pause-work
    快速任务
      /gsd:quick
    路线图调整
      /gsd:add-phase
      /gsd:insert-phase
      /gsd:remove-phase
    配置
      /gsd:settings
      /gsd:set-profile
    收尾发布
      /gsd:audit-milestone
      /gsd:complete-milestone

配置建议

配置文件是 .planning/config.json。

mode

• interactive: 默认，适合大多数项目
• yolo: 自动化更强，适合熟练用户

granularity

• coarse
• standard
• fine

阶段越复杂，越适合 fine。

model_profile

• quality
• balanced
• budget
• inherit

建议：

• 原型期：budget
• 常规开发：balanced
• 关键阶段：quality

workflow 开关

• workflow.research
• workflow.plan_check
• workflow.verifier
• workflow.nyquist_validation
• workflow.ui_phase
• workflow.ui_safety_gate

不熟悉领域时，建议保持默认；只做快速原型时再酌情关闭。

典型误区

跳过 discuss-phase

常见结果不是功能错误，而是实现风格偏离预期。AI 会用默认判断填满灰区。

phase 切太大

如果一个阶段同时覆盖数据库、API、前端、权限、测试、部署，plan 往往会失真。GSD 不是拿来吞掉模糊范围的。

不做 verify-work

测试通过不等于功能完成。尤其是交互、空状态、错误流程、移动端兼容这类问题，必须人工验收。

老项目不跑 map-codebase

这会增加“风格不一致”和“破坏现有结构”的概率。

结论

GSD 的价值在于把 AI 编程从单轮 prompt 提升为阶段化工作流，更适合多阶段任务和持续交付。

如果你的项目已经开始出现需求拆分、阶段推进、跨会话恢复、验收闭环这些问题，GSD 值得直接上手。

之前介绍了如何配置 Clawdbot 使用国内 Minimax，今天分享如何为 Clawdbot 安装 R2 Upload Skill，实现图片/文件上传到 Cloudflare R2 并生成公开访问链接。

背景

Clawdbot 本身没有内置的文件上传功能，但通过安装 R2 Upload Skill，可以轻松实现：

• 📤 上传文件到 Cloudflare R2 或 S3 兼容存储
• 🔗 生成短期有效的预签名下载链接
• 🌐 支持自定义域名访问
• 📦 多 Bucket 配置

环境准备

在开始之前，你需要准备：

1. Cloudflare R2 账号
2. 已创建的 R2 Bucket
3. R2 API Token（包含 Access Key ID 和 Secret Access Key）
4. Clawdbot 已安装（本文假设已安装）

安装步骤

步骤一：下载 Skill

R2 Upload Skill 托管在 ClawdHub，通过以下地址下载：

https://auth.clawdhub.com/api/v1/download?slug=r2-upload

下载后会得到一个 zip 文件。

步骤二：解压并安装到全局

将 Skill 安装到 Clawdbot 全局技能目录：

# 解压
unzip r2-upload.zip -d /tmp/r2-upload-extract

# 安装到全局 skills 目录
cp -r /tmp/r2-upload-extract ~/.clawdbot/skills/r2-upload

# 安装依赖
cd ~/.clawdbot/skills/r2-upload
npm install

步骤三：配置 R2 凭证

创建配置文件 ~/.r2-upload.yml：

# R2 Upload Configuration

default: your-bucket-name

buckets:
  your-bucket-name:
    endpoint: https://YOUR_ACCOUNT_ID.r2.cloudflarestorage.com
    access_key_id: YOUR_ACCESS_KEY_ID
    secret_access_key: YOUR_SECRET_ACCESS_KEY
    bucket_name: your-bucket-name
    public_url: https://your-custom-domain.com
    region: auto

配置说明：

步骤四：重启 Clawdbot

使 Skill 生效：

clawdbot gateway restart

使用方法

通过 Clawdbot 对话

在 Clawdbot 对话中直接使用：

上传这张图片到 R2

或指定参数：

上传 /path/to/file.jpg 到 R2，有效期 24 小时

可用工具

R2 Upload Skill 提供以下工具：

上传示例

# 上传文件
r2-upload /path/to/file.pdf

# 指定自定义路径
r2-upload /path/to/file.pdf --key uploads/2026/report.pdf

# 指定 Bucket
r2-upload /path/to/file.pdf --bucket my-bucket

# 自定义有效期（默认 5 分钟）
r2-upload /path/to/file.pdf --expires 24h
r2-upload /path/to/file.pdf --expires 1d
r2-upload /path/to/file.png --expires 300  # 秒

# 生成公开链接（无需签名）
r2-upload /path/to/file.png --public

R2 配置详解

获取 R2 Endpoint

1. 登录 Cloudflare Dashboard
2. 进入 R2 → 你的 Bucket
3. 查看 "S3 API" 部分，获取 Endpoint 地址

格式：https://<ACCOUNT_ID>.r2.cloudflarestorage.com

创建 API Token

1. 进入 https://dash.cloudflare.com/<ACCOUNT_ID>/r2/api-tokens
2. 创建新 Token：
   • 应用到特定 Bucket
   • 权限：Object Read & Write
3. 复制 Access Key ID 和 Secret Access Key

自定义域名配置（可选）

如果你有自定义域名（如 oss.example.com）：

1. 在 Cloudflare DNS 中添加 CNAME 记录
2. 在 R2 设置中绑定自定义域名
3. 在配置文件中设置 public_url

常见问题

Q: 上传后链接打不开？

检查：

1. 预签名链接是否过期（默认 5 分钟）
2. Bucket 是否设置为公开访问
3. 自定义域名是否正确配置

Q: 如何修改默认有效期？

在配置文件或环境变量中设置：

# ~/.r2-upload.yml
default_expires: 3600  # 1 小时

或使用环境变量：

export R2_DEFAULT_EXPIRES=3600

Q: 可以上传到多个 Bucket 吗？

可以，在配置文件中定义多个 Bucket：

default: blog

buckets:
  blog:
    endpoint: https://blog.r2.cloudflarestorage.com
    # ... 其他配置
    
  assets:
    endpoint: https://assets.r2.cloudflarestorage.com
    # ... 其他配置

上传时指定 Bucket：

上传图片到 assets bucket

总结

通过以上步骤，你已经成功为 Clawdbot 安装了 R2 Upload Skill。现在可以轻松上传文件并生成分享链接了。

相比传统的文件上传方式，R2 + Clawdbot 的组合具有以下优势：

• ✅ 零服务器成本（R2 只收存储和流量费）
• ✅ 全球 CDN 加速
• ✅ 自动生成短期有效链接
• ✅ 安全可控的访问权限
• ✅ 支持自定义域名

如果你正在使用 Clawdbot 进行 AI 开发，R2 Upload Skill 是一个非常实用的工具。

参考链接：

• Clawdbot 官方文档
• R2 官方文档
• ClawdHub

标签： Clawdbot, R2, Cloudflare, 存储, 教程