关于 openspec-update
通过运行 `openspec update`,在 OpenSpec CLI 升级或工具选择变更后重新生成项目的 AI 工具配置文件。使用前需安装 CLI 并初始化项目。
主要功能
- 01重新生成 AI 工具配置文件
- 02支持强制更新
- 03可指定项目目录
- 04说明前置条件和验证步骤
适用场景
- 01CLI 升级后刷新配置
- 02更新缺失或过时的技能与命令
- 03应用变更后的工具选择
- 04为指定项目重新生成配置
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ full-stack-skills/ openspec-skills --skill openspec-update安装后在 Claude Code 中输入/openspec-update确认已加载。
附带文件agents/openai.yaml
详细介绍
OpenSpec 更新技能
升级 OpenSpec CLI 包后,运行 openspec update 以重新生成 AI 工具配置文件(技能、命令、规则)。这可确保项目使用最新的斜杠命令和技能说明。
适用时机
- 升级 OpenSpec CLI 后(
npm install -g @fission-ai/openspec@latest)。 - 斜杠命令或技能似乎已过时或缺失时。
- 更改工具选择后,想要刷新配置时。
前提条件
- 已安装 OpenSpec CLI(参见 openspec-install)。
- 已初始化项目,运行过
openspec init(参见 openspec-initial)。
工作流
-
先升级 CLI(如果尚未升级)
npm install -g @fission-ai/openspec@latest(或使用 pnpm/yarn/bun 对应命令)。
-
运行更新
openspec update— 重新生成 AI 工具配置文件。openspec update --force— 即使文件已是最新版本,也强制更新。openspec update ./my-project— 指定目标目录。
-
验证
- 检查
.claude/skills/、.cursor/rules/或其他工具目录是否已刷新。 - 如有需要,重启 AI 工具以加载新技能。
- 检查
输出
- 与新版 CLI 匹配的工具专属配置文件(技能、命令、规则)。
后续步骤
- 继续使用 openspec-new、openspec-explore 等完成工作流。
故障排查
- “openspec: command not found”:先使用 openspec-install。
- “Project not initialized”:先运行 openspec-initial(
openspec init)。 - 更新后未显示技能:重启 AI 工具(Claude Code、Cursor 等)以重新加载技能。
参考资料
评论
支持 Markdown