videoSummary/.cursor/commands/openspec-archive.md

name	id	category	description
/openspec-archive	openspec-archive	OpenSpec	Archive a deployed OpenSpec change and update specs.

约束条件

• 优先采用简单、最小化的实现，只有在明确要求或明显需要时才添加复杂性。
• 保持更改紧密围绕请求的结果。
• 如需更多 OpenSpec 约定或说明，请参考 openspec/AGENTS.md（位于 openspec/ 目录中——如果看不到，请运行 ls openspec 或 openspec update）。

步骤

1. 确定要归档的变更 ID：
   • 如果此提示已包含特定的变更 ID（例如在由斜杠命令参数填充的 <ChangeId> 块内），请在修剪空白后使用该值。
   • 如果对话中松散地引用了变更（例如通过标题或摘要），运行 openspec list 以显示可能的 ID，分享相关候选，并确认用户打算使用哪一个。
   • 否则，查看对话，运行 openspec list，并询问用户要归档哪个变更；在继续之前等待确认的变更 ID。
   • 如果您仍然无法识别单个变更 ID，请停止并告诉用户您还无法归档任何内容。
2. 通过运行 openspec list（或 openspec show <id>）验证变更 ID，如果变更缺失、已归档或尚未准备好归档，则停止。
3. 运行 openspec archive <id> --yes，以便 CLI 移动变更并应用规范更新而不提示（仅对仅工具工作使用 --skip-specs）。
4. 查看命令输出以确认目标规范已更新，并且变更已进入 changes/archive/。
5. 使用 openspec validate --strict 进行验证，如果看起来有问题，请使用 openspec show <id> 进行检查。

参考

• 在归档之前使用 openspec list 确认变更 ID。
• 使用 openspec list --specs 检查刷新的规范，并在移交之前解决任何验证问题。