skills.rest
TencentBlueKing
TencentBlueKingOFFICIAL
Explore all skills by this author →
WebsiteGitHub

tapd-iteration-init

Initializes TAPD iteration pipelines by creating git branches and iteration state files.

840|261|Updated Apr 18, 2019
Search Tags:#mcp#iteration#agile workflow#tapd#git branch#state recovery#pipeline initialization
One-click install
npx skills add https://github.com/TencentBlueKing/bk-bcs --skill tapd-iteration-init
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tapd-iteration-init
Source: https://github.com/TencentBlueKing/bk-bcs/tree/main/.agents/skills/tapd-iteration-runner/tapd-iteration-init
Command: npx skills add https://github.com/TencentBlueKing/bk-bcs --skill tapd-iteration-init

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Starting a new development iteration requires repetitive manual setup: verifying the git environment, fetching iteration details from TAPD, creating version branches, and tracking progress state. This Skill automates that bootstrap process and also detects interrupted iterations so work can resume instead of restarting.

Core Features & Use Cases

  • Three-Stage Initialization: Runs information checks (git validation, TAPD iteration lookup, branch name parsing), recovery detection, and new-flow initialization in sequence.
  • Resume Interrupted Iterations: Reads an existing iteration-state.json to determine progress and routes recovery to the correct downstream sub-skill.
  • Cross-Platform Support: Provides both Bash (Linux/macOS) and PowerShell (Windows) commands for every step.
  • Use Case: A developer starts iteration v1.2.x by providing a TAPD workspace_id and iteration_id; the Skill fetches iteration details via TAPD MCP, creates the v1.2.x branch from master, and writes specs/v1.2.x/iteration-state.json for downstream pipeline stages.

Quick Start

Initialize the TAPD iteration pipeline for workspace 123456 and iteration 7890, creating the version branch and state file.

Frequently Asked Questions about tapd-iteration-init

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

FAQPage Schema
How do I initialize a TAPD iteration pipeline in a git repository?▼

Run the initialization from your git project root and provide a workspace_id and iteration_id. The Skill validates the git environment, fetches iteration details via TAPD MCP, creates a version branch, and writes iteration-state.json under specs/.

How does iteration branch naming work with TAPD iterations?▼

Branch names are parsed from the iteration name using the pattern iteration-vMAJOR.MINOR.x, extracting the version portion like v1.2.x. If the name does not match this convention, the full iteration name is used and the user is asked to confirm.

Can I resume an interrupted TAPD iteration workflow?▼

Yes. The Skill checks for an existing iteration-state.json and reads its status. Non-terminal states trigger a recovery flow that shows progress and routes to the correct sub-skill based on the first unfinished requirement.

Does this iteration initialization work on Windows?▼

Yes, it supports Windows PowerShell alongside Linux and macOS Bash. Windows users should first set UTF-8 console encoding with [Console]::OutputEncoding = [System.Text.Encoding]::UTF8.

What happens if the iteration is already marked completed?▼

The Skill informs the user that the iteration is completed and asks whether to restart. Restarting deletes the old state and runs the new-flow initialization; otherwise no changes are made.

Related Skills

Explore More Software Engineering Skills→
TencentBlueKingTencentBlueKing
839

bk-monitor-tapd-dev

Analyze TAPD tickets and generate a structured development plan.

Official
Advanced
ulises-jeremiasulises-jeremias
2

dots-workstation-work-item

Route epics, stories, tasks, bugs, and incidents through the agentic-workstation hierarchy.

Community
Intermediate
mdmagnuson-creatormdmagnuson-creator

builder-state

Persist and resume builder sessions by managing docs/builder-state.json state.

Community
Advanced
TugoukezhangTugoukezhang
8

tapd-openapi

Access TAPD OpenAPI to manage stories, bugs, tasks, iterations, and wikis.

Community
Intermediate