CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

subagent-execution-governance

把子代理派发从"监督型治理"升级为"契约型治理":探查/实现/验证角色分离、契约快照(含负空间)、三级有界读取、单写者文件所有权、行动门槛替代轮次门槛、结构化 BLOCKED、token/工具/轮次预算、结构化结果回收与 repair-contract 恢复。用于派发实现型子代理(写代码/写文件类任务)、设计"谁读什么/谁写什么/何时算阻塞"的执行协议、审计子代理空转(反复探查不产出、并行写冲突、上下文膨胀)、或复盘"子代理烧了大量 token 却没产出"的会话。不用于纯问答、单轮小修改、或已有成熟任务流程的普通委派。

Quality

81%

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

The canonical home for this skill is subagent-execution-governance in ooooooooooooooooooop/agent-tools

SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

A strong, genuinely operational protocol skill: concrete contract schemas, bounded-read levels, single-writer ownership, a structured BLOCKED gate, and a pre-dispatch checklist make it highly actionable with a clear sequenced workflow. Its weaknesses are repetition of the same incident statistics and dated anecdotes (conciseness), a few unbound parameters like K and N where concrete defaults exist elsewhere, and a monolithic ~310-line body that should push plugin specs, the Workflow contract, and case tables into reference files — leaving one bundle script entirely unreferenced.

Suggestions

Move the P1/P2 plugin specs, the section-13 Workflow contract, and the reverse-case table into references/ files (e.g., references/plugins.md, references/workflow-contract.md) and link them one level deep; also reference scripts/workflow_preflight_router.py from the body so the full bundle is discoverable.

State the repeated incident evidence (204,869 token / cache=0 stat, b21b9211 anecdote) once in a single 'origin session' section instead of three times across sections 9 and 10, and trim dated narrative padding like the 2026-08-25 log.

Replace unbound placeholders ("最多 N 个额外文件", "连续 K 个有效动作窗口") with concrete default numbers, matching the style already used in section 8's budgets.

DimensionReasoningScore

Conciseness

Mostly efficient, operational content (contract templates, state machine, budget numbers) with no padding on basics Claude already knows, but it includes repeated war-story detail: the "单步 204,869 输入 token / cache=0" statistic is stated three times (sections 9 and 10 areas), the b21b9211 anecdote appears twice, and there is narrative incident padding ("2026-08-25 实测…用户两次发火") plus a large ASCII box that could be a bullet list. Tightening these would move it to anchor 4; it is not anchor 2 because the bulk of the body is genuinely non-obvious operational protocol.

3 / 5

Actionability

Concrete, executable guidance throughout: the contract snapshot field template (GOAL/OWN/MAY READ/OUT OF SCOPE/…), the structured BLOCKED schema with an invalidity gate, Level 0-2 read permissions with reason codes, a 7-item pre-dispatch checklist, and runnable script invocations ("session-discipline-audit.js <session id|zstd 路径>", Node ≥22 requirement). Not score 5 because some thresholds are left as unbound symbols ("最多 N 个额外文件", "连续 K 个有效动作窗口" — K is never given a number, unlike section 8's concrete budgets) and the plugin sections describe behavior without any usage or install instructions.

4 / 5

Workflow Clarity

The multi-step process is clearly sequenced: role separation (Discovery → Contract → Implementation → Validation), contract construction, dispatch with the 12-section pre-flight checklist, state-machine reporting, and a failure/recovery path (repair contract instead of full re-dispatch, persisted task-state files). Validation checkpoints are explicit (DONE requires validation evidence, BLOCKED invalidity gate, STALLED watchdog criteria). Not score 5 because validation of the overall outcome is scattered across sections rather than one closed loop, and some transitions (e.g., who runs the discipline audit and when) are implied rather than stated.

4 / 5

Progressive Disclosure

Section headers are clear and the two referenced scripts are real, one level deep, and signaled with usage syntax — but the SKILL.md is a ~310-line monolith that inlines content clearly suited to separate reference files (the P1/P2 plugin specifications, the 13-section Workflow orchestration contract, the reverse-case table, the model routing table), with no references/ split at all. Additionally, scripts/workflow_preflight_router.py exists in the bundle but is never referenced from the body, making part of the bundle undiscoverable. This matches anchor 3: structure present, but content that should be separate is inline.

3 / 5

Total

14

/

20

Passed

Description

92%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.

A dense, highly specific description that clearly states what the skill does, when to use it, and when not to use it, with concrete trigger phrases for dispatch-design, idle-loop auditing, and post-mortem scenarios. The only weakness is keyword coverage skewed to Chinese phrasing, which may miss some natural variation in trigger terms. Voice is consistently third-person; no fluff or over-claims.

DimensionReasoningScore

Specificity

The description enumerates concrete mechanisms rather than vague claims: "探查/实现/验证角色分离、契约快照(含负空间)、三级有界读取、单写者文件所有权、行动门槛替代轮次门槛、结构化 BLOCKED、token/工具/轮次预算、结构化结果回收与 repair-contract 恢复" — multiple specific, distinct capabilities with comprehensive coverage. Not score 4 because no meaningful capability is left out; each mechanism maps to a section in the body.

5 / 5

Completeness

Explicitly answers both 'what' ("把子代理派发从'监督型治理'升级为'契约型治理'" plus the enumerated mechanisms) and 'when' ("用于派发实现型子代理…设计…执行协议、审计…、或复盘…的会话"), and adds an explicit negative scope ("不用于纯问答、单轮小修改、或已有成熟任务流程的普通委派") with concrete trigger phrases. Clearly matches the anchor-5 example pattern of what + use-when in one description.

5 / 5

Trigger Term Quality

Contains natural phrases a user in this domain would actually say: "审计子代理空转(反复探查不产出、并行写冲突、上下文膨胀)", "复盘'子代理烧了大量 token 却没产出'的会话", "派发实现型子代理(写代码/写文件类任务)". Good coverage of both the design-time and post-mortem use cases, but some common variations (e.g., English terms like 'subagent', 'orchestration') and a few synonyms are missing, so it falls between anchors 4 and 5 — closer to 4.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — engineering subagent work/read/write boundaries and exit conditions — and actively disambiguates with "不用于纯问答、单轮小修改、或已有成熟任务流程的普通委派" and "只查子代理用了什么模型…" exclusion, minimizing the risk of triggering for adjacent skills. It names its own scope precisely enough that overlap with generic delegation or audit skills is minimal.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

ooooooooooooooooooop/personal-ai

Path

skills/subagent-execution-governance/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.