字
字节笔记本
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.md | v1/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 次来批准
date和git 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 许可证
社区链接
- GitHub 仓库: https://github.com/gsd-build/get-shit-done
- Discord: https://discord.gg/5JJgD5svVS
- X/Twitter: @gsd__foundation
- NPM: https://www.npmjs.com/package/get-shit-done-cc
分享: