CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tapd-story-tasks

迭代执行流水线任务生成阶段。基于 plan.md / research.md 调用 /speckit.tasks 生成全量任务, 随后调用 /speckit.analyze 验证产物合规。两段命令通过两次 subagent 隔离执行。 命令与报告模板详见 ../references/subagent-prompt-template.md §2.3 + §2.4。

Quality

74%

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 ./.agents/skills/tapd-story-pipeline/tapd-story-tasks/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

88%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 a dense, well-structured orchestration document: lean token usage, a fully specified two-stage workflow with validation checkpoints and bounded error-recovery loops, and clean delegation of templates and shared conventions to clearly-signaled reference files. The only real gap is that all executable prompts/commands live in the parent bundle's reference file rather than being available or verifiable within this skill's own bundle.

DimensionReasoningScore

Conciseness

Every section (前置条件, 输入, 执行流程, 内容门禁, verdict branching, 更新状态, 产出) is purely operational with no concept explanations or padding; the single rationale line ("拆成两段的理由:speckit-analyze 是独立skill...") is a necessary design decision, and heavy details are delegated instead of duplicated. This matches the lean, competence-assuming top anchor.

5 / 5

Actionability

Concrete state-machine guidance: exact field updates ("更新 meta.yaml.phase 为 tasks-generated", "meta.yaml.history 追加成功记录,清空 meta.yaml.last_failure"), bounded retries ("最多 3 个 round"), and explicit re-entry targets. Not 5 because the executable SUBAGENT_PROMPT templates and shell commands are fully delegated to subagent-prompt-template.md §2.3+§2.4 rather than available inline; not 3 because the orchestration-level instructions are complete and specific with only template details delegated.

4 / 5

Workflow Clarity

Clear two-stage sequence with an explicit validation checkpoint (tasks-analyze compliance verdict), a content-gate checklist table (格式与可执行性, 用户价值切片, TDD 与验收, etc.), and explicit feedback loops: needs_fix → 同 attempt 内 round+1 (capped at 3), plan/spec_insufficient → 回退重入 with attempt-${N+1}.md. This matches the top anchor including error-recovery loops and a checklist.

5 / 5

Progressive Disclosure

All heavy material (prompt/report templates, verdict rules, reentry conventions, error handling) is delegated one level deep with precise section pointers (§2.3, §2.4) and consolidated in a 参考资料 section — well signaled and easy to navigate. Not 5 because references use parent-relative paths (../references/) and no bundle files exist alongside this SKILL.md to verify the targets resolve; not 3 because references are explicit, organized, and not buried.

4 / 5

Total

18

/

20

Passed

Description

51%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 clearly states what the skill does with two named commands and the two-subagent execution model, and it is appropriately third-person and concise. Its weaknesses are the complete absence of an explicit "Use when..." trigger clause and the reliance on internal pipeline jargon rather than natural user-facing trigger terms.

Suggestions

Add an explicit "何时使用 / Use when" clause stating the trigger condition (e.g. iteration pipeline reaching the task-generation phase with plan.md and research.md ready) to raise completeness.

Include natural trigger keywords a user would actually say (e.g. 生成任务清单, tasks.md, speckit tasks, 任务拆分) alongside the slash-command names to improve trigger term quality.

State the boundary briefly (e.g. this sub-skill only orchestrates generation and verification, not the plan/research phases) to sharpen distinctiveness against sibling phase skills.

DimensionReasoningScore

Specificity

"调用 /speckit.tasks 生成全量任务,随后调用 /speckit.analyze 验证产物合规" and "两段命令通过两次 subagent 隔离执行" list several concrete, named operations with their outputs. Not 5 because coverage stops at two operations plus the isolation mechanism, unlike the comprehensive multi-action anchor; not 3 because the commands are explicitly named rather than vaguely described.

4 / 5

Completeness

The "what" is clear (task-generation phase: generate tasks.md, then verify compliance via two isolated subagents), but "when" is only weakly implied by the phase framing — there is no explicit "Use when..." clause or equivalent trigger guidance, which caps completeness at 3. Not 4 because no explicit usage condition is stated at all.

3 / 5

Trigger Term Quality

Terms like "迭代执行流水线", "/speckit.tasks", "subagent" are internal pipeline jargon; no natural phrases a user would say, no synonyms or file variations. Not 1 because the named slash-commands and file names (plan.md, research.md) are concrete anchors rather than entirely generic language; not 3 because no common natural-language trigger variations are present.

2 / 5

Distinctiveness Conflict Risk

Naming the specific phase and its two commands (speckit-tasks, speckit-analyze) carves a distinct niche among sibling pipeline-phase skills. Not 5 because the phase label alone ("迭代执行流水线任务生成阶段") overlaps conceptually with adjacent phases without stating what this skill does not cover; not 3 because the named commands and explicit outputs make it mostly distinct.

4 / 5

Total

13

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

TencentBlueKing/bk-bcs

Path

.agents/skills/tapd-story-pipeline/tapd-story-tasks/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.