ByteNoteByteNote

字节笔记本

2026年2月15日

GSD - Claude Code 元提示与上下文工程系统

API中转
¥120

一个轻量级但功能强大的元提示、上下文工程和规范驱动开发系统,专为 Claude Code、OpenCode 和 Gemini CLI 设计。解决上下文腐烂问题,即 Claude 上下文窗口填满时发生的质量下降。

项目简介

GSD (Get Shit Done) 是由独立开发者 TÂCHES 创建的开发工作流系统。作者自述:"我是一个独立开发者。我不写代码,Claude Code 来写。"

"复杂性在系统中,而不是在你的工作流中。幕后:上下文工程、XML 提示格式化、子代理编排、状态管理。你所看到的:几个简单有效的命令。"

核心特性

  • 解决上下文腐烂 — 防止 Claude 上下文窗口填满时的质量下降
  • 规范驱动开发 — 基于 PROJECT.md、REQUIREMENTS.md、ROADMAP.md 的完整工作流
  • 多智能体编排 — 研究、规划、执行、验证各阶段使用专用智能体
  • 波次并行执行 — 独立任务并行执行,依赖任务按波次顺序执行
  • 原子 Git 提交 — 每个任务独立提交,可追溯、可回滚

安装指南

快速安装

bash
npx get-shit-done-cc@latest

支持平台: Mac、Windows、Linux

非交互式安装

bash
# Claude Code
npx get-shit-done-cc --claude --global  # ~/.claude/
npx get-shit-done-cc --claude --local   # ./.claude/

# OpenCode
npx get-shit-done-cc --opencode --global

# Gemini CLI
npx get-shit-done-cc --gemini --global

# 全部运行时
npx get-shit-done-cc --all --global

核心工作流(6步循环)

步骤命令功能
1. 初始化/gsd:new-project [--auto]提问→研究→需求→路线图
2. 讨论阶段/gsd:discuss-phase [N] [--auto]捕获实现决策
3. 规划阶段/gsd:plan-phase [N] [--auto]研究+规划+验证
4. 执行阶段/gsd:execute-phase <N>并行波次执行
5. 验证工作/gsd:verify-work [N]人工验收测试
6. 里程碑管理/gsd:complete-milestone / /gsd:new-milestone归档/启动新版本

快速模式

bash
/gsd:quick

适用于不需要完整规划的临时任务 , bug 修复、小功能、配置变更等

上下文工程架构

核心文件系统

文件作用
PROJECT.md项目愿景,始终加载
research/生态知识(技术栈、特性、架构、陷阱)
REQUIREMENTS.mdv1/v2 需求,阶段可追溯
ROADMAP.md目标与完成状态
STATE.md决策、阻塞、位置,跨会话记忆
PLAN.md原子任务,XML 结构,验证步骤
SUMMARY.md发生内容、变更、提交历史
todos/捕获的想法和后续任务

XML 提示格式化示例

xml
<task type="auto">
  <name>Create login endpoint</name>
  <files>src/app/api/auth/login/route.ts</files>
  <action>
    Use jose for JWT (not jsonwebtoken - CommonJS issues).
    Validate credentials against users table.
    Return httpOnly cookie on success.
  </action>
  <verify>curl -X POST localhost:3000/api/auth/login returns 200 + Set-Cookie</verify>
  <done>Valid credentials return cookie, invalid return 401</done>
</task>

多智能体编排

阶段编排器职责智能体职责
研究协调、呈现发现4 个并行研究员调查技术栈、特性、架构、陷阱
规划验证、管理迭代规划器创建计划,检查器验证,循环直到通过
执行分组为波次、跟踪进度执行器并行实现,每个有全新 200k 上下文
验证呈现结果、路由下一步验证器检查代码库与目标,调试器诊断失败

波次执行模型

text
WAVE 1 (并行)    →   WAVE 2 (并行)   →   WAVE 3
┌─────────┐ ┌─────────┐    ┌─────────┐ ┌─────────┐    ┌─────────┐
│ Plan 01 │ │ Plan 02 │ →  │ Plan 03 │ │ Plan 04 │ →  │ Plan 05 │
│ User    │ │ Product │    │ Orders  │ │ Cart    │    │Checkout │
│ Model   │ │ Model   │    │ API     │ │ API     │    │   UI    │
└─────────┘ └─────────┘    └─────────┘ └─────────┘    └─────────┘

独立计划 → 同一波次 → 并行执行。依赖计划 → 后续波次 → 等待依赖完成。

完整命令参考

核心工作流

命令说明
/gsd:new-project [--auto]完整初始化
/gsd:discuss-phase [N] [--auto]阶段前讨论
/gsd:plan-phase [N] [--auto]阶段规划
/gsd:execute-phase <N>执行阶段
/gsd:verify-work [N]验证工作
/gsd:audit-milestone里程碑审计
/gsd:complete-milestone完成里程碑
/gsd:new-milestone [name]新里程碑

导航命令

命令说明
/gsd:progress当前位置与下一步
/gsd:help显示所有命令
/gsd:update更新 GSD
/gsd:join-discord加入社区

存量代码

命令说明
/gsd:map-codebase分析现有代码库

阶段管理

命令说明
/gsd:add-phase添加阶段
/gsd:insert-phase [N]插入紧急工作
/gsd:remove-phase [N]移除未来阶段
/gsd:list-phase-assumptions [N]查看 Claude 预期方法
/gsd:plan-milestone-gaps创建填补差距的阶段

会话管理

命令说明
/gsd:pause-work创建交接文档
/gsd:resume-work恢复上次会话

推荐配置

跳过权限模式(推荐)

bash
claude --dangerously-skip-permissions

这是 GSD 的预期使用方式,停止 50 次来批准 dategit commit 会破坏整个目的。

细粒度权限替代方案

创建 .claude/settings.json

json
{
  "permissions": {
    "allow": [
      "Bash(date:*)", "Bash(echo:*)", "Bash(cat:*)",
      "Bash(ls:*)", "Bash(mkdir:*)", "Bash(wc:*)",
      "Bash(head:*)", "Bash(tail:*)", "Bash(sort:*)",
      "Bash(grep:*)", "Bash(tr:*)",
      "Bash(git add:*)", "Bash(git commit:*)",
      "Bash(git status:*)", "Bash(git log:*)",
      "Bash(git diff:*)", "Bash(git tag:*)",
      "Read(*)", "Write(*)", "Edit(*)",
      "Glob(*)", "Grep(*)"
    ]
  }
}

设计原则

原则说明
模块化设计添加阶段、插入紧急工作、完成里程碑、调整计划而不重建一切
上下文保鲜每个计划在全新上下文窗口执行,200k 令牌纯用于实现
人机验证自动化验证检查代码存在和测试通过,但人工验证功能是否符合预期
可追溯性每个任务独立可回滚,Git bisect 精确定位失败任务

项目统计

  • ⭐ 14.5k stars
  • 🍴 1.4k forks
  • 📄 MIT 许可证

社区链接

分享: