Content
77%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 body delivers a well-sequenced, highly actionable planning workflow with explicit validation gates and error-recovery loops, and it is mostly token-efficient. Its main defect is bundle integrity: the template files and plan-inventory.md it links to as core entry points are missing from the shipped bundle.
Suggestions
Ship the referenced files in the bundle — templates/task_plan.md, templates/findings.md, templates/progress.md, and plan-inventory.md are linked as the primary template and handoff entry points but are absent, leaving the 範本 and 列出已儲存的計畫 sections pointing at nothing.
Show the exact resolve-plan-dir.sh invocation (with PLAN_ID / PWF_PLAN_ROOT argument syntax) and the concrete command used to pin a PLAN_ID to a host, instead of describing both only in prose.
Consolidate the plan-directory selection and pinning guidance repeated across 第一步, 快速開始, and 新計畫的建立約定 into a single section to trim redundant tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and earns most of its tokens: tables (檔案用途, 讀取 vs 寫入決策矩陣, 反模式), the two-step rule, and the three-failure protocol are all guidance Claude would not produce on its own. Minor over-explanation remains: plan-directory selection and PLAN_ID pinning are restated across "第一步", "快速開始", and "新計畫的建立約定", and the 安全邊界 section repeats defensive statements already in the description — so it sits at 4, not the lean 5. | 4 / 5 |
Actionability | Mostly executable: copy-paste-ready commands such as the session-catchup.py invocations with "$(command -v python3 || command -v python)", "sh \"$PWF_SKILL_DIR/scripts/check-complete.sh\" --validate path/to/task_plan.md", and the set-active-plan --list / --archive <id> / --restore <id> flag set. Minor gaps keep it from 5: the resolve-plan-dir.sh call is described in prose ("配合主機的 PLAN_ID 與 PWF_PLAN_ROOT") without an exact invocation, and how to "釘選" (pin) a PLAN_ID to a host is never shown as a command. | 4 / 5 |
Workflow Clarity | Clear sequence with explicit validation checkpoints and feedback loops: plan resolution steps 1–3 in "第一步", the creation convention requiring the format check to pass "實作前及修改階段結構後" (before implementation and after structural changes), the 三次失敗協定 as an error-recovery loop ending in asking the user, the 五問重啟測試 checklist, and archive operations gated on user consent with a preview step. | 5 / 5 |
Progressive Disclosure | The body is well-sectioned and references are one level deep, but scored against the actual bundle, four of the five non-script references are broken: "[templates/task_plan.md](templates/task_plan.md)", "[templates/findings.md](templates/findings.md)", "[templates/progress.md](templates/progress.md)" and "[plan-inventory.md](plan-inventory.md)" point to files that are absent from the bundle (only SKILL.md and scripts/ ship). The script references (init-session.sh, check-complete.sh, session-catchup.py, resolve-plan-dir.sh, set-active-plan.sh) do resolve. Broken primary entry points push this to 3 rather than 4. | 3 / 5 |
Total | 16 / 20 Passed |