CtrlK
BlogDocsLog inGet started
Tessl Logo

00-bkci-global-architecture

用于跨模块开发、排查链路归属、判断某个需求应该落在哪个 BK-CI 模块,或需要快速理解流水线全链路协作时使用。单模块修改时优先读取对应模块 skill,而不是停留在这里。

63

Quality

79%

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 ./ai/skills/00-bkci-global-architecture/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 navigation skill: concise, concrete layer/chain/routing tables, and a clear orient-then-delegate workflow that appropriately pushes detail down to module skills. The only notable issue is redundancy between the '高信号规则' and '关键陷阱' sections and a routing map that covers only part of the listed skill set.

DimensionReasoningScore

Conciseness

The body is lean with no re-teaching of concepts Claude already knows, but '高信号规则' and '关键陷阱' each repeat the same two rules (switch to the module skill quickly; don't duplicate the global map), which could be merged into one section.

4 / 5

Actionability

Concrete guidance throughout: a named five-layer stack (OpenResty, MySQL/Redis/RabbitMQ/ES…), an ordered main chain, a question-to-module routing table, and 10 named sibling skills. Minor gaps remain — the trigger map covers only 6 of the 10 listed skills and skill locations/paths are unstated.

4 / 5

Workflow Clarity

The '快速指导' section gives a clear 4-step sequence (orient via the five-layer view, trace the main chain, pick a module skill, attribute questions via the mapping). No validation checkpoints are needed for this read-only navigation skill, but it lacks any confirm-you're-in-the-right-place checkpoint that would justify a 5.

4 / 5

Progressive Disclosure

No bundle files exist, and this short (~60 lines), well-sectioned router skill follows the short-skill pattern: it stays an overview and explicitly defers implementation detail to module skills or 'reference/', with nothing inlined that belongs elsewhere.

5 / 5

Total

17

/

20

Passed

Description

70%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 well-scoped trigger description with explicit use-when and use-not-when boundaries and strong distinctiveness within its skill family. Its main weakness is that the 'what' — the actual content the skill provides (architecture layers, main chain, routing rules) — is never stated, only implied through use-cases.

Suggestions

Add an explicit 'what' clause, e.g., '提供 BK-CI 五层架构视图、流水线主链路与模块归属判断', so the description answers both what it does and when to use it.

Include a few natural trigger synonyms users might say, such as '架构'、'全链路'、'服务划分', to broaden keyword coverage.

Name the five-layer view or the main chain in the description itself — currently the skill's core deliverables only appear in the body, weakening completeness and specificity.

DimensionReasoningScore

Specificity

The description lists several concrete use-cases ('排查链路归属', '判断某个需求应该落在哪个 BK-CI 模块', '理解流水线全链路协作'), but never states what the skill itself delivers (e.g., five-layer architecture view, main-chain overview, module routing map), leaving a coverage gap that keeps it below a 5.

4 / 5

Completeness

The 'when' is explicit ('用于…时使用' plus an explicit not-when clause for single-module changes), but the 'what' is only implied through use-cases — the description never says what the skill provides, so it falls short of anchor 4's requirement that both be explicitly present.

3 / 5

Trigger Term Quality

Terms like '跨模块', '链路', '流水线', and '模块' are natural phrases a BK-CI developer would say, giving good keyword coverage, though common variations such as '架构' or '服务归属' are missing — above anchor 3, below the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

It carves a clear global-navigation niche distinct from the many sibling module skills and explicitly defers single-module work ('单模块修改时优先读取对应模块 skill,而不是停留在这里'), giving minimal conflict risk.

5 / 5

Total

16

/

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.