企业官网建设流程全解析

OpenSpec 怎么彻底卸载（全局包、项目目录与生成的工具文件）？

【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpec

如果你已经不再使用 OpenSpec，想把它从机器和项目里彻底清掉，需要处理的不只是一个 npm 包：OpenSpec 由一个全局安装的 CLI 包、每个项目里的openspec/目录，以及写入各 AI 工具目录的 skill / command 文件组成。安装文档明确说明：没有openspec uninstall命令，因为"OpenSpec 就是全局包加项目里的一些文件"，卸载是几个手动步骤，且全程不触碰你的源代码。本文按依赖顺序给出清理路径：先卸载还会用到 CLI 的 shell 补全，再删全局包，最后清理项目目录与生成的工具文件。

卸载前先看清 OpenSpec 留下了什么

对照 安装文档 和 Supported Tools，OpenSpec 在机器上会留下这几类东西：

1. 全局包：通过 npm / pnpm / yarn / bun 安装到全局 bin 目录的@fission-ai/openspec；
2. 项目目录：openspec/（含openspec/specs/、openspec/changes/archive/等）；
3. 生成的工具文件：各 AI 工具的 skills 目录（.../skills/openspec-*/SKILL.md）和 commands 文件（各工具不同的opsx-*路径）；
4. 提示文件中的 marker 块：写入CLAUDE.md、AGENTS.md等文件中的 OpenSpec marker blocks；
5. shell 补全（如你执行过openspec completion install）。

卸载顺序上，第 5 项必须在删全局包之前处理，因为它仍然要调用openspec命令。

第一步（可选）：先卸载 shell 补全

如果你给 bash / zsh / fish / powershell 安装过补全，先运行 CLI 参考中的卸载子命令：

openspec completion uninstall

Windows PowerShell 宿主下，文档给出的步骤是先指定当前宿主的 profile 再卸载，因为安装器往 profile 里加了受管理的加载块：

$env:PROFILE = $PROFILE openspec completion uninstall powershell

卸载补全后需要重启 PowerShell，才能从当前会话中清掉补全。补全是选装功能，如果你从没执行过openspec completion install，可以跳过这一步。

第二步：删除全局包

按你当初安装的包管理器执行对应命令（安装文档原文给出）：

npm uninstall -g @fission-ai/openspec # or: pnpm rm -g / yarn global remove / bun rm -g

注意用当初安装时用的那个包管理器来卸载，否则可能删不到对应的全局安装。

第三步：删除项目里的openspec/目录

这一步文档标注为可选。进入项目根目录后：

rm -rf openspec/

执行前文档给出了明确提醒：openspec/specs/和openspec/changes/archive/记录着"系统如何工作、为什么这样变更"的历史。如果你以后还可能想要这段历史，即使卸载 CLI 也建议保留该文件夹（或保留在 git 中）。这是一个不可逆操作，会删除该目录下的全部 specs 与 changes 记录。

第四步：删除生成的 AI 工具文件

OpenSpec 把 skill 和 command 文件写进了每个工具各自的目录，例如.claude/skills/openspec-*/、.cursor/commands/opsx-*。安装文档的口径是：删除你配置过的那些工具的openspec-*skills 和opsx-*commands，各工具的确切路径列在 Supported Tools 的 Tool Directory Reference 中。常用示例：

按你实际在openspec init --tools中配置的工具对照这张表删除。只删openspec-*命名的目录和opsx-*命名的文件，同一目录里你自己写的其他 skills/commands 不要动。

此外还有两处容易漏掉的残留，安装文档 和 迁移指南 都提到过：

• 家目录下的提示文件：旧版本 OpenSpec 会在家目录留下opsx-*.mdprompt 文件（Codex 放在~/.codex/prompts），如不再需要一并删除；
• marker 块：如果CLAUDE.md、AGENTS.md等文件里还有 OpenSpec marker blocks，需要手工把这些块删掉；这些文件里你自己的内容保留不动。

验证是否卸载干净

全局包删除后，重新运行安装文档用于验证的命令：

openspec --version

如果 shell 提示命令不存在，说明全局包已从 PATH 上移除。若它仍打印某个版本号，说明 PATH 上还有旧副本在遮蔽——安装文档的建议是把两个版本都找出来对比，而不是继续用旧的那份，找到后按对应方式删掉多余的副本。

再回到项目目录确认openspec/已不存在（如你选择删除）、各工具的openspec-*/opsx-*文件已清除，卸载即完成。

限制与提醒

• 整个过程不修改你的源代码；rm -rf openspec/只影响 OpenSpec 自己的目录。
• 文档未提供nix profile install路径的对应移除命令；如果你是通过 Nix profile 安装的，文档只覆盖了nix profile install github:Fission-AI/OpenSpec的安装方式，移除需按 Nix 自身的 profile 管理处理。
• 若某个项目还在用 OpenSpec 工作流，不要删它的openspec/目录；FAQ 对卸载的概括是：删掉包，然后按需删除openspec/目录和生成的工具文件。

【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpec