CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tapd-story-validate

迭代执行流水线校验阶段。对 implement 产出的代码做四维度并行校验(架构 / 安全 / CodeReview / 测试覆盖), 再按汇总结果原地修复(fullstack 需求按受影响文件路径分派 backend-developer / frontend-developer)。 每个维度通过独立 subagent 执行,日志写入独立 process-validate-*.log。 命令与报告模板详见 ../references/subagent-prompt-template.md §2.6~§2.10。 回退默认保留代码(携带 unresolved_findings 回上游修订规范)。

Quality

74%

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-validate/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 tightly written operational playbook: unambiguous sequencing, explicit verdict-based decision tables, fix routing rules, and a complete validate→fix→re-validate feedback loop with retry caps and escalation. Its main weaknesses are minor redundancy around the rollback/round rules and references that point outside the skill bundle, which limits verifiability of the progressive-disclosure structure.

DimensionReasoningScore

Conciseness

The body is dense and operational — tables map subagents to agents/templates/outputs/logs, and it never explains concepts Claude already knows. Minor redundancy keeps it below anchor 5: the '回退默认保留代码' rule is restated in 前置条件, §5, and 可重入约定, and the round-increment rule appears twice (§3 and the 可重入约定 table).

4 / 5

Actionability

Guidance is concrete and executable within its orchestration context: explicit tables for subagent dispatch, verdict-aggregation decisions ('四份全 LGTM,且无 CRITICAL/HIGH finding → 跳过修复'), fix routing by affected file path, and the interface-contract attribution rules with a stated judgment standard. As an instruction-only skill, deferring the actual commands to the referenced template file is a deliberate split with only minor gaps, so it sits at anchor 4 rather than 5.

4 / 5

Workflow Clarity

The multi-step process is clearly sequenced (four parallel validations → aggregation decision → in-place fix → state update → rollback) with explicit validation checkpoints and a full feedback loop: fix is followed by re-running all four validations (round +1), capped at '同 attempt 内最多 3 个 round', with forced escalation to rollback re-entry when retries are exhausted. This matches the anchor-5 pattern of validate → fix → re-validate with explicit retry and escalation rules.

5 / 5

Progressive Disclosure

The body acts as an overview that defers command/report-template detail to one-level-deep references with precise section pointers (§2.6–§2.10) and a dedicated 参考资料 section — good structure per anchor 4. It is not anchor 5 because no bundle files exist in this skill directory (no references/, scripts/, or assets/); the referenced paths ('../references/subagent-prompt-template.md', 'agents/code-reviewer.md', 'skills/bk-security-redlines/') point outside the bundle and cannot be verified, and references appear both inline and in the closing list.

4 / 5

Total

17

/

20

Passed

Description

58%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 communicates a specific, well-scoped pipeline validation stage with concrete capabilities and low conflict risk, but it is written entirely from an internal-orchestration perspective. It lacks any explicit 'when to use' trigger guidance and uses jargon-heavy phrasing rather than natural keywords, capping completeness and trigger-term quality.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the requirement phase is `implemented` and code needs four-dimension validation (architecture / security / code review / test coverage) before promoting to `validated`.' — this would raise completeness from 3.

Include natural trigger terms and synonyms users or orchestrators would actually say (e.g. '校验/validate', '代码审查/code review', '安全检查/security check', '测试覆盖/test coverage') instead of relying solely on internal jargon like '迭代执行流水线' and 'LGTM'.

Trim or contextualize internal references such as '详见 ../references/subagent-prompt-template.md §2.6~§2.10' — file-path pointers belong in the body, not the description.

DimensionReasoningScore

Specificity

The description lists several concrete actions — '四维度并行校验(架构 / 安全 / CodeReview / 测试覆盖)', '按受影响文件路径分派 backend-developer / frontend-developer', '日志写入独立 process-validate-*.log', '回退默认保留代码' — with broad coverage of the stage's capabilities. It falls short of anchor 5 because the framing is internal pipeline jargon ('迭代执行流水线校验阶段') rather than fully concrete capability statements.

4 / 5

Completeness

The 'what' is clear and detailed (four-dimension parallel validation plus in-place fix plus rollback semantics), but there is no 'Use when...' or equivalent explicit trigger guidance — the 'when' is only weakly implied by '迭代执行流水线校验阶段'. Per the judging guidelines, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant domain keywords exist ('校验', '修复', '安全', '测试覆盖', 'CodeReview'), matching anchor 3's 'some relevant keywords', but natural trigger phrasing a user would say is absent and the description leans on internal jargon like 'subagent', 'LGTM', and '迭代执行流水线'. Not anchor 2, since it does name the validation domain and its four dimensions rather than being purely generic.

3 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — the validate stage of a specific pipeline, with named subagents, log file patterns, and template section pointers — making it mostly distinct with minor overlap risk with sibling pipeline stages (implement/plan). It is not anchor 5 because its triggers are not distinct natural phrases but internal stage terminology.

4 / 5

Total

14

/

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