CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tapd-story-evaluation

TAPD 需求评估技能。基于规范需求文档进行逻辑分析,进行子需求拆分、规模评分(size,斐波那契)与 业务价值(RICE)评分。 包含两个子技能:tapd-story-breakdown(需求拆分)和 tapd-story-score(规模评分与 RICE 业务价值)。 Use this skill whenever the user mentions 需求评估, 评估需求, 需求拆分, 拆分需求, 规模评分, size 评分, RICE 评分, 价值评分, 业务价值, business_value, 需求规模, story evaluation, story breakdown, story scoring, evaluate requirement, break down story, RICE score, Fibonacci sizing, or any workflow involving TAPD story decomposition, relative sizing and value scoring.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary orchestration skill body: fully specified MCP calls, field tables, bounded feedback loops, and validation checkpoints for a batch ticket-creation workflow, with details correctly pushed to reference files and sub-skills. The only deductions are redundant restatements of threshold rules and a slightly incomplete reference-file index.

Suggestions

Add references/size-difficulty-standard.md to the 参考文件 table (it currently is only discoverable via a pointer inside rice-scoring-standard.md).

State the 24-人时 / size=13 / size=8 threshold rules once in a single authoritative section and reference it from §2.3, §2.5, and §4 instead of repeating them four times.

Consolidate the repeated "子 skill 的详细流程见 …" pointers into the existing 子技能 table to remove four redundant lines.

DimensionReasoningScore

Conciseness

The body is dense and operational — parameter priority rules, field tables, thresholds (24 人时, size 13, 3 retries), and an error-handling table with no filler explaining concepts Claude already knows. It is not a 5 because the same threshold rules (size=8 advisory, size≥13 forced rollback, 24-hour cap) are restated in §2.3, §2.5 twice, the 职责边界 blockquote, and §4, and "子 skill 的详细流程见 …" is repeated four times — trimming opportunities beyond "minor".

4 / 5

Actionability

Concrete MCP calls with named parameters (stories_get with workspace_id/id/with_v_status, stories_create, stories_update, tapd_id_get, story_category_get), an exact required-field table with value sources, explicit decision pseudocode for category mapping, and worked usage examples. The control loop is explicitly flagged "伪流程,非代码" and is justified as orchestration over sub-skills and MCP calls, so the instruction-only skill's guidance is fully actionable.

5 / 5

Workflow Clarity

The process is clearly sequenced (参数收集 → 逐需求处理 2.1–2.5 → 四阶段创建协议 → 汇总输出) with explicit validation checkpoints at every stage: v_status check with user decision, user confirmation loop with a 3-round termination condition, pre-check before creation, post-verify of all written fields, an auto-fix loop via stories_update, and a bounded (3×) rollback loop for oversized sub-stories — exactly the validate→fix→retry pattern the rubric rewards, with an error table and status checklist on top.

5 / 5

Progressive Disclosure

Good structure against the actual bundle: the 参考文件 table lists three references/ files with a "何时读取" column, §-level pointers ("见 references/requirement-splitting-guide.md §4"), and detail is properly delegated to sub-skill SKILL.md files. Minor gaps keep it at 4: references/size-difficulty-standard.md exists in the bundle but is absent from the reference table (only reachable through rice-scoring-standard.md, a nested hop), and the referenced sub-skill paths tapd-story-breakdown/SKILL.md and tapd-story-score/SKILL.md are not present in this bundle to verify.

4 / 5

Total

18

/

20

Passed

Description

91%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 with explicit what/when structure, comprehensive bilingual trigger terms, and concrete named actions. The only weakness is incomplete coverage of the skill's full capability set (effort estimation and TAPD ticket creation are not mentioned), and trigger overlap with its own declared sub-skills.

DimensionReasoningScore

Specificity

The description lists three concrete actions — "子需求拆分", "规模评分(size,斐波那契)", "RICE 业务价值评分" — with the basis "基于规范需求文档进行逻辑分析". It sits at anchor 4 rather than 5 because coverage has minor gaps: the skill also performs 工时预估 (effort estimation) and creates TAPD sub-story tickets, neither of which is mentioned.

4 / 5

Completeness

Explicitly answers both what ("基于规范需求文档进行逻辑分析,进行子需求拆分、规模评分(size,斐波那契)与 业务价值(RICE)评分") and when ("Use this skill when the user mentions …") with concrete trigger phrases, matching the anchor-5 good example structure exactly.

5 / 5

Trigger Term Quality

Comprehensive bilingual trigger coverage: "需求评估, 评估需求, 需求拆分, 拆分需求, 规模评分, size 评分, RICE 评分, 价值评分, 业务价值, business_value, 需求规模" plus English synonyms "story evaluation, story breakdown, story scoring, evaluate requirement, break down story, RICE score, Fibonacci sizing" and the catch-all "any workflow involving TAPD story decomposition, relative sizing and value scoring". Both natural user phrasings and technical terms are covered.

5 / 5

Distinctiveness Conflict Risk

The TAPD story-evaluation niche is distinct with specific triggers, but the description itself declares two sub-skills ("tapd-story-breakdown(需求拆分)和 tapd-story-score(规模评分与 RICE 业务价值)") whose trigger terms (需求拆分, 规模评分) overlap with this skill's own triggers — a minor conflict risk within the skill family, matching anchor 4.

4 / 5

Total

18

/

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/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.