CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tapd-story-breakdown

TAPD 需求拆分子技能。对大需求进行拆分,输出各子需求的规范需求文档,严格控制 子需求的内容规模,保障研发交付内容可控、易于测试验证。本技能作为 tapd-story-evaluation 的子技能被调用,不独立触发。

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

Excellent instructional content: the workflow is explicitly sequenced with hard validation gates and a bounded retry loop, all operational rules are stated with exact thresholds, paths, and examples, and detailed methodology is appropriately pushed to precisely-pinned reference files. The only room for improvement is trimming a small amount of restated or explanatory prose.

DimensionReasoningScore

Conciseness

The body is dense and operational throughout — decision matrices, thresholds, a sanitization algorithm, and an output template — with almost no explanation of concepts Claude already knows. It is not a 5 because minor prose could be trimmed: the 概述 restates the frontmatter description, and the cross-platform blockquote and some alignment notes (e.g., 与 size-difficulty-standard.md 维度名称一致) are borderline over-explanation.

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: the exact MCP call (tapd_id_get with workspace_id/id/type parameters), a precise split/merge decision matrix with thresholds, a step-by-step filename-sanitization algorithm with worked naming examples (8–20 char filenames, illegal-char replacement, 50-char directory truncation), and a copy-paste-ready markdown output template covering the common cases. Per the code-vs-instruction scoring note, the absence of code is not penalized since the guidance is this concrete.

5 / 5

Workflow Clarity

Five steps are clearly sequenced (assess split need → get long ID → execute split → validation gate → output result) with explicit validation checkpoints (traceability coverage ≥95% with no ❌ elements, 6/6 binary consistency checks) and a bounded error-recovery feedback loop (§4.3: patch → full re-split → hand to user, retry budget of 2). This matches the anchor for clear sequence with explicit validation and feedback loops.

5 / 5

Progressive Disclosure

The body is an overview that cleanly delegates deep methodology to one-level-deep, clearly signaled references (../references/requirement-splitting-guide.md, ../references/requirement-doc-template.md), each cited with precise section pins (§5, §6, §7.1–§7.4) and summarized in a reference table stating purpose and when-to-read. No bundle files are present in the review copy, so this is scored on the reference signaling, which matches the well-signaled one-level-deep anchor.

5 / 5

Total

19

/

20

Passed

Description

78%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 strong description: it states several concrete capabilities, carries natural domain keywords (TAPD, 需求拆分, 子需求文档), and explicitly declares its invocation model (sub-skill of tapd-story-evaluation, never standalone), which doubles as clear when-guidance. The only shortfall is that trigger detail beyond the parent-skill binding (e.g., the >24 person-hours re-split condition) is left to the body.

Suggestions

Add one concrete trigger condition to the description, e.g., "当子需求评分后预估超过 24 人时时,由主 skill 再次调用进行二次拆分", so the when-guidance is specific rather than only parent-bound.

Mention the validation deliverables (追溯矩阵覆盖率、一致性检查) and the output location (docs/reqs/<父需求名>/) in the description to close the specificity gap toward comprehensive capability coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "对大需求进行拆分", "输出各子需求的规范需求文档", "严格控制子需求的内容规模", "保障研发交付内容可控、易于测试验证" — which matches the anchor for several specific actions with minor gaps. It is not a 5 because it omits other capabilities the skill performs (traceability-matrix validation, consistency checks, sub-requirement file output).

4 / 5

Completeness

Both what and when are explicitly present: the what is the splitting/standardized-doc generation above, and the when is stated as "本技能作为 tapd-story-evaluation 的子技能被调用,不独立触发" — explicit trigger guidance equivalent to a 'Use when' clause. It is not a 5 because the concrete trigger condition (e.g., sub-requirement exceeding 24 person-hours) appears only in the body, not the description.

4 / 5

Trigger Term Quality

Natural domain keywords are well covered: "TAPD", "需求拆分", "大需求", "子需求", "规范需求文档", "测试验证" — matching the 'good keyword coverage; a few natural terms missing' anchor. It falls short of 5 because common variations/synonyms (e.g., 需求分解, story, 拆解) are absent.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche — TAPD requirement splitting as a sub-skill explicitly bound to the parent skill tapd-story-evaluation and explicitly marked as not independently triggered — so overlap or wrong-skill triggering risk is minimal.

5 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 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

Total

13

/

16

Passed

Repository

TencentBlueKing/bk-bcs

Path

.agents/skills/tapd-story-evaluation/tapd-story-breakdown/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.