tapd-iteration-analysis

Analyzes TAPD iteration stories and topologically sorts them by dependency relationships.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

When planning an iteration in TAPD, teams struggle to understand parent-child story hierarchies and determine the correct implementation order across interdependent requirements, leading to blocked work and rework.

Core Features & Use Cases

  • Story Retrieval and Classification: Pulls all iteration stories via the TAPD MCP stories_get API, saves each description as a Markdown file, and classifies them as parent stories, child stories, or standalone stories based on parent_id.
  • Dependency Extraction and DAG Construction: Parses the dependency sections of story documents, identifies technical and business dependencies, builds a directed acyclic graph, and detects circular dependencies.
  • Topological Sorting and State Updates: Produces an implementation sequence with parallelizable groups and writes results into iteration-state.json for downstream execution.
  • Use Case: A product team imports a TAPD iteration containing 15 stories with nested parent-child relationships; this Skill outputs the grouped hierarchy plus a dependency-ordered implementation plan showing which stories can be developed in parallel.

Quick Start

Analyze the requirements in my current TAPD iteration and produce a dependency-sorted implementation order.

Frequently Asked Questions about tapd-iteration-analysis

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

FAQPage Schema
How do I determine implementation order for TAPD iteration stories?

Retrieve all stories with the TAPD MCP stories_get API, extract dependencies from each story's dependency section, build a directed acyclic graph, and run topological sorting. Stories at the same topology level can be implemented in parallel.

How are parent and child stories identified in TAPD?

Classification uses the parent_id field returned by stories_get. A story with a non-empty parent_id is a child story, a story referenced by others' parent_id is a parent, and stories with neither relationship are standalone.

What happens if a parent story is not in the current iteration?

Child stories whose parent_id has no matching story in the iteration are grouped under that parent ID and labeled as parent not in iteration. They still participate in dependency analysis and ordering as a group.

Does dependency analysis include parent stories?

No. Parent stories are excluded from the dependency graph because their goals are achieved through their child stories. Only child stories and standalone stories enter the DAG and topological sort.

What happens when circular dependencies are detected between stories?

Cycle detection runs during DAG construction. When a circular dependency is found, the workflow pauses and prompts the user to confirm and help resolve the cycle before topological sorting can proceed.