tapd-story-evaluation

Breaks down TAPD requirements and scores them with PERT effort, Fibonacci size, and RICE value.

840|261|Updated Apr 18, 2019
One-click install
npx skills add https://github.com/TencentBlueKing/bk-bcs --skill tapd-story-evaluation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tapd-story-evaluation
Source: https://github.com/TencentBlueKing/bk-bcs/tree/main/.agents/skills/tapd-story-evaluation
Command: npx skills add https://github.com/TencentBlueKing/bk-bcs --skill tapd-story-evaluation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Large or vague TAPD requirements are hard to estimate, schedule, and deliver. This Skill analyzes a requirement document, splits oversized stories into right-sized sub-requirements, and produces consistent effort, size, and business-value scores before creating child stories in TAPD.

Core Features & Use Cases

  • Requirement Breakdown: Splits stories using MECE principles, MVP-first slicing, FURPS+ NFR scanning, and interface-contract-first planning with parallel wave编排, then validates coverage with a traceability matrix and 6 consistency checks.
  • Three-Dimensional Scoring: Estimates effort via PERT three-point estimation with type-specific baselines (development, ops, documentation), computes a Fibonacci size from 5 scale dimensions, and calculates a RICE business-value score written back to TAPD fields.
  • Guardrails & Ticket Creation: Enforces a 24-person-hour cap and size thresholds with up to 3 re-split callbacks, then creates child stories through a four-stage protocol (pre-check, create, post-verify, auto-fix).
  • Use Case: Given a TAPD story ID, the Skill fetches the story, splits it into 3 sub-requirements saved under docs/reqs/, scores each one, and creates approved child stories in TAPD with effort, size, and business_value filled in.

Quick Start

Ask the agent to evaluate TAPD requirement 12345 and it will fetch the story, split and score it, then create the sub-requirement tickets.

Frequently Asked Questions about tapd-story-evaluation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate and split a TAPD requirement automatically?

Provide one or more TAPD story IDs and a workspace_id (or a project.json containing it). The Skill fetches each story via the TAPD MCP, decides whether splitting is needed based on user-story count and scale, then scores and creates child stories.

How is the TAPD size field calculated for a story?

Size is a Fibonacci value (1, 2, 3, 5, 8, 13) derived from five scale dimensions: scope, technical complexity, dependencies, risk, and verification cost. Each dimension is scored 1-5, then maxDim anchoring plus avgDim calibration maps to the Fibonacci value.

What is the difference between size and business_value in TAPD?

Size measures relative implementation effort from the five scale dimensions only, while business_value is the RICE score (Reach x Impact x Confidence / Effort). The two fields are fully decoupled and never assigned from each other.

What happens when a sub-requirement exceeds 24 person-hours?

The main flow triggers a re-split callback: the oversized sub-requirement is treated as a small parent and split again, up to 3 retries. Items still over the limit after 3 attempts are flagged for manual handling without blocking the rest.

Does this Skill work without the TAPD MCP service?

No. The Skill requires the TAPD MCP for fetching stories (stories_get), resolving long IDs (tapd_id_get), and creating or updating child stories. If the MCP is unavailable, execution stops with a configuration prompt.

When should a requirement not be split?

Requirements with two or fewer user stories and low-to-medium scale are left intact and scored directly. Very small fragmented stories totaling under 8 person-hours are merged into one or two cohesive sub-requirements instead.