CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

eval-harness

克劳德代码会话的正式评估框架,实施评估驱动开发(EDD)原则

1.70x
Quality

56%

Does it follow best practices?

Impact

99%

1.70x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./docs/zh-CN/skills/eval-harness/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%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 body is well-structured and gives solid coverage of eval types, grader types, metrics (pass@k, pass^k), a define→implement→evaluate→report workflow, and best practices, with several executable code-grader examples. Its weaknesses are placeholder pseudocode in the evaluate step, an undefined /eval command surface with no backing scripts, no failure-recovery feedback loop, and repeated template/example content that inflates length without adding new information.

Suggestions

Replace the placeholder evaluate step ("[Run each capability eval, record PASS/FAIL]") with executable commands, and define what /eval define/check/report actually invoke since no scripts bundle them (actionability).

Add an explicit feedback loop to the workflow, e.g. "If any regression eval fails, fix and re-run until pass^3 = 100% before generating the report" (workflow_clarity).

Deduplicate the eval format, which appears three times (评估类型, 工作流程 定义, and the 示例 section): keep one template plus one worked example and move extras to a references/ file (conciseness, progressive_disclosure).

DimensionReasoningScore

Conciseness

The body is mostly tight lists and templates with no basic-concept padding, but the eval format is demonstrated three times (the "[能力评估:功能名称]" template, the "评估定义:功能-xyz" workflow template, and the full "示例:添加身份验证" section) and the 理念 section explains methodology philosophy. This is "mostly efficient but could be tightened" rather than the "minor trim" of anchor 4.

3 / 5

Actionability

It provides genuinely executable grader commands ("grep -q \"export function handleAuth\" src/auth.ts && echo \"PASS\"", "npm test -- --testPathPattern=\"auth\"") and copy-paste templates, but the core evaluate step is placeholder pseudocode ("[Run each capability eval, record PASS/FAIL]" and a bare "# Generate report"), the "/eval define|check|report" commands have no defined implementation anywhere in the bundle, and a template contains the typo "标准 标准 3". This lands on "some concrete guidance but incomplete".

3 / 5

Workflow Clarity

The four-phase sequence (定义 → 实现 → 评估 → 报告) is clearly ordered with per-phase templates, but the evaluate step runs a batch of eval suites with no explicit validation feedback loop — nothing says "if an eval fails, fix and re-run before reporting". Per the rubric's batch-operation cap ("missing validation/verification steps in workflows involving batch operations should cap workflow clarity at 3"), this cannot exceed 3 despite the clear sequence.

3 / 5

Progressive Disclosure

No bundle files exist and the single file is well-sectioned with clear headers, but at ~270 lines the repeated eval templates and the full worked "示例:添加身份验证" example are inlined content that would be better split into a references/ file (e.g. EXAMPLES.md or TEMPLATES.md). This matches "some structure but could be better organized"; not 4 because content that should be separate is inline.

3 / 5

Total

12

/

20

Passed

Description

45%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.

The description identifies its domain and niche concept (EDD) in third person, but it reads as a category label rather than a capability statement: it lists no concrete actions, provides no "use when" trigger guidance, and includes few natural trigger synonyms. It is serviceable but below the quality of the reference good examples, which pair actions with explicit trigger phrases.

Suggestions

Add 2-3 concrete actions to the description, e.g. "定义能力/回归评估、创建代码/模型/人工评分器、以 pass@k 与 pass^k 指标衡量可靠性" (specificity).

Add an explicit trigger clause, e.g. "Use when setting up evals for AI-assisted workflows, defining task pass/fail criteria, or creating regression test suites for prompt or agent changes" (completeness).

Include natural trigger terms users would actually say: 评估, 测试, 回归测试, 基准测试, pass@k (trigger_term_quality).

DimensionReasoningScore

Specificity

The description "克劳德代码会话的正式评估框架,实施评估驱动开发(EDD)原则" names its domain (evaluation framework, EDD, Claude Code sessions) but lists no concrete actions, matching "Names the domain but actions are minimal or generic". It is above anchor 1 because the domain is specific rather than purely abstract, and below anchor 3 because no capabilities such as "define pass/fail criteria" or "run regression suites" are stated.

2 / 5

Completeness

It gives a clear "what" ("正式评估框架…实施评估驱动开发(EDD)原则") but no "Use when…" clause or any equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 2 because the "what" is clear; not 4 because "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

It contains some relevant keywords ("评估框架", "评估驱动开发(EDD)", "克劳德代码") but misses the natural phrases a user would say, such as 测试, 回归测试, 基准测试, or pass@k. This fits "Some relevant keywords but missing common variations or synonyms"; it is not 4 because keyword coverage is thin.

3 / 5

Distinctiveness Conflict Risk

Scoping to "克劳德代码会话" and EDD gives it a niche, but the broad term "评估" (evaluation) could overlap with general testing, code-review, or QA-oriented skills, matching "Somewhat specific but could still overlap with similar skills". Not 4 because without distinct trigger phrases the overlap risk with testing/review skills is more than minor.

3 / 5

Total

11

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

xu-xiang/everything-claude-code-zh

Path

docs/zh-CN/skills/eval-harness/SKILL.md

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.