Content
60%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is well-structured and highly actionable with clear phased workflows and concrete commands, but it is significantly over-written — long prescriptive paragraphs could be condensed into tables/checklists to respect the token budget. Progressive disclosure and navigation are handled well.
Suggestions
Condense the long prescriptive paragraphs in Shape, Build, and Verify into tables or bullet checklists (e.g., the runId/integration rules) to cut token weight while preserving the rules.
Pull a few representative command templates out of prose into short fenced blocks so they are copy-paste ready, especially for `dispatch-verifier` and `archive --dry-run` flows.
Move the dense Supervisor Change / multi-session fallback logic into a dedicated reference file and keep only the decision trigger inline, reducing the main body's wall-of-text.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a dense wall of prescriptive prose (≈110 lines, many paragraphs running 200+ words) that re-explains state-machine rules and fallback logic in exhausting detail; while accurate, much of it could be condensed into tables or checklists, making it noticeably verbose with several padded sections. | 2 / 5 |
Actionability | It provides concrete, executable commands throughout (e.g., `comet native status <change-name> --json`, `comet task … --json`, `archive --dry-run`) with specific flags and an explicit finish-option table, leaving only minor gaps where exact command templates are implied rather than shown. | 4 / 5 |
Workflow Clarity | Phases are clearly sequenced (开始或恢复 → Shape → Build ↔ Verify Loop → Archive → 后续指令) with explicit completion criteria per phase and feedback loops (verify → revise → rebuild), though some validation checkpoints are buried in prose rather than enumerated. | 4 / 5 |
Progressive Disclosure | It appropriately points to one-level-deep references ([工作区选择参考], [澄清参考], [产物参考], [命令参考], [恢复参考]) and signals when to read each, keeping the overview inline; the referenced files are not present in the bundle to verify, but the signaling and structure are good with only minor organization gaps. | 4 / 5 |
Total | 14 / 20 Passed |