gsd-get-shit-done
gsd-get-shit-done 专栏系列文章
01 全景概览与核心理念
5 篇GSD 是什么：从 Context Rot 到 Meta-Prompting
深入解析 Get Shit Done (GSD) 项目的核心定位——一个轻量级且强大的元提示、上下文工程和规范驱动开发系统，以及它如何解决 Context Rot 这一 AI 编程中的根本问题。
仓库结构全景图
逐层拆解 GSD 仓库的目录结构，从 80+ 命令到 60+ 工作流、33 个 Agent、TypeScript SDK，构建完整的阅读路线图。
五大设计原则深度解析
深入解析 GSD 的五大核心设计原则：Fresh Context Per Agent、Thin Orchestrators、File-Based State、Absent=Enabled、Defense in Depth，每条原则的设计动机和工程实现。
多运行时支持与安装体系
解析 GSD 如何适配 Claude Code、OpenCode、Gemini CLI、Codex、Copilot、Cursor、Windsurf 等 14+ 个 AI 编程工具，以及 275KB 安装器的架构设计。
快速上手：第一条 GSD 命令
从零开始安装 GSD 并执行第一条 /gsd-new-project 命令的完整实战指南，涵盖安装、配置、命令执行和 .planning/ 目录初始化。
02 命令系统
7 篇命令系统架构
解析 GSD 80+ 命令的设计架构，包括 YAML frontmatter 规范、命令分类体系、命令文件结构模板，以及命令如何作为用户入口触发工作流。
项目生命周期命令（上）
深入解析 /gsd-new-project、/gsd-new-milestone、/gsd-new-workspace、/gsd-plant-seed 四个项目生命周期命令的设计与使用。
项目生命周期命令（下）
深入解析 /gsd-import、/gsd-map-codebase、/gsd-cleanup、/gsd-manager 四个项目生命周期命令的设计与使用。
规划类命令详解
深入解析 /gsd-plan-phase、/gsd-research-phase、/gsd-spec-phase、/gsd-ultraplan-phase、/gsd-spike、/gsd-sketch 等规划类命令的设计与使用。
执行与验证类命令
深入解析 /gsd-execute-phase、/gsd-verify-work、/gsd-do、/gsd-quick、/gsd-fast 等执行与验证类命令的设计与使用。
辅助与调试命令
深入解析 /gsd-discuss-phase、/gsd-debug、/gsd-help、/gsd-settings、/gsd-stats、/gsd-code-review 等辅助与调试命令的设计与使用。
命令设计模式与最佳实践
总结 GSD 命令系统的设计模式，包括命令文件结构模板、frontmatter 规范、提示词设计技巧、命令命名约定，以及如何编写高质量的自定义命令。
03 工作流编排层
9 篇工作流架构总览
解析 GSD 60+ 工作流的设计架构，包括工作流作为 Thin Orchestrator 的角色、编排逻辑、状态更新机制、渐进式披露和大小预算控制。
execute-phase 工作流深度解析
深度解析 GSD 最大的工作流 execute-phase.md（69KB），包括执行阶段的完整流程、任务分解策略、原子提交机制和 Wave 执行模型。
plan-phase 工作流深度解析
深度解析 GSD 第二大工作流 plan-phase.md（66KB），包括规划阶段的完整流程、需求分析、研究阶段、计划生成和 Chunked Planning 策略。
new-project 与初始化工作流
深度解析 new-project 工作流（44KB）的完整流程，包括 Dream Extraction、需求提取、项目结构初始化和 .planning/ 目录生成。
discuss-phase 与交互工作流
深入解析 discuss-phase 工作流的多模式支持（power/all/auto/chain/batch）、假设分析和头脑风暴机制。
quick 与 fast 工作流
解析 quick 和 fast 工作流的设计，包括最小规划+直接执行模式、紧急修复路径、速度 vs 质量的权衡策略。
验证与审计工作流
解析 verify-phase、audit-milestone、audit-uat、audit-fix 等验证与审计工作流的设计，以及质量门控在工作流中的集成。
代码审查与修复工作流
解析 code-review、code-review-fix、reapply-patches 等代码审查与修复工作流的设计，以及 diff 处理机制。
工作流设计模式总结
总结 GSD 工作流系统的设计模式，包括 Thin Orchestrator 模式、状态机设计、Agent 委托策略、工作流组合和渐进式披露机制。
04 Agent 系统
9 篇Agent 架构总览
解析 GSD 33 个专业 Agent 的设计架构，包括 Agent 定义格式、frontmatter 规范、工具权限、模型配置和 Agent 分类体系。
Planner 与 Plan-Checker
深入解析 GSD 最大的 Agent 定义 gsd-planner.md（46KB）和 gsd-plan-checker，包括规划 Agent 的需求分解、计划生成和验证机制。
Executor 与 Debugger
深入解析 gsd-executor.md（25KB）和 gsd-debugger.md（46KB），包括执行 Agent 的任务执行策略和调试 Agent 的会话管理。
Verifier 与 Code-Reviewer
深入解析 gsd-verifier.md（30KB）和 gsd-code-reviewer.md（15KB），包括验证 Agent 的审查标准和代码审查流程。
文档与研究 Agent
深入解析 gsd-doc-writer.md（38KB）、gsd-phase-researcher.md（33KB）和 gsd-ai-researcher.md 等文档与研究 Agent 的设计与协作。
代码修复与安全 Agent
深入解析 gsd-code-fixer.md（19KB）和 gsd-security-auditor.md，包括代码修复策略、安全检查流程和威胁模型分析。
UI 与假设分析 Agent
深入解析 gsd-ui-auditor.md、gsd-ui-researcher.md 和 gsd-assumptions-analyzer.md，包括 UI 审查标准、可访问性检查、响应式设计验证和假设验证机制。
其他 Agent 概览
解析 gsd-roadmapper、gsd-project-researcher、gsd-domain-researcher、gsd-pattern-mapper、gsd-intel-updater 等其他 Agent 的设计与职责。
自定义 Agent 开发实战
从零开始创建自定义 Agent 的完整实战指南，包括 frontmatter 模板、工具权限配置、模型选择策略和测试验证。
05 上下文工程
7 篇上下文工程总览
解析 GSD 最核心的创新——Context Engineering 的原理、上下文预算分配、@reference 机制和渐进式加载策略。
核心参考文档（上）
深入解析 checkpoints.md（31KB）、gates.md 和 planning-config.md（23KB）等核心参考文档的设计与作用。
核心参考文档（下）
深入解析 model-profiles.md、model-profile-resolution.md、verification-overrides.md 和 common-bug-patterns.md 等核心参考文档。
思考模型与策略参考
解析 thinking-models-*.md（5个文件）、tdd.md、questioning.md 和 thinking-partner.md 等思考模型与策略参考文档。
Git 集成与提交规范
解析 git-integration.md、git-planning-commit.md 中的分支策略、原子提交和工作树管理规范。
上下文模板与模式
解析 contexts/dev.md、research.md、review.md、continuation-format.md、revision-loop.md 和 scout-codebase.md 等上下文模板与模式。
参考文档编写最佳实践
总结如何编写高质量的 GSD 参考文档，包括知识组织策略、更新机制、版本管理和文档一致性检查。
06 SDK 运行时与钩子系统
9 篇SDK 架构总览
解析 GSD TypeScript SDK 的目录结构、模块划分、类型系统和 CLI Transport 设计。
Phase Runner 核心引擎
深度解析 phase-runner.ts（39KB），包括阶段执行流程、状态机设计和生命周期管理。
Plan Parser 与 Prompt Builder
解析 plan.json 的读取与验证、plan 结构体定义、动态 Prompt 构建原理，以及模板引擎的工作机制。
Context Engine 与截断策略
解析 context-engine.ts（6KB）和 context-truncation.ts（6KB），包括上下文组装和截断算法。
GSD Tools 与状态管理
解析 GSD Tools 注册机制、文件系统状态管理、查询层与事件流的工具集成。
查询层与事件流
解析 sdk/src/query/ 目录、event-stream.ts（14KB）、WebSocket Transport 和 CLI Transport 的设计。
钩子系统总览
详解 10 个钩子（prompt-guard、read-guard、workflow-guard、context-monitor、check-update 等）的设计与实现。
引擎层与安装器
解析 GSD 引擎层 core.cjs 的初始化流程、state.cjs 的状态管理机制，以及安装器的跨平台适配策略。
SDK 扩展开发指南
如何扩展 GSD SDK，包括添加新 Transport、自定义状态处理器和插件机制。
07 质量门控、测试与实战
9 篇质量门控体系
解析 Gates 四大类型（Confirm/Quality/Safety/Transition）、gate-prompts.md 和检查点机制。
测试架构总览：三层测试金字塔与 23 个测试文件全景
解析 GSD 三层测试金字塔（单元/集成/E2E）、23 个测试文件的组织结构、测试策略选择和覆盖率目标。
关键测试解析（上）：Plan Parser、State Machine、Agent Delegator
深入解读 Plan Parser、State Machine、Agent Delegator 的单元测试策略、边界条件覆盖和 Mock 设计。
关键测试解析（下）：Context Engine、Phase Runner、Hook System
深入解读 Context Engine 截断测试、Phase Runner 集成测试和 Hook System 生命周期测试。
安全体系：secret-audit、credential-gate 与防注入机制
解析 GSD 的安全防护体系：secret-audit 敏感信息审计、credential-gate 凭据门控和提示词注入防御机制。
漂移检测与 Schema 验证：配置一致性、文档同步与版本兼容性
解析 drift-detection、schema-drift、配置字段验证和文档一致性检查机制，确保配置、代码与文档三者同步。
实战：从零开始用 GSD 开发项目（上）
完整实战案例：从 new-project 到 research-phase 再到 plan-phase 的项目初始化与规划全流程。
实战：从零开始用 GSD 开发项目（下）
完整实战案例：execute-phase 任务调度、verify-work 质量验证和 audit-milestone 里程碑审计的完整流程。
总结与架构启示
GSD 设计哲学回顾、Meta-Prompting 最佳实践、Context Engineering 方法论和可借鉴模式总结。