tapd-iteration-plan

Plans TAPD iterations by scheduling approved stories via dependency DAG ordering and size limits.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Manually deciding which approved stories fit into a TAPD iteration is error-prone: dependencies get missed, iteration capacity overflows, and re-planning an existing iteration risks duplicating work. This Skill automates iteration planning by evaluating the approved story pool, resolving dependencies, and filling the iteration within a configurable size budget.

Core Features & Use Cases

  • Dependency-aware scheduling: Parses dependency sections in story descriptions, builds a DAG, and orders stories by topological order, size, and priority so prerequisites enter the iteration first.
  • Capacity-controlled planning: Enforces a total size limit (default 1000), computes remaining capacity when re-entering an existing iteration, and skips stories that no longer fit.
  • Dual modes: Creates a new iteration (with naming convention iteration-vMAJOR.MINOR.x) or re-enters an existing one, supporting both automatic pool filtering and user-specified story IDs.
  • Use Case: A product manager types "plan iteration iteration-v0.2.x" and the Skill creates the iteration, pulls approved leaf stories, expands their dependencies, topologically sorts them, assigns them via TAPD MCP until capacity is reached, and outputs a planning summary.

Quick Start

Ask the assistant to plan iteration iteration-v0.2.x using the approved stories in your TAPD workspace.

Frequently Asked Questions about tapd-iteration-plan

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

FAQPage Schema
How do I plan a TAPD iteration automatically?

Provide an iteration name like iteration-v0.2.x and the Skill queries or creates the iteration, filters approved leaf stories from the pool, sorts them by dependency order and size, then assigns them via stories_update until the size limit is reached.

How does dependency-based story ordering work in iteration planning?

The Skill parses the dependency section in each story description, extracts story IDs, and builds a DAG. Stories are ordered by topological sort first, then by descending size within the same level, with priority as a tiebreaker.

Can I add specific stories to an existing TAPD iteration?

Yes. Provide the story IDs along with the iteration name. The Skill computes the iteration's remaining capacity from already-assigned stories, filters out stories that have children or existing iteration assignments, and plans only the eligible ones.

What happens when the iteration size limit is exceeded?

Planning stops assigning once remaining capacity is insufficient. Stories that do not fit are skipped in favor of smaller ones, and all unplanned stories are listed in the summary with the reason, such as capacity exhaustion or unmet external dependencies.

What are the requirements for stories to be planned into an iteration?

Stories must have v_status approved, no child stories (children_id equals "|"), and no existing iteration assignment. The workspace_id and owner come from user input or a project.json file, and the TAPD MCP server must be available.