CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-module-architecture

处理 BK-CI Agent 构建机侧能力时使用,例如守护进程、心跳、Ask 轮询、任务拉起、升级更新和与 Dispatch/Worker 的协作。当用户要改构建机宿主侧行为而不是 Worker 执行细节时优先使用。

68

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

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

Well-organized, concise routing skill body with clear scoping and sequencing, undermined by progressive-disclosure references that point to bundle files that are not actually present.

Suggestions

Create the referenced reference/1-runtime-upgrade.md, reference/2-ask-heartbeat-build.md, and reference/3-platform-ops.md files, or remove the references if the content is not yet available.

De-duplicate the three reference paths that appear in both 快速指导 and 延伸阅读 to tighten the body.

Add a one-line summary of what each reference file covers so Claude can route without opening every file.

DimensionReasoningScore

Conciseness

Lean and free of concept-overexplaining fluff, with only minor redundancy from listing the same three reference files in both 快速指导 and 延伸阅读.

4 / 5

Actionability

Provides concrete routing rules and explicit skill-switching guidance; as a routing skill it is actionable without code, though it does not summarize what each referenced file contains.

4 / 5

Workflow Clarity

A clear sequenced 1-5 快速指导 maps problem types to references, plus 适用/不适用 boundaries; this is not a destructive/batch operation so the validation cap does not apply.

4 / 5

Progressive Disclosure

The body is well-structured and repeatedly points to reference/*.md files, but the references/ directory does not exist, so the signaled navigation leads to missing files.

3 / 5

Total

15

/

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, third-person description that names concrete capabilities and gives explicit, discriminating use-when guidance, cleanly separating it from adjacent Worker and Dispatch skills.

DimensionReasoningScore

Specificity

Lists multiple concrete Agent-side capabilities — 守护进程、心跳、Ask 轮询、任务拉起、升级更新、与 Dispatch/Worker 的协作 — giving comprehensive coverage of the domain.

5 / 5

Completeness

Explicitly states both what (处理 BK-CI Agent 构建机侧能力) and when (当用户要改构建机宿主侧行为…时优先使用) with concrete trigger phrasing.

5 / 5

Trigger Term Quality

Includes natural trigger phrases users would say (改构建机宿主侧行为, 心跳, 任务拉起, 升级) with a clear discriminator, though a few synonyms are missing and there are no file extensions to cite.

4 / 5

Distinctiveness Conflict Risk

Clearly scoped niche that explicitly disambiguates against Worker and Dispatch, minimizing conflict risk with sibling skills.

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.

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