CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

subagent-driven-development

当在当前会话中执行包含独立任务的实现计划时使用

Quality

59%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/subagent-driven-development/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a mature, rigorously sequenced orchestration skill: the per-task and fix-loop workflow is among the clearest I have evaluated, with explicit validation gates, feedback loops, and compaction-recovery mechanics, and it consistently assumes Claude's competence rather than teaching basics. Its weaknesses are token weight — the duplicated flowcharts and repeatedly restated prohibitions could be trimmed — and a broken disclosure boundary: three of its four referenced documents are missing from the bundle, so the per-role prompt templates the whole process depends on are dangling links.

Suggestions

Ship the three referenced templates (implementer-prompt.md, task-reviewer-prompt.md, re-review-prompt.md) in the bundle or inline their essential contracts — the entire dispatch/review workflow currently ends at dangling links, and progressive disclosure breaks precisely where detail should be disclosed.

Cut one of the two representations of the process: the ~90 lines of dot-graph edges duplicate the prose sections nearly one-to-one; keeping a single compact flowchart (or the prose alone) would reclaim a large token budget without losing any operational rule.

Deduplicate the recurring prohibitions — the HEAD~1 warning appears twice and the "静默丢弃是禁止的" rule three-plus times — by stating each once in its governing section and referencing it elsewhere.

DimensionReasoningScore

Conciseness

The body is dense, high-value operational guidance with no filler about concepts Claude already knows, but it carries real redundancy: the two dot flowcharts (~90 lines total) restate the prose process almost node-for-node, the "绝不用 HEAD~1" warning appears twice nearly verbatim, the "静默丢弃是禁止的" prohibition recurs in at least three sections, and the Ruling ledger format is re-specified repeatedly. This is 'mostly efficient but could be tightened' rather than 'minor instances of over-explanation', so it sits at 3 rather than 4; it is well above 2 because there is no padded explanation of known concepts — every repetition is an operational rule, just stated more times than needed.

3 / 5

Actionability

The guidance is highly executable: exact commands with argument placeholders ("bash scripts/sdd-workspace PLAN_FILE", "bash scripts/task-brief PLAN_FILE N", "bash scripts/review-package PLAN_FILE BASE HEAD"), exact ledger line formats ("Task <N>: fix round <R>/5 (...)"), a concrete example workflow, and specific dispatch-brief contents. It is not 5 because the three referenced prompt templates (implementer-prompt.md, task-reviewer-prompt.md, re-review-prompt.md) are absent from the bundle, so the most load-bearing dispatch artifacts cannot actually be used as written; not 3 because everything that is present is concrete and directly executable.

4 / 5

Workflow Clarity

The multi-step process is explicitly sequenced with validation checkpoints at every stage: pre-flight plan conflict scan producing a table, per-task spec-compliance plus quality review as a hard gate, fix rounds with per-round re-reviews and a five-round circuit breaker with adjudication rules, a final whole-branch review, and compaction-recovery via the ledger. Feedback loops (fix → re-review → re-fix, and validate-before-proceed gates like "三者齐备才分派复审") are explicit throughout, and the rationalization table plus the four stop conditions function as a checklist. This matches the top anchor: clear sequence, explicit validation, feedback loops, and checklists; nothing material is missing.

5 / 5

Progressive Disclosure

Section structure within SKILL.md is clear (何时使用 / 流程 / 准备 / 模型选择 / 任务循环 / 最终审查 / 收尾 / 借口表 / 示例) and references are explicitly signaled as markdown links, but scored against the actual bundle: the three referenced template files (implementer-prompt.md, task-reviewer-prompt.md, re-review-prompt.md) do not exist in the bundle, and the external "../requesting-code-review/code-reviewer.md" is also absent — so navigation breaks at exactly the points where detail should be disclosed. The three scripts in scripts/ are real and correctly referenced, which keeps this above the 'references buried' anchors, but the dangling template links and the 33KB monolithic body leave it at 'some structure, could be better organized' rather than 4.

3 / 5

Total

15

/

20

Passed

Description

36%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description functions only as a trigger clause: it says when to use the skill but never says what the skill does. A reader cannot learn from the description alone that this involves dispatching fresh implementer subagents per task, spec-compliance plus quality review, a five-round fix loop, or a final whole-branch review. Adding a 'what' half and the subagent vocabulary would lift it substantially.

Suggestions

Add a 'what' clause stating the concrete actions, e.g. "为每个任务分派一个全新的实现子智能体,任务后做规格+质量审查,五轮修复循环,最后做整分支最终审查" (dispatch a fresh implementer subagent per task, run spec-compliance + quality review after each, a capped fix loop, and a final whole-branch review).

Include the skill's defining trigger vocabulary — 子智能体/subagent, 任务审查, 修复循环 — so natural phrasing like "用子智能体执行这个计划" or "执行计划并审查每个任务" matches, and so it is clearly distinguishable from inline plan-execution skills.

State the contrast with inline execution explicitly in the description (e.g. "当任务基本独立、且未选择内联执行时使用"), since task independence plus subagent dispatch is what separates this skill from executing-plans.

DimensionReasoningScore

Specificity

The description names its domain — "执行包含独立任务的实现计划" (executing implementation plans containing independent tasks) — but lists no concrete actions at all; it is purely a trigger clause with no statement of what the skill actually does (dispatch implementer subagents, run per-task reviews, hold fix rounds, final branch review). It is not score 1 because the domain is concretely named rather than abstract ('帮助处理文档'), and not score 3 because no capability or action is described, only the condition of use.

2 / 5

Completeness

Only the 'when' is present ("当在当前会话中执行包含独立任务的实现计划时使用") with no 'what' whatsoever — the description never states that the skill dispatches fresh subagents per task, reviews each task, or runs a final whole-branch review. This matches anchor 2 ('only when is present without what', e.g. "Use when working with documents") exactly. Not 3 because anchor 3 requires a clear 'what', which is entirely absent here.

2 / 5

Trigger Term Quality

It contains genuinely relevant natural phrases a user would say — "执行…实现计划" (execute an implementation plan), "独立任务" (independent tasks), "当前会话" — but misses the most identity-defining terms: 子智能体/subagent, 任务审查/fix rounds, and common variations like "按计划实现" or "执行这个计划". Not 4 because the entire subagent vocabulary, the skill's core identity, is absent; not 2 because the terms present are natural and on-target, not generic filler.

3 / 5

Distinctiveness Conflict Risk

"包含独立任务的实现计划" is the only discriminator against the closely related inline-execution skill (executing-plans), and the subagent-dispatch distinction — the skill's real differentiator — is absent, so a user with an implementation plan could plausibly trigger the wrong skill. It is somewhat specific (plans with independent tasks) but overlaps with similar plan-execution skills. Not 4 because the key distinguishing mechanism (subagent dispatch, per-task review) is missing; not 2 because the domain is not broadly generic.

3 / 5

Total

10

/

20

Passed

Validation

75%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 4 missing, 1 suspicious

Warning

Total

12

/

16

Passed

Repository

jnMetaCode/superpowers-zh

Path

skills/subagent-driven-development/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.