CtrlK
BlogDocsLog inGet started
Tessl Logo

springboot-backend-conventions

编写 BK-CI Spring Boot 后端代码时使用,例如配置管理、Bean 装配、事务与数据访问、异常处理、监控和框架层最佳实践。当用户要处理 Spring Boot 框架用法而不是服务归属或语言风格时优先使用。

64

Quality

75%

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

Quality

Content

63%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 lean, well-organized overview/index skill that orients the reader and points to per-area reference files and related skills. Its main weakness is that the referenced bundle files are absent, which undermines both actionability and navigation.

Suggestions

Add the three referenced files (reference/1-config-bean.md, reference/2-data-transaction-exception.md, reference/3-observability-testing-quality.md) to the bundle so navigation resolves.

Move concrete, executable Spring Boot practices (e.g. constructor injection examples, @Transactional boundary patterns) into the reference files so the skill delivers actionable guidance, not just pointers.

Drop the duplicate reference listing in 延伸阅读 or merge it with the 快速指导 list to remove redundancy and tighten token use.

DimensionReasoningScore

Conciseness

The body is short and sectioned with bullets and does not explain concepts Claude already knows, but the 延伸阅读 section repeats the same three reference files already listed in 快速指导, a minor redundancy that keeps it off 5.

4 / 5

Actionability

A few concrete rules appear ("优先使用构造器注入、类型安全配置和明确的生命周期边界"), but most actionable detail is deferred to reference files that are not present in the bundle, leaving guidance incomplete.

3 / 5

Workflow Clarity

The 快速指导 numbered list gives a coherent orientation sequence (orient → split into 3 areas → apply rules → cross-link skills) and the body is clearly organized for a single-purpose navigation skill, though it lacks explicit checkpoints.

4 / 5

Progressive Disclosure

Structure is clean with one-level-deep signaled references (reference/1, 2, 3) plus cross-skill links, but the referenced files do not exist in the bundle, so navigation is broken and cannot reach the 4 anchor.

3 / 5

Total

14

/

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.

A well-crafted description that explicitly covers what the skill does, when to use it, and how it differs from neighboring skills. It is concise and uses a concrete trigger clause rather than vague phrasing.

DimensionReasoningScore

Specificity

The description names concrete capability areas ("配置管理、Bean 装配、事务与数据访问、异常处理、监控和框架层最佳实践") which are specific domains, though framed as topic categories rather than the crisp executable actions (e.g. "extract text, fill forms") of the 5 anchor.

4 / 5

Completeness

Both 'what' (writing BK-CI Spring Boot backend code across config/bean/transaction/exception/monitoring) and 'when' ("当用户要处理 Spring Boot 框架用法而不是服务归属或语言风格时优先使用") are explicitly stated with a concrete trigger clause.

5 / 5

Trigger Term Quality

Natural developer-facing keywords are present (Spring Boot, 配置, Bean, 事务, 异常处理, 监控) with an explicit trigger phrase "当用户要处理 Spring Boot 框架用法...", but it lacks some common synonyms/variations that would push it to 5.

4 / 5

Distinctiveness Conflict Risk

The description actively carves out a niche and excludes adjacent concerns ("而不是服务归属或语言风格"), reducing overlap with microservice-ownership and Kotlin-style skills to 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.