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

tapd-story-plan

Generates test-driven development plans and compliance reports from spec.md via speckit.plan subagents.

840|261|Updated Apr 18, 2019
Search Tags:#TDD#development plan#technical research#pipeline orchestration#Subagent#compliance check#Speckit
One-click install
npx skills add https://github.com/TencentBlueKing/bk-bcs --skill tapd-story-plan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tapd-story-plan
Source: https://github.com/TencentBlueKing/bk-bcs/tree/main/.agents/skills/tapd-story-pipeline/tapd-story-plan
Command: npx skills add https://github.com/TencentBlueKing/bk-bcs --skill tapd-story-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It automates the planning phase of an iterative story development pipeline, turning a clarified spec.md into a structured development plan, technical research, and data model while enforcing document-level compliance checks before the phase advances.

Core Features & Use Cases

  • Speckit Plan Orchestration: Renders a SUBAGENT_PROMPT from the plan template and launches a tech-lead subagent running /speckit.plan in test-driven development mode.
  • Inline Compliance Gate: Validates plan.md, research.md, data-model.md, and contracts against a five-item checklist covering technical context, architecture, data model, requirement mapping, and key decisions.
  • Verdict-Driven Retry and Reentry: Branches on pass, needs_fix (up to 3 rounds per attempt), or spec_insufficient (fallback reentry to the specify phase), updating meta.yaml phase to researched on success.
  • Use Case: In a TAPD story pipeline, after the spec phase completes, run this skill to produce plan.md, research.md, and plan-report.md, automatically retrying or rolling back when the plan fails compliance checks.

Quick Start

Run the plan phase for the current story by reading spec.md and context.md from the work directory and generating the development plan with its compliance report.

Frequently Asked Questions about tapd-story-plan

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

FAQPage Schema
How do I generate a development plan from a spec file?▼

Provide a spec.md in the work directory with the phase set to tech-clarified, and the pipeline renders a plan prompt for a tech-lead subagent running speckit.plan. It produces plan.md, research.md, data-model.md, and a plan-report.md compliance report.

What is speckit.plan and how is it used in a pipeline?▼

Speckit.plan is a command invoked inside a subagent to build development plans in test-driven development mode. The pipeline renders the prompt from a template, passes story ID, work directory, and attempt count, then consumes the returned compliance verdict.

What happens when the plan compliance check fails?▼

A needs_fix verdict triggers a retry within the same attempt, up to three rounds. A spec_insufficient verdict writes an iteration patch and falls back to the specify phase for reentry.

What inputs does the plan phase require before running?▼

It requires the story phase to be tech-clarified, an existing spec.md, a context.md rewritten by the main orchestration, and meta.yaml for attempt tracking. On reentry it also reads the latest iteration patch file.

What artifacts does the planning phase produce?▼

It produces plan.md, research.md, data-model.md when data is involved, contracts files when external interfaces exist, plan-report.md, an appended process.log, and an updated meta.yaml with the phase set to researched.

Related Skills

Explore More Software Engineering Skills→
FerroxLabsFerroxLabs
21

ferrox-spec-phase

Clarify ambiguous phase requirements and generate a SPEC.md with acceptance criteria.

Community
Advanced
HillBombCreationsHillBombCreations

coder

Execute approved software implementation plans and enforce coding standards.

Official
Intermediate
jmanhypejmanhype
24

project-standards

Enforce project coding standards and architectural principles from constitution.md.

Community
Basic
thangvawnthangvawn

blueprint

Design step-by-step construction plans for multi-agent engineering projects.

Community
Advanced