Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-sequenced, highly actionable archive workflow with strong validation checkpoints and appropriate deferral to reference files; the main weakness is minor redundancy that could be tightened. Actionability and workflow clarity are strong; conciseness is the lowest dimension due to restated steps.
Suggestions
Remove the restated '脚本会调用 OpenSpec 归档能力...合并主 spec...校验主 spec 中没有残留 delta-only section 标题' sentence in Step 2 — it duplicates numbered items 4–5; fold the ADDED/MODIFIED/REMOVED/RENAMED detail into item 4 instead.
Drop the duplicate '归档脚本会把 openspec/changes/<name>/ 移动到 .../archive/YYYY-MM-DD-<name>/' line in 退出条件 (Step 4 already states the move) and keep exit conditions focused on success criteria.
Consolidate the comet/reference/* pointers into a short '## 参考资料' section so the deferred-detail navigation is discoverable in one place rather than scattered inline across steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and command-driven with no concept-explanation fluff, but it restates the spec-merge/校验 steps in prose after the Step 2 numbered list and repeats the directory-move in 退出条件, so not every token earns its place; not a 3 because it could be tightened. | 2 / 3 |
Actionability | Provides fully executable commands (node "$COMET_STATE" check <name> archive, node "$COMET_ARCHIVE" "<change-name>", git add -A / git commit) and concrete single-choice options that are copy-paste ready. | 3 / 3 |
Workflow Clarity | Clear 0→0b→1→2→3→4 sequence with explicit validation (entry check, exit conditions, non-zero-exit stop) and a feedback loop (archive-reopen back to verify) around an irreversible operation. | 3 / 3 |
Progressive Disclosure | Keeps the body an overview and defers detail to one-level-deep, clearly signaled references (comet/reference/scripts.md, decision-point.md, context-recovery.md) rather than inlining it. | 3 / 3 |
Total | 11 / 12 Passed |