28 lines
1.8 KiB
Markdown
28 lines
1.8 KiB
Markdown
---
|
||
name: /openspec-archive
|
||
id: openspec-archive
|
||
category: OpenSpec
|
||
description: Archive a deployed OpenSpec change and update specs.
|
||
---
|
||
<!-- OPENSPEC:START -->
|
||
**约束条件**
|
||
- 优先采用简单、最小化的实现，只有在明确要求或明显需要时才添加复杂性。
|
||
- 保持更改紧密围绕请求的结果。
|
||
- 如需更多 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` 检查刷新的规范，并在移交之前解决任何验证问题。
|
||
<!-- OPENSPEC:END -->
|