CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tapd-story-implement

迭代执行流水线代码实现阶段。基于 tasks.md 调用 /speckit.implement 以 TDD 模式完成全部任务。 本子 skill 不创建/切换分支,重试策略为原地修复;仅在跨 attempt 回退时做 git 路径级 checkout。 命令详见 ../references/subagent-prompt-template.md §2.5。

Quality

76%

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 ./.agents/skills/tapd-story-pipeline/tapd-story-implement/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a well-structured, dense orchestration guide with a clear sequenced workflow, explicit validation checkpoints and error-recovery feedback loops, and precise state-management rules. Its main weaknesses are minor redundancy between the execution-flow and re-entry sections, and that its key mechanism and reference files live in an external '../references/' bundle not present with this skill.

DimensionReasoningScore

Conciseness

The body is dense and operational — tables for routing, JSON consumption, and re-entry rules; exact field names ('meta.yaml.implement_rounds.completed'); hard limits ('最多 3 个 round'); and no explanation of concepts Claude already knows. Not score 5 because there is minor duplication: the retry/rollback rules stated in '执行流程' are restated in the '可重入约定' table and repeated '严禁' notes, which could be consolidated.

4 / 5

Actionability

Mostly executable guidance: exact agent routing per tech_type, precise meta.yaml mutations, a copy-paste rollback snippet ('BASELINE=$(yq ...); git checkout "${BASELINE}" -- ...; git clean -fd ...'), explicit forbidden commands, and a three-way fail decision table. Not score 5 because the core mechanism (SUBAGENT_PROMPT rendering) and validation chain live in an external template file ('subagent-prompt-template.md §2.5') that is not in this bundle, leaving minor gaps a reader cannot resolve from the body alone.

4 / 5

Workflow Clarity

The multi-step process is clearly sequenced (preconditions → inputs → routing → fullstack rounds → consume result JSON → retry/rollback/terminate → status update) with explicit validation checkpoints: round-count guard ('completed = 2:...不应再次进入'), self-check + test runs required in the subagent, Code scope whitelist verification ('校验 Code scope 白名单未被意外缩窄'), and a 3-round cap that forces escalation. Feedback loops for error recovery (retry in place → escalate to rollback re-entry with path-level git restore) are explicit, and the destructive git operations carry explicit guardrails — matching anchor 5.

5 / 5

Progressive Disclosure

Good structure: orchestration-level content stays inline, all six external references are one level deep and consolidated in a dedicated '参考资料' section with clear section-level pointers (§2.5, §3, §1.3), and nothing that belongs in a separate file is inlined. Not score 5 because the references point to '../references/' outside this skill's bundle — no references/ directory exists in the skill — so the referenced files cannot be verified from the skill itself, a minor organization gap; not score 3 because the structure and navigation are otherwise clear and well-signaled.

4 / 5

Total

17

/

20

Passed

Description

62%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 is specific and highly distinctive within its pipeline niche, with concrete capability statements and explicit boundary behavior. Its main weaknesses are the absence of an explicit 'when to use' trigger clause and trigger terms that are internal jargon rather than natural user phrases, which cap completeness and trigger quality at 3.

Suggestions

Add an explicit trigger clause such as 'Use when the requirement phase is confirmed and code implementation per tasks.md is needed' to raise completeness from 3 toward 4-5.

Include natural trigger phrases and synonyms users would actually say (e.g. '实现代码', 'implement stories', 'run implementation', 'TDD implementation') instead of only internal pipeline jargon like 'attempt'/'回退重入'.

Briefly summarize what the skill covers beyond invoking /speckit.implement (e.g. backend/frontend routing and retry policy) instead of deferring entirely to '命令详见 ../references/subagent-prompt-template.md §2.5'.

DimensionReasoningScore

Specificity

The description lists several concrete actions: '基于 tasks.md 调用 /speckit.implement 以 TDD 模式完成全部任务' (invoke /speckit.implement based on tasks.md in TDD mode to complete all tasks) plus explicit boundary behaviors ('不创建/切换分支,重试策略为原地修复;仅在跨 attempt 回退时做 git 路径级 checkout'). It names the domain and multiple specific actions with only minor coverage gaps, matching anchor 4 rather than anchor 5 (the what is concrete but scope detail is deferred to an external reference rather than summarized).

4 / 5

Completeness

The 'what' is clear (run the implementation phase: TDD execution of all tasks via /speckit.implement, in-place retry, path-level git checkout only on cross-attempt rollback), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the opening '迭代执行流水线代码实现阶段' only weakly implies when to use it. Per the judging guidelines, a missing explicit 'when' caps completeness at 3.

3 / 5

Trigger Term Quality

It contains domain-relevant keywords such as '代码实现' (code implementation), 'TDD', 'tasks.md', '/speckit.implement', and '迭代' (iteration), but these are technical jargon tied to one specific pipeline rather than natural phrases a user would say; common variations and synonyms are missing. Not score 2 because the terms are specific to the domain rather than generic ('works with files'); not score 4 because there is no broader natural-language coverage.

3 / 5

Distinctiveness Conflict Risk

It occupies a clear niche with distinct triggers — the implementation phase of a specific iteration pipeline, identified by unique artifacts like 'tasks.md', '/speckit.implement', 'attempt', and 'git 路径级 checkout'. These terms are unlikely to collide with other skills, matching anchor 5 (clear niche with distinct triggers; minimal conflict risk).

5 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

TencentBlueKing/bk-bcs

Path

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