CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tapd-story-review

TAPD 需求评审技能。用于需求澄清或需求拆分结果已回写 TAPD 后,发起评审、@指定评审人、 读取父单和子单评论、汇总待处理意见,并在满足评审通过规则前,驱动 重新澄清或重新拆分。Use this skill whenever the user mentions 需求评审, review需求, 评审澄清结果, 评审拆单结果, TAPD评论处理, 需求review闭环, 需求待审批, or any workflow involving TAPD story review after clarification or evaluation.

Quality

82%

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

73%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 well-engineered, operationally dense skill: the three-mode workflow is clearly sequenced with validation checkpoints and genuine feedback loops, and guidance is highly concrete. The main costs are token duplication of inference/restore logic across sections and a monolithic length that would benefit from splitting templates and schemas into reference files.

Suggestions

Merge the '参数推断与回退规则' section with the 执行流程 §1 steps so workspace_id/reviewer/phase inference rules are stated once, and centralize the owner-restore logic into a single stated rule instead of repeating it in §3.4, §4.1, §4.2, §4.5, and check-status.

Extract the verbatim comment templates (§3.5, §3.6, 评论协议建议) and the 待确认问题 field schema (§4.4) into a references/ file, keeping only summaries in SKILL.md, to reduce the ~650-line body.

Name the specific TAPD MCP tools for the write operations (status transition, comment creation, comment reads in §4.2) the way §1.3 names stories_get, so every step is fully executable.

DimensionReasoningScore

Conciseness

The ~650-line body never over-explains known concepts, but contains real duplication that could be tightened: parameter inference rules for workspace_id/reviewers appear both in '参数推断与回退规则' and again in 执行流程 §1.1–1.3, and the owner-restore logic is restated in §3.4, §4.1, §4.2, §4.5 and check-status. This matches the 3 anchor (mostly efficient but could be tightened) rather than 4, where over-explanation would be only minor.

3 / 5

Actionability

Highly actionable throughout — concrete MCP parameters ('stories_get' with an explicit fields list), verbatim comment templates, a YAML metadata schema, structured verdict enums, and an error-handling table. It falls short of 5 because several operations (status transition to 'for approve', comment creation, and the §4.2 comment reads) omit the specific MCP tool name, leaving minor execution gaps.

4 / 5

Workflow Clarity

Each mode has a clearly numbered sequence with explicit validation checkpoints (§3.1 校验发起条件 before any write, §4.1 parent-status check first) and robust feedback loops (retry-once on comment-read failure, blocked → answered_questions → re-call, needs_rework → upstream re-run with baseline snapshots), plus verdict branches A–E and explicit end conditions. This matches the 5 anchor with validation steps, error-recovery loops, and checklists.

5 / 5

Progressive Disclosure

Good structure with clear section headers per mode and a well-signaled reference table (file, purpose, '何时读取') for the single external reference, which is one level deep. It stays at 4 rather than 5 because the monolithic 650-line body inlines material (comment templates, the question schema, metadata examples) that could be split into reference files, and no bundle files exist to absorb it.

4 / 5

Total

16

/

20

Passed

Description

88%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 enumerates concrete actions covering the full review loop and provides an explicit, trigger-phrase-rich 'Use when' clause in both Chinese and English. The only weakness is minor — a few natural trigger variants are absent and it sits close to sibling TAPD skills in the same pipeline.

DimensionReasoningScore

Specificity

The description enumerates five concrete actions — '发起评审、@指定评审人、读取父单和子单评论、汇总待处理意见' and driving '重新澄清或重新拆分' until the approval rule is met — giving comprehensive coverage of the workflow. This matches the score-5 anchor (multiple specific concrete actions) rather than 4, which expects minor coverage gaps.

5 / 5

Completeness

Both 'what' (the enumerated review-loop actions) and 'when' are explicitly present: 'Use this skill whenever the user mentions 需求评审, ... or any workflow involving TAPD story review after clarification or evaluation.' The when-clause is explicit with concrete trigger phrases, matching the 5 anchor rather than 4 where the when could be more specific.

5 / 5

Trigger Term Quality

Includes seven natural trigger terms with Chinese, English, and mixed variants ('需求评审, review需求, 评审澄清结果, 评审拆单结果, TAPD评论处理, 需求review闭环, 需求待审批') plus a general catch clause. Coverage is good but a few natural phrasings a user might say (e.g. 'TAPD 评审', '处理评审意见') are missing, so it sits at 4 rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche ('TAPD story review after clarification or evaluation') with distinct triggers, but it shares the TAPD/pipeline domain with sibling skills (the body references tapd-story-evaluation), so a broad mention like '需求评审' carries minor overlap risk with closely related skills. This is the 4 anchor, not 5's minimal-conflict profile.

4 / 5

Total

18

/

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

skill_md_line_count

SKILL.md is long (651 lines); consider splitting into references/ and linking

Warning

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

12

/

16

Passed

Repository

TencentBlueKing/bk-bcs

Path

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