@opengsd/gsd-core

规格驱动(Spec-driven)与上下文工程框架,用五步阶段循环和干净上下文并行执行器对抗长对话退化。

安装命令
npx @opengsd/gsd-core@latest
挂接事件钩子与注册入口
session_startresources_discoverbefore_provider_requestbefore_agent_startsession_before_compacttool_call / tool_result
pi.registerTool()(gsd_invoke / gsd_dispatch)pi.registerCommand("gsd")配套 CLI 工作流命令 /gsd-new-project / /gsd-onboard

1. 是什么

@opengsd/gsd-core(Get Shit Done Core)是一套跨多款编码 Agent 运行时的元提示、上下文工程与规格驱动开发系统。

它在包内提供了完整的 Pi 扩展入口(./pi/gsd.cjs)以及 gsd-core、gsd_run、gsd-mcp-server 等配套命令行工具。

2. 解决什么问题

随着长会话里对话与工具输出不断累积,模型表现会逐渐出现“上下文腐烂(context rot)”:忘记早期定下的设计决策、遗漏验收要求、越改越乱。

GSD Core 把研究、规划与波次执行全部分发到干净上下文的子代理里运行,主会话只保留轻量调度和阶段产物路径。

3. 作用原理(事件钩子与工具注册层)

以 Discuss → Plan → Execute → Verify → Ship 五步里程碑循环为骨架,通过 Pi 钩子在压缩前保活关键状态并派发干净子会话执行。

  • 通过 /gsd-new-project(新项目)或 /gsd-onboard(已有仓库)初始化阶段规划目录;每个阶段首先经过 Discuss 锁定实施决策并落盘规格,再在 Plan 阶段拆分出可装进干净窗口的执行计划。
  • Execute 阶段借助 gsd_dispatch / gsd_invoke 把相互独立的子任务按并行波次(waves)派发,每个执行器都从全新的干净上下文启动,避免受先前调研噪音影响。
  • extension 在 session_before_compact 与 before_agent_start 保障阶段状态在压缩后不丢失;Execute 完成后进入 Verify 对照实际代码诊断修复,最终在 Ship 阶段建 PR 并归档里程碑。

4. 怎么装与基本配置

  • 官方明确建议使用交互式安装命令 npx @opengsd/gsd-core@latest,按提示选择 Pi 运行时及安装范围(全局或当前项目),不要手动直接拷贝内部 agents/ 或 commands/ 文件。
  • 安装完成后可在新建项目中使用 /gsd-new-project,或在现有仓库中运行 /gsd-onboard 快速建档。

5. 和同类怎么选

在工作流与目标驱动方向中,GSD Core 是流程最严谨、文档与阶段状态机最完备的规格驱动框架。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
pi-goal-x pi-goal-x 围绕交互式目标清单和独立完成审计员运转,不需要预先建完整规格目录与五阶段仪式。 单人或中小型需求想让 Agent 自动续跑并做最终验收选 pi-goal-x;中大型复杂工程需要严谨需求讨论、并行波次拆解选 @opengsd/gsd-core。
@quintinshaw/pi-dynamic-workflows(方向 02) dynamic-workflows 让模型针对单次任务现场写 JS 扇出脚本;GSD 围绕持久化的项目里程碑文件推进。 一次性并行扫描研究选 dynamic-workflows;持续数天按阶段推进版本研发选 @opengsd/gsd-core。

同方向对比包与顺序阅读

@dietrichgebert/ponytail

约束编码 Agent 少写冗余代码的资深工作流扩展:压缩代码体积、控制 token 消耗并守住高风险逻辑测试率。

阅读该包机制详评

pi-goal-x

为 Pi 带来 /goal 与 /sisyphus 目标循环:持久化拆解子任务、跨会话断点续跑,并可选独立完成审计员验收。

阅读该包机制详评

08 工作流与目标驱动

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「@opengsd/gsd-core」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)