CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

product-feature-tech-implement

基于功能设计文档与现有源码,端到端实现一个产品功能:开发、代码 review、测试用例编写与执行, 循环迭代直到测试通过,最终产出用户手册与实现总结文档(保存到当前项目 markdown/ 目录)。 触发条件:用户提供了功能设计文档(PRD/设计文档/需求描述)+ 源码目录(或代码库路径), 并希望"实现这个功能"、"开发这个功能"、"把这个设计文档变成代码"、"做这个功能的开发+测试"、 "完整实现并测试"、"端到端开发",或明确要求按"开发-review-测试"循环推进直到测试通过。 也适用于需要额外运行环境的开发任务,例如 PostgreSQL/MySQL 等数据库插件开发 (可能需要编译、搭建实例、配置参数、初始化、跑测试)、需要启动服务进程才能测试的后端功能、 需要特定运行时环境的库或框架功能。 即使用户只是说"帮我把这个功能做出来"、"按设计文档实现一下"、"这个功能开发完了麻烦测试一下", 但同时给出了设计文档和代码路径,也应使用本 skill。 本 skill 的核心是严格的"开发 ⇄ Review"循环 + "测试者不预先看代码"的盲测试原则, 因此当用户提到"独立测试"、"测试不能看代码"、"先写测试用例再看代码"、"black-box 测试"时, 也应优先使用本 skill。 不适用于:只是要求"写一个脚本"、"改一行代码"、"快速修一个 bug"等轻量级、 无需走完整开发-review-测试闭环的任务;也不适用于纯粹的代码评审(无需新开发功能) 或纯粹的测试用例编写(无设计文档、无需开发)这类单一环节请求—— 这些更适合直接处理而非套用本 skill 的完整闭环流程。

64

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

58%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 workflow logic is excellent — a clearly drawn state machine with explicit review/test gates, state persistence, and stall-detection escalation rules. However, the bundle is incomplete: all three role-definition files referenced under agents/ are missing, and the body carries noticeable motivational padding, so overall execution guidance and navigation fall short of the top anchors.

Suggestions

Ship the missing agents/developer.md, agents/reviewer.md, and agents/tester.md files (or inline each role's input/output format into the body) — the tester blind-testing rules in particular currently live only in a file that does not exist.

Cut the '为什么要盲测试' section and the scattered justificatory asides down to the 2-3 operative rules (tester reads design doc only; prompt must not contain code paths; test cases must cite design-doc sections).

Replace the environment-specific tool mention `ask_user_input_v0` with a generic instruction ('ask the user directly or via the available input tool') so the skill is portable across runtimes.

DimensionReasoningScore

Conciseness

The core operational content (state machine, state-file schema, role pointers, escalation criteria) is dense and earns its tokens, but there is real padding: the '为什么要盲测试' rationale section, and chatty commentary like '不是走流程,是这一步存在的全部意义' and '谁也说不准', are motivational prose Claude does not need to execute the workflow. It fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than 2, because the excess is commentary around genuinely tight instructions, not redundant concept explanation throughout.

3 / 5

Actionability

Concrete elements exist — the state file path `markdown/.feature_implement_state.json` with a full JSON example, deliverable filenames `markdown/{功能名}_用户手册.md`, explicit tester-prompt isolation rules, and measurable escalation criteria ('同一个问题被打回两次以上', '测试报告和上一轮几乎一样'). But the key execution details are delegated away: '三个角色的详细职责、输入输出格式、产出要求都写在 agents/ 目录下' — and those agents/developer.md, agents/reviewer.md, agents/tester.md files do not exist in the bundle, leaving the per-role input/output formats as missing key details. This keeps it below 4 despite otherwise executable guidance.

3 / 5

Workflow Clarity

The multi-step process is exceptionally sequenced: an ASCII state machine diagram, explicit gates ('review 通过' before testing, '测试失败' back to loop A), per-iteration history recording, a test_suite_written reuse rule to prevent rework, and explicit stall detection with defined escalation conditions. Feedback loops and error-recovery paths (test failure → targeted bug fix → re-run new + existing tests) are the core of the document, matching the top anchor.

5 / 5

Progressive Disclosure

The in-body structure and signaling are good — sections are clear, references/postgres-extension.md exists and is properly one level deep — but three of the four referenced files (agents/developer.md, agents/reviewer.md, agents/tester.md) are absent from the bundle, breaking the disclosure chain exactly where the bulk of the role instructions is supposed to live. A reader following '进入对应阶段时去读' hits nonexistent paths, so navigation fails at the core content despite good organization; this sits below 3 ('references present but not clearly signaled') because the problem is not signaling but broken reference targets.

2 / 5

Total

13

/

20

Passed

Description

95%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 defines a distinct multi-stage workflow, provides an explicit trigger section with many natural user phrasings, and carves out clear non-goals. The only weakness is mild verbosity from restated trigger scenarios, which keeps specificity just below the top anchor.

Suggestions

Trim the near-duplicate trigger paragraphs (the '即使用户只是说…' paragraph repeats scenarios already listed under 触发条件) — the same coverage fits in roughly half the tokens.

Make the action list slightly more concrete by naming the loop artifacts inline (state file, test report, 用户手册/实现总结 filenames) instead of the generic '开发' and '代码 review'.

DimensionReasoningScore

Specificity

The description lists the full concrete action pipeline — '开发、代码 review、测试用例编写与执行,循环迭代直到测试通过,最终产出用户手册与实现总结文档' — covering development, review, test writing/execution, iteration, and concrete deliverables saved to markdown/. It falls short of a 5 only because the pipeline actions are stated at a fairly high level ('开发', '代码 review' are generic verbs) and the trigger section restates near-duplicate scenarios, adding padding rather than new specificity.

4 / 5

Completeness

Explicitly answers both what (end-to-end implement: dev + review + test + iterate until pass, producing user manual and implementation summary in markdown/) and when ('触发条件:用户提供了功能设计文档…+ 源码目录', extended environment cases like PostgreSQL/MySQL plugin development, and an explicit non-applicability list). Both halves are concrete and clearly signaled.

5 / 5

Trigger Term Quality

Extensive natural trigger phrasing users would actually say: '实现这个功能', '开发这个功能', '把这个设计文档变成代码', '做这个功能的开发+测试', '完整实现并测试', '端到端开发', '独立测试', 'black-box 测试', plus plain-language variants ('帮我把这个功能做出来'). Covers synonyms, informal phrasings, and negative triggers ('不适用于:只是要求"写一个脚本"…'), which is comprehensive.

5 / 5

Distinctiveness Conflict Risk

Clear niche — design-doc-driven '开发 ⇄ Review' loop with blind testing ('测试者不预先看代码') — that no generic skill covers, and the explicit exclusion list ('不适用于…纯粹的代码评审…纯粹的测试用例编写…快速修一个 bug') removes the main overlap risks with pure code-review or pure test-writing skills.

5 / 5

Total

19

/

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

digoal/blog

Path

skills/skills_for_claude_web/product_feature_tech_implement/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.