-
如果没有提供变更名称,提示选择
运行
获取按最近修改排序的可用变更。然后使用
AskUserQuestion tool 让用户选择要处理哪个变更。
展示前 3-4 个最近修改的变更作为选项,显示:
- 变更名称
- Schema(如果存在 字段,否则为 "spec-driven")
- 状态(例如:"0/5 tasks", "complete", "no tasks")
- 最近修改时间(来自 字段)
将最近修改的变更标记为 "(推荐)",因为它很可能是用户想要继续的。
重要提示:不要猜测或自动选择变更。始终让用户选择。
-
检查当前状态
bash
openspec-cn status --change "<name>" --json
Parse the JSON to understand current state. The response includes:
- : The workflow schema being used (e.g., "spec-driven")
- : Array of artifacts with their status ("done", "ready", "blocked")
- : Boolean indicating if all artifacts are complete
-
根据状态行动:
- 祝贺用户
- 显示最终状态,包括使用的 Schema
- 建议:"所有产出物已创建!您现在可以实现此变更或将其归档。"
- 停止
- 从状态输出中选择第一个 的产出物
- 获取其指令:
bash
openspec-cn instructions <artifact-id> --change "<name>" --json
- Parse the JSON. The key fields are:
- : Project background (constraints for you - do NOT include in output)
- : Artifact-specific rules (constraints for you - do NOT include in output)
- : The structure to use for your output file
- : Schema-specific guidance
- : Where to write the artifact
- : Completed artifacts to read for context
- Create the artifact file:
- Read any completed dependency files for context
- Use as the structure - fill in its sections
- Apply and as constraints when writing - but do NOT copy them into the file
- Write to the output path specified in instructions
- Show what was created and what's now unlocked
- STOP after creating ONE artifact
如果没有产出物准备好(全部受阻):
- 在有效的 Schema 下不应发生这种情况
- 显示状态并建议检查问题
-
创建产出物后,显示进度
bash
openspec-cn status --change "<name>"
产出物类型及其用途取决于 Schema。使用指令输出中的
字段来了解要创建什么。
For other schemas, follow the
field from the CLI output.