CtrlK
BlogDocsLog inGet started
Tessl Logo

pipeline-template-module

处理 BK-CI 流水线模板的创建、版本管理、实例化、权限控制、PAC 模板和商店集成时使用。当用户提到模板复用、模板版本、批量实例化、模板迁移、商店模板或 PAC 模板时优先使用。

64

Quality

81%

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

60%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-structured, token-efficient routing overview whose in-body guidance (scenario routing, V1/V2 distinction, impact checklist) is sound, but whose entire detail layer is dangling: none of the four referenced files exist in the bundle, and no concrete V1/V2 identification criteria are given inline. The skeleton is excellent; the bundle is incomplete.

Suggestions

Ship the four referenced files (reference/1-template-foundation.md through reference/4-operations-extension.md) in the bundle, or inline the essential details — as it stands, every routing path dead-ends at a missing file.

Use the conventional 'references/' directory name and verify referenced paths resolve (also for the sibling-skill pointers to 'pipeline-model-architecture' and 'yaml-pipeline-transfer').

Add concrete criteria for distinguishing V1 vs V2 templates (e.g., specific APIs, table names, or version markers) so the '先分清 V1 还是 V2' instruction is actionable without the missing references.

Consolidate the PAC/store-mixing warning, which currently appears in both 快速指导 and 关键陷阱, into one section.

DimensionReasoningScore

Conciseness

The body is lean and assumes domain competence — no explanation of what BK-CI or pipelines are, and sections like "高信号规则" carry genuine non-obvious signal ("模板版本和实例版本要区分"). It falls short of the score-5 anchor because the PAC/store-mixing warning appears three times ("PAC 模板、商店模板、项目内模板不要混成一个心智模型", "把 PAC 模板问题误当成普通模板问题", "商店模板、项目模板、公共模板混用同一套权限和版本心智"), so not every token earns its place.

4 / 5

Actionability

The routing guidance is concrete (scenario → reference file mapping, V1/V2 distinction, a four-item impact checklist), but it defers all executable detail to "reference/1-template-foundation.md" through "reference/4-operations-extension.md" — none of which exist in the bundle — and never states how to actually tell V1 from V2. This matches 'Some concrete guidance but incomplete; missing key details' rather than score 4, whose guidance would be mostly executable.

3 / 5

Workflow Clarity

"快速指导" gives a clear numbered sequence (identify the main line → read the matching reference → distinguish V1/V2 → apply the four-item check) and step 4 provides a validation checklist for template changes ("模板资源持久化 / 实例化结果 / 版本兼容 / 模板关联流水线的更新影响"), so the batch-operation cap does not apply. It is not score 5 because checkpoints are guidance-level, with no explicit error-recovery loop or concrete verification commands.

4 / 5

Progressive Disclosure

The design is right — a short overview with four clearly signaled, one-level-deep reference files and a routing map — but every referenced path ("reference/1-template-foundation.md" … "reference/4-operations-extension.md") is missing from the bundle, and the directory name 'reference/' deviates from the conventional 'references/'. Scored against the actual bundle structure, every main line dead-ends at a nonexistent file, which is a functional failure of the disclosure layer; it is above score 1 only because navigation and signaling within the body itself are well organized.

2 / 5

Total

13

/

20

Passed

Description

92%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: third-person, concise, with a comprehensive list of concrete capabilities and an explicit trigger clause containing six natural user phrases. The only gap is limited synonym/variation coverage in the trigger terms.

DimensionReasoningScore

Specificity

The description lists six concrete capabilities — "创建、版本管理、实例化、权限控制、PAC 模板和商店集成" (creation, version management, instantiation, permission control, PAC templates, store integration) — which comprehensively covers the template-lifecycle domain. It matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' and is not merely naming the domain (score 3/4).

5 / 5

Completeness

It explicitly answers 'what' ("处理 BK-CI 流水线模板的创建、版本管理、实例化、权限控制、PAC 模板和商店集成") and 'when' with a concrete trigger clause ("当用户提到…时优先使用"), matching the anchor 'Clearly and explicitly answers both what AND when with concrete trigger phrases'. It is not score 4 because the 'when' clause is already explicit and trigger-phrase-based.

5 / 5

Trigger Term Quality

"当用户提到模板复用、模板版本、批量实例化、模板迁移、商店模板或 PAC 模板时优先使用" gives six natural phrases a BK-CI user would actually say, which is good coverage. It falls short of the score-5 anchor because synonyms and variations are missing (e.g., 模板发布/草稿, English terms like 'template', 'store/研发商店', or instantiation phrasing).

4 / 5

Distinctiveness Conflict Risk

The niche is clear (BK-CI pipeline template lifecycle) and every trigger is template-specific (模板复用、模板版本、批量实例化、模板迁移、商店模板、PAC 模板), giving minimal conflict risk. It is not score 4: even against the closely related pipeline-model skill, all triggers hinge on '模板' rather than '模型', so overlap risk is minimal.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
TencentBlueKing/bk-ci
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.