Claude Code 装上这个 Skill，跨周不丢上下文——GSD Pi 把 spec 驱动开发塞进 CLI

Claude Code 装上这个 Skill，跨周不丢上下文——GSD Pi 把 spec 驱动开发塞进 CLI

如果你之前用 Claude Code 做长期项目，最大的痛点是什么？

我赌一句话——第三天上下文就断了。session 一长，agent 就开始忘了你最初的需求是啥，做着做着跑偏，最后不得不重启开新会话，前面的累积全废。这种「长期上下文失忆」问题，本质上是 AI Agent 没有「外置大脑」。

今天推荐的 GSD Pi（@opengsd/gsd-pi）正是为了解决这个。它的全名是 Get Shit Done Pi，是 open-gsd 组织继 gsd-build/gsd-2 之后的主力项目，v1.15.0 已经稳定发布，GitHub 上一夜之间攒下 1K+ stars。它把「meta-prompting + context engineering + spec-driven development」三件套压缩成一条命令。

它到底干了啥

GSD Pi 不是一个普通的「让 Claude 写代码」Skill。它是一套本地优先的编码 Agent 工作台，核心思路是把项目的「需求 / 决策 / 计划 / 验证证据」全部写到 .gsd/ 目录里，让 agent 每次开工前先读 spec，再开工——相当于给 AI 配了一份「项目记忆库」。

具体来看几个亮点：

• 规划即代码：用 gsd 命令开启 guided terminal agent，先 config provider，再跑 planned 模式，把大目标拆成 milestones → slices → tasks，auto 模式下一路 plan / implement / verify / advance。
• Worktree-aware Git 自动化：实现分支和工作区隔离，主 checkout 始终保持可 review 状态——再也不用担心 agent 改坏主线。
• 多 Provider 路由：默认是终端 TUI，加 --web 直接起可视化控制面板。模型可以用 Anthropic API、OAuth provider，甚至外接 Claude Code、Cursor Agent 本身的 CLI。
• 本地项目记忆：requirements / decisions / runtime notes / generated plans / summaries / validation evidence 全部落盘到 .gsd/，跨 session 不丢。
• 可扩展：支持添加自定义 commands / tools / skills / UI integrations，社区已经有 Rokket-GSD 这种 VS Code 插件对接。

怎么装

一条命令搞定：

npx @opengsd/gsd-pi@latest

老用户升级前要先清旧的 unscoped 包：

npm uninstall -g gsd-pi @opengsd/gsd-pi
npx @opengsd/gsd-pi@latest

日常升级直接 gsd upgrade。Windows 用 PowerShell 走同套命令，CI 脚本加 --yes。

适合谁

• 独立开发者 / 小团队：一人顶三人的节奏，跨周跨月项目不会失忆。
• AI 重度用户：Claude Code / Cursor 用户想让 agent 不再「写完就忘」。
• spec-driven 拥护者：写需求文档麻烦？让 GSD Pi 自动从对话生成 spec。

写在最后

如果说 obra/superpowers 解决了「Claude Code 的工程方法论」（TDD、调试、code review 套路），那 GSD Pi 解决的就是「长会话的项目级大脑」。两者互补：前者告诉你「怎么写代码好」，后者保证「写的是同一件事」。

免费、MIT license、本地优先——这种项目不薅真的亏。

GitHub 地址：https://github.com/open-gsd/gsd-pi

GitHub: https://github.com/open-gsd/gsd-pi