CtrlK
BlogDocsLog inGet started
Tessl Logo

business-knowledge-workflow

获取陌生业务知识并沉淀为 BK-CI skill 或架构文档时使用,例如阅读 iWiki、结合代码交叉验证、提炼模块边界和重写知识文档。当用户要先理解业务再写文档时优先使用。

56

Quality

71%

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/business-knowledge-workflow/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%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, token-efficient overview with clear scope sections and a sensible three-stage philosophy of 'understand, verify, then distill'. Its critical weakness is that all executable detail is outsourced to reference files that are missing from the bundle, leaving the skill as a pointer sheet with principles but no procedures.

Suggestions

Ship the three referenced files (1-document-discovery.md, 2-code-cross-check.md, 3-skill-distillation.md) in the bundle — or inline their key steps — since the entire executable workflow currently lives in files that do not exist; also align the path prefix (body says `reference/` while the convention is `references/`).

Add per-stage checkpoints and an error-recovery rule, e.g. what to do when the iWiki description and the code disagree (which source wins, how to record the discrepancy), so the 'cross-validate' stage has an explicit feedback loop.

Deduplicate navigation: the reference list and the `skill-writer` pointer each appear twice (快速指导 and 延伸阅读); keep a single "延伸阅读" section to save tokens.

DimensionReasoningScore

Conciseness

The body is lean with no padding or explanation of concepts Claude already knows — rules like "文档内容默认不可信…必须经过代码或运行链路验证" are high-signal. It loses a point to duplication: the three reference paths appear verbatim in both "快速指导" and "延伸阅读", and the "skill-writer" pointer is repeated twice, which could be trimmed to one navigation block.

4 / 5

Actionability

Guidance is directional but not executable: the three-stage process (发现 → 交叉验证 → 沉淀) and priorities ("模块边界、关键对象、主链路和常见坑") are concrete in intent, but every actual procedure is delegated to "reference/1-document-discovery.md" etc., and those files are not in the bundle — leaving the skill with principles and no steps. This matches the 'some concrete guidance but incomplete; missing key details' anchor rather than the mostly-executable level of a 4.

3 / 5

Workflow Clarity

The three-stage sequence is clearly named and stage 2 acts as a validation checkpoint ("必须经过代码或运行链路验证"), which keeps it above the 2 anchor. However, per-stage steps and error-recovery guidance are absent — e.g. what to do when "业务文档和代码实现经常不完全一致" is observed is never stated, and the detail is deferred to missing files — fitting the 'steps listed but checkpoints implicit' anchor rather than a 4.

3 / 5

Progressive Disclosure

The body signals one-level-deep references cleanly (dedicated "延伸阅读" section plus inline pointers), but none of the three referenced files — "reference/1-document-discovery.md", "reference/2-code-cross-check.md", "reference/3-skill-distillation.md" — exist in the bundle (no references/ directory is present), so the navigation scheme points at nothing and the skill's substance is unreachable. Scored against the actual bundle structure, this is a broken disclosure layout rather than the 'minor organization gaps' of a 4, but the in-body structure itself keeps it above the monolithic/buried-reference level of 1.

2 / 5

Total

12

/

20

Passed

Description

75%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 solid description that explicitly states both what the skill does and when to use it, with domain-specific trigger terms (iWiki, BK-CI, 代码交叉验证). Its main limitation is a single trigger scenario and slightly generic phrasing on the documentation-rewrite action, keeping it just below the top anchors.

DimensionReasoningScore

Specificity

The description names the domain (BK-CI business knowledge) and several concrete actions — "阅读 iWiki", "结合代码交叉验证", "提炼模块边界", "重写知识文档", "沉淀为 BK-CI skill 或架构文档" — which matches the 'several specific actions; minor gaps' anchor. It does not reach 5 because actions like "重写知识文档" remain somewhat generic and the coverage of the downstream workflow is thin; it is clearly above the '1-2 concrete actions' anchor.

4 / 5

Completeness

Both parts are explicit: 'what' is "获取陌生业务知识并沉淀为 BK-CI skill 或架构文档…" and 'when' is the explicit trigger clause "当用户要先理解业务再写文档时优先使用". It sits below the 5 anchor because only a single trigger scenario is given, whereas the top anchor expects multiple concrete trigger phrases ("…or when the user mentions X, Y, Z"); it is clearly above 3 since the 'when' clause is explicit, not merely implied.

4 / 5

Trigger Term Quality

Natural trigger terms a BK-CI developer would say are present — "iWiki", "BK-CI", "代码交叉验证", "架构文档", "先理解业务再写文档". A few common variations are missing (e.g. "熟悉/梳理一个模块", "读代码理解逻辑"), which fits the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive-synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The BK-CI/iWiki niche and the 'understand-before-document' framing give it distinct triggers with minimal overlap against generic skills. There is minor overlap risk with general documentation-writing or skill-authoring skills (the body itself links to "skill-writer"), matching the 'mostly distinct; minor overlap risk' anchor rather than the clean niche of a 5.

4 / 5

Total

16

/

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.