CtrlK
BlogDocsLog inGet started
Tessl Logo

project-module-architecture

处理 BK-CI 项目创建、项目属性、成员权限、项目标签、项目分片和项目资源边界时使用。当用户提到项目管理、projectId 含义、项目配置、成员管理或项目迁移时优先使用。

70

Quality

85%

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

82%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 concise, well-structured architecture overview with clear routing to reference files and concrete decision rules. Its main weakness is that the referenced reference files are absent from the bundle, and the workflow lacks explicit validation checkpoints.

Suggestions

Add the missing reference/1-project-foundation.md and reference/2-project-operations.md files (or correct the path) so the signaled navigation actually resolves.

Add an explicit validation/checkpoint step in the 快速指导 flow, e.g. confirm the question matches the chosen main line before acting, to lift workflow clarity toward 5.

Include one or two concrete lookup commands or exact field/table references (e.g. the T_PROJECT columns) to make the guidance fully actionable rather than conceptual.

DimensionReasoningScore

Conciseness

Lean bullet-based overview that assumes competence and never explains what BK-CI or a project is; every line earns its place, matching anchor 5.

5 / 5

Actionability

Provides specific decision rules (高信号规则, 关键陷阱) and reference routing, but as an instruction-only architecture skill it stops short of concrete lookup or verification steps, keeping it just below anchor 5.

4 / 5

Workflow Clarity

A clear triage sequence routes questions to the right reference file, but validation checkpoints are implicit rather than explicit, matching anchor 4 rather than 5.

4 / 5

Progressive Disclosure

Well-signaled one-level-deep references and a clean overview structure, but the referenced reference/ files do not exist in the bundle, so navigation is only partially verifiable — anchor 4 rather than 5.

4 / 5

Total

17

/

20

Passed

Description

87%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 strong, explicitly covering both capabilities and concrete use-when triggers scoped to the BK-CI Project module. Minor gap is that capabilities are framed as topic domains rather than discrete actions, keeping specificity just below the top anchor.

DimensionReasoningScore

Specificity

Lists several concrete capability domains (项目创建、项目属性、成员权限、项目标签、项目分片、项目资源边界), matching anchor 4 rather than 5 which expects discrete actions rather than topic domains.

4 / 5

Completeness

Explicitly states both what it handles and when to use it via the concrete '当用户提到…时…使用' trigger clause, matching the anchor-5 example.

5 / 5

Trigger Term Quality

Includes natural user phrasings (项目管理、成员管理、项目迁移、项目配置) plus the technical signal projectId, giving good keyword coverage without the synonym/extension density of anchor 5.

4 / 5

Distinctiveness Conflict Risk

Scoped to the BK-CI Project module with distinctive triggers (projectId 含义、项目分片), giving a clear niche with minimal conflict risk.

5 / 5

Total

18

/

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.