CtrlK
BlogDocsLog inGet started
Tessl Logo

common-technical-practices

处理 BK-CI 后端中的横切技术实践时使用,例如 AOP、分布式锁、重试、参数校验、性能监控、定时任务和审计日志。当用户要实现这类框架级实践而不是具体业务功能时优先使用。

64

Quality

76%

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/common-technical-practices/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 clean, well-organized router/index skill with explicit decision criteria and lean prose, but its progressive disclosure and actionability are materially weakened because all seven referenced reference files are missing from the bundle and the reference list is duplicated.

Suggestions

Ship the seven referenced files under reference/ (1-aop-aspect.md through 7-audit-logging.md) so the routed destinations actually resolve.

Remove the duplicated reference list in 延伸阅读, or keep only one canonical mapping and link to it from both sections.

Add at least one concrete, executable snippet or command per topic inline so the skill is actionable even before a reference file is opened.

DimensionReasoningScore

Conciseness

Lean sections with no over-explanation of concepts Claude already knows, but the seven-file reference list is duplicated in both "快速指导" and "延伸阅读", a minor waste that could be trimmed.

4 / 5

Actionability

Concrete per-topic routing to specific reference paths is given, but the referenced files do not exist in the bundle and there is no executable code or commands, leaving the guidance incomplete.

3 / 5

Workflow Clarity

The 快速指导 numbered routing procedure is clearly sequenced and paired with explicit 适用场景/不适用场景 decision criteria; no destructive or batch operations are involved so missing validation loops are acceptable.

4 / 5

Progressive Disclosure

Structure and one-level-deep reference signaling are good in intent, but every referenced file (reference/1-aop-aspect.md … reference/7-audit-logging.md) is absent from the bundle, so the overview points to nothing and disclosure is undermined.

3 / 5

Total

14

/

20

Passed

Description

88%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, well-scoped description that clearly states what the skill handles and when to prefer it, with concrete practice terms as triggers. Voice is appropriately third-person and it carves a distinct niche, with only minor synonym coverage and sibling-skill overlap concerns.

DimensionReasoningScore

Specificity

Lists multiple concrete practices — "AOP、分布式锁、重试、参数校验、性能监控、定时任务和审计日志" — giving comprehensive coverage of specific capabilities rather than vague abstractions.

5 / 5

Completeness

Explicitly answers both what ("处理 BK-CI 后端中的横切技术实践") and when ("当用户要实现这类框架级实践而不是具体业务功能时优先使用") with a concrete trigger phrase.

5 / 5

Trigger Term Quality

Natural domain terms a backend developer would actually say (AOP, 分布式锁, 重试, 定时任务, 审计日志) are present with good coverage, though a few common synonyms/variants (e.g. 切面/aspect, 幂等) are missing.

4 / 5

Distinctiveness Conflict Risk

Clear niche (framework-level cross-cutting practices vs. business functions) with an explicit boundary clause, but minor overlap risk with closely related sibling skills (utility-components, microservice-infrastructure).

4 / 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.