get-shit-done 如何按运行时执行 --uninstall 彻底卸载并保留其他配置
【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-done
当你已经不再在某个 AI 运行时(Claude Code、OpenCode、Gemini CLI、Codex 等)里使用 get-shit-done(GSD),需要把它的命令、代理、hooks 从该运行时的配置目录中清理掉,但又不想动到运行时的其他设置时,GSD 的安装器提供了--uninstall模式。按运行时(runtime)逐一执行卸载命令后,GSD 会移除它安装的全部文件、hooks 注册和设置项,同时保留你运行时的其他配置。
--uninstall 的移除范围与保留范围
GSD 安装时会在运行时的settings.json中注册 hooks,并把命令、代理、skills 等文件写入对应目录。安装器同时写入gsd-file-manifest.json用于记录它安装过的文件,卸载模式正是基于这份清单做干净的移除(见 docs/ARCHITECTURE.md 中的 Installer 流程:Manifest tracking — Writesgsd-file-manifest.jsonfor clean uninstall与Uninstall mode —--uninstallremoves all GSD files, hooks, and settings)。
执行--uninstall后的效果,以 README.zh-CN.md 的卸载章节为准:
- 移除:所有 GSD 命令、代理、hooks 和设置(含
settings.json中注册的 GSD hook 条目); - 保留:你运行时的其他配置不受影响。
卸载是按运行时隔离的:--claude只卸载 Claude Code 面上的 GSD,--codex只处理 Codex 的 skills 与 TOML 配置。你同时给多个运行时装过 GSD 时,需要为每个运行时各执行一次卸载命令。
按运行时执行卸载命令
命令格式固定为:npx get-shit-done-cc --<运行时> --global|--local --uninstall。--global对应装在全局的 GSD(如~/.claude/),--local对应装在某个项目里的 GSD(如./.claude/)。下面只给出你实际安装过的运行时的命令即可,无需把全部运行时都跑一遍:
# 全局安装 npx get-shit-done-cc --claude --global --uninstall npx get-shit-done-cc --opencode --global --uninstall npx get-shit-done-cc --gemini --global --uninstall npx get-shit-done-cc --kilo --global --uninstall npx get-shit-done-cc --codex --global --uninstall npx get-shit-done-cc --copilot --global --uninstall npx get-shit-done-cc --cursor --global --uninstall npx get-shit-done-cc --antigravity --global --uninstall npx get-shit-done-cc --augment --global --uninstall npx get-shit-done-cc --trae --global --uninstall npx get-shit-done-cc --cline --global --uninstall # 本地安装(当前项目) npx get-shit-done-cc --claude --local --uninstall npx get-shit-done-cc --opencode --local --uninstall npx get-shit-done-cc --gemini --local --uninstall npx get-shit-done-cc --kilo --local --uninstall npx get-shit-done-cc --codex --local --uninstall npx get-shit-done-cc --copilot --local --uninstall npx get-shit-done-cc --cursor --local --uninstall npx get-shit-done-cc --antigravity --local --uninstall npx get-shit-done-cc --augment --local --uninstall npx get-shit-done-cc --trae --local --uninstall npx get-shit-done-cc --cline --local --uninstall注意--global/--local必须与你当初的安装范围一致:对全局安装的项目跑--local不会触及全局目录,反之亦然。在 Docker 或容器环境中使用波浪线路径(~/.claude/...)读取失败时,按 README.zh-CN.md 故障排查章节的说法,设置CLAUDE_CONFIG_DIR指向绝对路径后再执行,避免容器内~无法正确展开。
卸载后的验证方式
文档没有给出独立的“卸载成功”检查命令,但可以按 README.zh-CN.md 故障排查一节列出的安装位置反查,确认 GSD 文件已经不在:
- 重启对应运行时,让命令和 skills 重新加载——未卸载成功时 GSD 命令仍会出现,卸载成功后运行时中不再提供 GSD 命令。
- 检查文件位置:Claude Code 全局安装对应
~/.claude/commands/gsd/,本地安装对应./.claude/commands/gsd/;Codex 对应~/.codex/skills/gsd-*/SKILL.md(全局)或./.codex/skills/gsd-*/SKILL.md(本地)。卸载完成后,这些路径下不应再有 GSD 的命令或 SKILL 文件。 - 检查运行时自己的
settings.json中不再有 GSD 注册的 hook 条目,同时确认你原有的其他配置项仍在,对应“移除 GSD 相关项、保留其他配置”的预期效果。
边界说明
--uninstall只处理对应运行时的安装面,不会跨运行时批量清理;多运行时安装需要逐条执行。- 文档明确承诺的移除对象是 GSD 命令、代理、hooks 和设置,且保留其他配置;文档未提及对
.planning/等项目内数据的处理,卸载前如需保留项目规划数据,请先自行确认备份。 - 若卸载后发现 GSD 命令仍然存在,按故障排查章节的处理方式:重启运行时,或重新执行安装命令后再卸载,确保
gsd-file-manifest.json清单与当前文件状态一致。
【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-done
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考