@opengsd/gsd-core
规格驱动(Spec-driven)与上下文工程框架,用五步阶段循环和干净上下文并行执行器对抗长对话退化。
npx @opengsd/gsd-core@latest 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。 |
看完「@opengsd/gsd-core」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。