CtrlK
BlogDocsLog inGet started
Tessl Logo

00-bkci-global-architecture

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

67

Quality

80%

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

86%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 an exemplary lean navigation skill: concise, well-structured, and explicitly deferring detail to module-level skills. Its only soft spot is actionability/depth on a few module mappings, which are named rather than fully triggered.

DimensionReasoningScore

Conciseness

Lean ~60-line body with terse bulleted navigation and no padding or re-explanation of concepts Claude already knows; every line earns its place and assumes Claude's competence.

5 / 5

Actionability

Provides concrete, decision-ready guidance — a named 5-layer model, an ordered main pipeline link, a module→skill mapping table, and question→module attribution rules — with only minor gaps (some mappings name a skill without the trigger that selects it).

4 / 5

Workflow Clarity

Clear 4-step sequenced navigation workflow (build layer view → trace main link → pick skill by module boundary → judge problem attribution); no validation checkpoints, but none are warranted for non-destructive navigation, so it sits just below 5.

4 / 5

Progressive Disclosure

Well-organized into focused sections and explicitly acts as an overview that defers detail to per-module skills and reference/, keeping the file one level deep; no bundle files exist, and the section structure alone earns the top score for a navigation skill.

5 / 5

Total

18

/

20

Passed

Description

73%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 well-scoped to BK-CI's cross-module navigation niche with explicit, natural trigger phrases and a clear anti-conflict signal steering single-module work elsewhere. Its main weakness is that the 'what' is conveyed indirectly through use-cases rather than as a distinct capability statement.

Suggestions

Lead the description with a concise capability clause (e.g. 'Navigates BK-CI architecture and routes work to the correct module skill') before the 'Use when…' triggers, so 'what' and 'when' are both stated explicitly.

Add a couple of synonymous trigger terms (e.g. 'BK-CI 模块选型', '流水线链路定位', '不知道改哪个服务') to broaden natural-keyword coverage.

Optionally list the concrete actions as a short comma-separated set (module attribution, main-link tracing, skill selection) to lift specificity above the 1–2 action floor.

DimensionReasoningScore

Specificity

Names the BK-CI domain and 1–2 concrete actions ('判断某个需求应该落在哪个 BK-CI 模块', '理解流水线全链路协作'), but coverage is not comprehensive; it is a navigation skill, so the action list is inherently narrow.

3 / 5

Completeness

Explicitly answers 'when' ('用于…时使用') with concrete trigger phrases, and the 'what' (navigation + module attribution) is present but implied through the use-cases rather than stated as a crisp standalone capability, so it is not a clean 5.

4 / 5

Trigger Term Quality

Good coverage of natural trigger phrases a user would say ('跨模块开发', '排查链路归属', '判断某个需求应该落在哪个模块', '快速理解流水线全链路协作'), with a few common variations/synonyms missing.

4 / 5

Distinctiveness Conflict Risk

Clear niche (BK-CI global/cross-module navigation) with distinct triggers, and it explicitly differentiates from single-module skills ('单模块修改时优先读取对应模块 skill'), minimizing wrong-skill activation.

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.

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.