CtrlK
BlogDocsLog inGet started
Tessl Logo

kotlin-backend-conventions

编写 BK-CI Kotlin 后端代码时使用,例如 Kotlin 文件结构、格式、命名、函数设计、空安全和 BK-CI 项目内的调用约定。当用户要修改 `.kt` 或 `.kts` 后端代码并需要项目级 Kotlin 规范时优先使用。

57

Quality

72%

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/kotlin-backend-conventions/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

42%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 works as a routing/index document but delivers almost no actionable convention content itself, and its three referenced detail files are missing from the skill bundle, leaving the routing dangling. Redundant double-listing of the references and meta-commentary sections add tokens without guidance.

Suggestions

Add the referenced bundle files (reference/1-file-format-import.md, reference/2-naming-function-design.md, reference/3-null-safety-project-practice.md) or remove the dangling references — currently every navigation pointer in the body is broken.

Inline the few genuinely high-signal BK-CI rules with concrete values (e.g., the actual line-width limit, a wildcard-import example, when named parameters are required) so the skill is actionable even before reading a reference file.

Remove the duplicate file listing (重复出现在 快速指导 and 延伸阅读) and the skill-authoring meta sections (高信号规则/关键陷阱) to tighten token usage.

DimensionReasoningScore

Conciseness

The body is mostly lean but contains redundancy and padding: the three reference files are listed twice ("快速指导" item 2 and again in "延伸阅读"), and sections like "高信号规则"/"关键陷阱" are skill-authoring meta-commentary ("把通用 Kotlin 教程内容原样塞进规则层") rather than task guidance. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not a 2 because there is no teaching of concepts Claude already knows.

3 / 5

Actionability

Guidance is almost entirely high-level routing — "分三块看" pointing to reference files — with only vague hints like "例如行宽、命名参数、禁止 wildcard import" and no concrete values, commands, or code examples. This matches 'minimal concrete guidance; high-level hints but missing the specific steps to execute'; it is not a 3 because even the few concrete rules lack specifics and the referenced detail files are absent from the bundle.

2 / 5

Workflow Clarity

"快速指导" lists a rough sequence (consult three reference docs, prioritize project-specific conventions) but the routing targets do not exist in the bundle and there are no checkpoints. This matches 'steps listed but validation gaps; sequence present but checkpoints missing or implicit'.

3 / 5

Progressive Disclosure

References are clearly labeled and one level deep (three topic-mapped files plus cross-skill pointers), which is good structure in principle — but the referenced files (reference/1-file-format-import.md, reference/2-naming-function-design.md, reference/3-null-safety-project-practice.md) are not present in the bundle at all, so navigation is broken. This sits between 'references present but not clearly signaled' and 'references mostly clear with minor organization gaps'; the missing files keep it at 3 rather than 4.

3 / 5

Total

11

/

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: it states both what it covers (Kotlin file structure, formatting, naming, function design, null safety, BK-CI calling conventions) and an explicit, concrete trigger clause for modifying .kt/.kts backend code. It carves out a distinct niche with minimal conflict risk.

DimensionReasoningScore

Specificity

Names the domain (BK-CI Kotlin backend) and several concrete capability areas ("Kotlin 文件结构、格式、命名、函数设计、空安全和 BK-CI 项目内的调用约定"), which matches the 'several specific actions; minor gaps' anchor. It is not a 5 because it describes convention areas rather than a comprehensive set of concrete actions.

4 / 5

Completeness

Explicitly answers both what ("编写 BK-CI Kotlin 后端代码时使用,例如 Kotlin 文件结构、格式、命名、函数设计、空安全...") and when ("当用户要修改 `.kt` 或 `.kts` 后端代码并需要项目级 Kotlin 规范时优先使用") with concrete trigger phrases. Not a 4 because the 'when' clause is already explicit and specific.

5 / 5

Trigger Term Quality

Includes natural trigger terms users would say — "Kotlin", "BK-CI", and file extensions ".kt 或 .kts 后端代码" — giving good keyword coverage. Not a 5 because common variations such as "代码风格" (code style) or reviewing Kotlin code are missing; not a 3 because extensions and a natural trigger phrase are present.

4 / 5

Distinctiveness Conflict Risk

A clear niche — project-level Kotlin conventions for BK-CI specifically — with distinct triggers (.kt/.kts backend code) that would not fire for generic Kotlin, backend-layering, or Spring Boot skills. 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.

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.