CtrlK
BlogDocsLog inGet started
Tessl Logo

springboot-backend-conventions

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

56

Quality

70%

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

38%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 SKILL.md body is a clean, well-organized index with sensible scope boundaries, but it is an index to nothing: all three referenced detail files (and both sibling-skill links) are missing from the bundle, leaving only abstract principles as actual guidance. Redundant reference listings and meta-commentary about rule/skill authoring add noise without adding Spring Boot content.

Suggestions

Ship the three referenced detail files (config/Bean, data/transaction/exception, observability/testing/quality) under references/ and fix the paths in the body — currently every reference link is dangling, which breaks both actionability and navigation.

Remove the duplicated file listing (keep it in one place, e.g. 延伸阅读) and replace the meta-commentary in 高信号规则/关键陷阱 about rule-vs-skill authoring with actual Spring Boot pitfalls (e.g., transaction boundary mistakes, misuse of field injection).

Add a few concrete, executable patterns inline — e.g., a constructor-injection example with @ConfigurationProperties — so the skill delivers actionable guidance even before the reference files are opened.

DimensionReasoningScore

Conciseness

The body is short and free of concept explanations Claude already knows, but it could be tightened: the three reference files are listed twice ("快速指导" item 2 and again verbatim in "延伸阅读"), and "高信号规则"/"关键陷阱" contain meta-commentary about skill/rule authoring ("把长篇框架说明放进 always rule,导致常驻噪声过高") rather than Spring Boot guidance. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened'.

3 / 5

Actionability

Guidance stays high-level — "优先使用构造器注入、类型安全配置和明确的生命周期边界" and "能由框架和基础设施托底的约束,不要在业务代码里重复手工实现" are principles, not executable steps — and the concrete detail is delegated to `reference/1-config-bean.md`, `reference/2-data-transaction-exception.md`, and `reference/3-observability-testing-quality.md`, none of which exist in the bundle (no references/, scripts/, or assets/ directories are present). This matches 'minimal concrete guidance; high-level hints but missing the specific steps to execute'.

2 / 5

Workflow Clarity

"快速指导" provides a usable triage sequence (classify the question into config/Bean vs. data/transaction/exception vs. observability, then consult the matching reference, with cross-links to sibling skills for out-of-scope questions), matching 'steps listed but validation gaps'. No validation or verification checkpoints exist, and the load-bearing step (read the reference file) cannot actually be executed since the files are missing.

3 / 5

Progressive Disclosure

Although the body is well-sectioned and signals one-level-deep references clearly, every referenced path is dangling: `reference/1-config-bean.md`, `reference/2-data-transaction-exception.md`, `reference/3-observability-testing-quality.md` (and sibling skills `backend-microservice-development`, `microservice-infrastructure`) do not exist anywhere in the bundle — the reference/ directory itself is absent. Per the guideline to score against the actual bundle structure, navigation is effectively broken, fitting the 'minimal structure / references buried' level rather than the well-organized higher anchors.

2 / 5

Total

10

/

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 strong description: it states a concrete scope with an explicit 'use when' trigger clause and deliberate boundary guidance against adjacent skills (service ownership, language style). Trigger-term coverage is good though it lacks a few common synonyms and concrete framework artifacts.

DimensionReasoningScore

Specificity

The description names the domain ("BK-CI Spring Boot 后端代码") and enumerates several concrete capability areas — "配置管理、Bean 装配、事务与数据访问、异常处理、监控和框架层最佳实践" — which matches the 'several specific actions with minor gaps' anchor. It falls short of 5 because these are topic nouns rather than concrete actions, and coverage gaps exist (e.g., dependency injection, testing are only implied).

4 / 5

Completeness

Both questions are explicitly answered: what it covers ("配置管理、Bean 装配、事务与数据访问、异常处理、监控和框架层最佳实践") and when to use it ("当用户要处理 Spring Boot 框架用法而不是服务归属或语言风格时优先使用"), an explicit 'use when' clause with concrete trigger conditions. It clearly matches the top anchor and exceeds the 'when could be more explicit' level-4 anchor.

5 / 5

Trigger Term Quality

It contains the natural keywords a user would say — "Spring Boot", "配置", "Bean", "事务", "数据访问", "异常处理", "监控" — giving good coverage per the 'good keyword coverage, a few natural terms missing' anchor. It misses common variations like 依赖注入/DI, @Autowired, or application.yml, so it does not reach comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (Spring Boot framework practices within BK-CI) and explicitly disambiguates against sibling scopes — "不是服务归属或语言风格" — minimizing wrong-skill triggering. This matches the 'clear niche with distinct triggers; minimal conflict risk' anchor.

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.