Content
88%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 is a dense, well-structured orchestration document: lean token usage, a fully specified two-stage workflow with validation checkpoints and bounded error-recovery loops, and clean delegation of templates and shared conventions to clearly-signaled reference files. The only real gap is that all executable prompts/commands live in the parent bundle's reference file rather than being available or verifiable within this skill's own bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section (前置条件, 输入, 执行流程, 内容门禁, verdict branching, 更新状态, 产出) is purely operational with no concept explanations or padding; the single rationale line ("拆成两段的理由:speckit-analyze 是独立skill...") is a necessary design decision, and heavy details are delegated instead of duplicated. This matches the lean, competence-assuming top anchor. | 5 / 5 |
Actionability | Concrete state-machine guidance: exact field updates ("更新 meta.yaml.phase 为 tasks-generated", "meta.yaml.history 追加成功记录,清空 meta.yaml.last_failure"), bounded retries ("最多 3 个 round"), and explicit re-entry targets. Not 5 because the executable SUBAGENT_PROMPT templates and shell commands are fully delegated to subagent-prompt-template.md §2.3+§2.4 rather than available inline; not 3 because the orchestration-level instructions are complete and specific with only template details delegated. | 4 / 5 |
Workflow Clarity | Clear two-stage sequence with an explicit validation checkpoint (tasks-analyze compliance verdict), a content-gate checklist table (格式与可执行性, 用户价值切片, TDD 与验收, etc.), and explicit feedback loops: needs_fix → 同 attempt 内 round+1 (capped at 3), plan/spec_insufficient → 回退重入 with attempt-${N+1}.md. This matches the top anchor including error-recovery loops and a checklist. | 5 / 5 |
Progressive Disclosure | All heavy material (prompt/report templates, verdict rules, reentry conventions, error handling) is delegated one level deep with precise section pointers (§2.3, §2.4) and consolidated in a 参考资料 section — well signaled and easy to navigate. Not 5 because references use parent-relative paths (../references/) and no bundle files exist alongside this SKILL.md to verify the targets resolve; not 3 because references are explicit, organized, and not buried. | 4 / 5 |
Total | 18 / 20 Passed |