design-patterns

在 BK-CI 中判断何时使用工厂、策略、责任链、观察者、模板方法、装饰器等设计模式时使用。当用户要重构可扩展结构、统一模式选型、理解项目里的模式落点时优先使用。

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./ai/skills/design-patterns/SKILL.md

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 well-structured, concise instruction skill for BK-CI design-pattern selection with a clear decision workflow, undermined by references to bundle files that do not exist. The conceptual guidance is strong, but the deep-dive navigation it relies on is missing.

Suggestions

Create the referenced bundle files (reference/1-core-patterns.md, reference/2-selection-guidelines.md, reference/3-project-examples.md) so the quick-guide and 延伸阅读 links resolve, or inline the essential pattern details and drop the dangling references.

Reduce the mild redundancy between 适用场景, 快速指导, and 高信号规则 so each section earns its tokens distinctly.

Add a short concrete BK-CI-specific example (e.g., a real extension-point or if-else dispatch in the project) inline so the skill is actionable even before consulting the reference files.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude knows the patterns (no 'a factory is a creational pattern...' padding), with punchy one-line rules; slight redundancy between 适用场景, 快速指导, and 高信号规则 keeps it from a 5.	4 / 5
Actionability	The quick-guide decision tree and 高信号规则 heuristics give concrete selection guidance, but the primary actionable path repeatedly points to reference/*.md files that do not exist in the bundle, leaving the executable guidance incomplete.	3 / 5
Workflow Clarity	快速指导 is a clearly ordered 5-step decision flow (classify problem → respect module boundaries → gauge complexity → prefer patterns for extension points → check existing implementations); no validation checkpoints, but none are required for a non-destructive selection task.	4 / 5
Progressive Disclosure	The design is sound — a concise overview with one-level-deep, clearly signaled references in 延伸阅读 — but the referenced bundle files (reference/1-core-patterns.md, 2-selection-guidelines.md, 3-project-examples.md) are absent, so navigation is broken against the actual bundle structure.	3 / 5
	Total	14 / 20 Passed

Description

83%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, third-person description that clearly states both what the skill does and when to use it, with concrete pattern-name triggers and a well-scoped niche. Minor gains are available in trigger-term breadth and overlap delineation.

Dimension	Reasoning	Score
Specificity	It names the domain (BK-CI) and several concrete actions — 判断何时使用设计模式, 重构可扩展结构, 统一模式选型, 理解模式落点 — with only minor coverage gaps versus the comprehensive 5 anchor.	4 / 5
Completeness	It explicitly answers both what (judge when to use these design patterns) and when (当用户要重构可扩展结构、统一模式选型、理解项目里的模式落点时优先使用), matching the concrete-trigger-phrase anchor.	5 / 5
Trigger Term Quality	Natural developer terms are well covered — the six pattern names (工厂、策略、责任链、观察者、模板方法、装饰器), 设计模式, 重构, 模式选型 — with a few common phrasings (e.g., 'if-else 重构', '扩展点') absent.	4 / 5
Distinctiveness Conflict Risk	The BK-CI + design-pattern-selection niche is distinct with specific triggers, but '重构可扩展结构' has some overlap risk with general refactoring and the adjacent utility-components / common-technical-practices skills noted in the body.	4 / 5
	Total	17 / 20 Passed

Validation

100%

Warnings & errors only

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
Path: ai/skills/design-patterns/SKILL.md
Commit: 94743cb

Reviewed: about 8 hours ago

Table of Contents

Discovery Implementation Validation

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.