Agent skill

Tapd Story Specify

by TencentBlueKing in TencentBlueKing/bk-bcs

迭代执行流水线技术澄清与规范生成阶段。通过 tech-lead 分两段执行: 技术澄清段审查需求并产出澄清结论,specify 段生成 spec.md。

Custom licenceAuto-check passedAgent Workflows

Install Tapd Story Specify

skills CLI
$ npx skills add TencentBlueKing/bk-bcs --skill tapd-story-specify -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install TencentBlueKing/bk-bcs tapd-story-specify --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/TencentBlueKing/bk-bcs.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/tapd-story-pipeline/tapd-story-specify .claude/skills/tapd-story-specify && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tapd-story-specify
GitHub stars
840
Token cost
~1.4k tokens
SKILL.md length
446 words
Files
3 (incl. references)
Skills in repo
30
Repo updated
First seen
Licence
Custom licence

At a glance

迭代执行流水线技术澄清与规范生成阶段。通过 tech-lead 分两段执行: 技术澄清段审查需求并产出澄清结论,specify 段生成 spec.md。

  • Works in 5 steps: 重入判定(pipeline 主编排执行) → 技术澄清段(tech-lead) → Specify 段(tech-lead) → …
  • Agent Workflows work in your project
  • SKILL.md covers 定位, 前置条件, 输入 and 执行流程, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Tapd Story Specify is an agent skill from TencentBlueKing/bk-bcs. 迭代执行流水线技术澄清与规范生成阶段。通过 tech-lead 分两段执行: 技术澄清段审查需求并产出澄清结论,specify 段生成 spec.md。 两段共享统一的 questions.md 代问循环机制——遇到无法自答的问题以 blockedonquestions 退出,由外部代问后以 answer 指令重入继续。 支持 blockedonquestions 代问重入与跨阶段回退重入。

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/technical-clarification-guide.md` and `references/technical-clarification-template.md`).

It sits in Agent Workflows. The repository describes itself as: 蓝鲸智云容器管理平台(BlueKing Container Service).

When your agent uses it

  • Agent Workflows work in your project

Example prompts

  • “/tapd-story-specify”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 重入判定(pipeline 主编排执行)
  2. 技术澄清段(tech-lead)
  3. Specify 段(tech-lead)
  4. 质量验证(主编排内联)
  5. 更新状态

What it can do on your machine

Read from SKILL.md and the folder at commit 282070c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tapd Story Specify loads about 1.4k tokens when it runs, and up to ~5k if it reads all its reference files. Until then it costs about 55 tokens; SKILL.md has 446 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 446 words (~1,377 tokens).

name
tapd-story-specify
slug
tapd-story-specify
version
5.0.0

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (references) in .agents/skills/tapd-story-pipeline/tapd-story-specify of TencentBlueKing/bk-bcs.

  • SKILL.md
  • references/technical-clarification-guide.md
  • references/technical-clarification-template.md

Open the folder on GitHubat commit 282070c

Compare with similar skills

Tapd Story Specify next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tapd Story Specify compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tapd Story Specify this skillTencentBlueKing/bk-bcs840—~1.4kAutomated safety check: PassCustom licence
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k10 repos~4.1kAutomated safety check: NotesApache-2.0
Using Superpowersfarm-fe/farm5.6k36 repos~1.4kAutomated safety check: PassMIT
Executing Plans Inlineobra/superpowers297k2 repos~5.1kAutomated safety check: PassMIT
Skill CreatorAzure/azqr79689 repos~8.2kAutomated safety check: PassApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 10 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Using Superpowers

    farm-fe/farm

    A skill your agent uses when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

    5.6k GitHub starsUsed in 36 repos~1.4k tokens
    Agent WorkflowsAuto-check passed
  • Executing Plans Inline

    obra/superpowers

    Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.

    297k GitHub starsUsed in 2 repos~5.1k tokens
    Agent WorkflowsAuto-check passed
  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    796 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 7 repos~2.8k tokens
    Agent WorkflowsAuto-check passed

More from TencentBlueKing/bk-bcs

All 30 skills in this repo
  • Tapd Story Pipeline

    TencentBlueKing/bk-bcs

    单需求实现流水线——把一个 TAPD 需求从零推进到代码提交。自动串联技术澄清、 开发计划、任务拆分、TDD 实现、架构/安全校验、代码提交六个阶段。

    840 GitHub stars~2.6k tokensUpdated 2 days ago
    Auto-check passed
  • Harness Engineering

    TencentBlueKing/bk-bcs

    Harness Engineering 编排器——为 AI Agent 构建运行环境规范. An agent skill from TencentBlueKing/bk-bcs.

    840 GitHub stars~765 tokensUpdated 2 days ago
    Auto-check passed
  • Tapd Iteration Plan

    TencentBlueKing/bk-bcs

    TAPD 迭代规划技能。基于"approved"状态的需求池,结合需求依赖关系、size 规模、 优先级进行全局编排,将合适规模的需求规划进入指定迭代。支持新建迭代和已有迭代 重入两种模式,自动控制迭代总规模上限(默认 1000),通过有向无环图(DAG)分析 保证依赖需求优先入迭代。

    840 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed
  • Tapd Iteration Runner

    TencentBlueKing/bk-bcs

    TAPD 迭代调度器——批量开发一个迭代中的全部需求。自动完成环境初始化、 需求依赖分析、逐需求调度 pipeline 实现、迭代汇总报告四段编排。

    840 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed
  • Tapd Product Discovery

    TencentBlueKing/bk-bcs

    A skill your agent uses when work starts before a complete PRD exists, including 产品前置, 产品调研, 用户调研, 竞品分析, PRD, 原型, 想法建单, 老板需求, 需求来源, 产品父单, 角色拆单, 设计子单, 前端子单, 后端子单, 页面原型 Spec, BKUI 原型, HTML 原型, 原型评审…

    840 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed
  • Tapd Story Clarification

    TencentBlueKing/bk-bcs

    TAPD 需求澄清技能。从 TAPD 提取"规划中"状态的需求,按照研发最佳实践对需求进行 多维度澄清(业务逻辑、外部系统交互、上下文),整合项目背景知识,输出符合需求文档 规范的标准化 Markdown 需求文档,并回写 TAPD。

    840 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Tapd Story Specify

What does Tapd Story Specify do?

迭代执行流水线技术澄清与规范生成阶段。通过 tech-lead 分两段执行: 技术澄清段审查需求并产出澄清结论,specify 段生成 spec.md。. Tapd Story Specify is an agent skill from TencentBlueKing/bk-bcs.

When should I use Tapd Story Specify?

Tapd Story Specify fits situations like: agent Workflows work in your project.

How do I install Tapd Story Specify in Claude Code?

Run `npx skills add TencentBlueKing/bk-bcs --skill tapd-story-specify -a claude-code`. Or copy the skill folder (.agents/skills/tapd-story-pipeline/tapd-story-specify in TencentBlueKing/bk-bcs) into .claude/skills/tapd-story-specify in your project. Claude Code loads it when a task matches its description.

How do I install Tapd Story Specify in Codex?

Run `npx skills add TencentBlueKing/bk-bcs --skill tapd-story-specify -a codex`. Or copy the skill folder (.agents/skills/tapd-story-pipeline/tapd-story-specify in TencentBlueKing/bk-bcs) into .agents/skills/tapd-story-specify in your project. Codex loads it when a task matches its description.

Can I use Tapd Story Specify in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add TencentBlueKing/bk-bcs --skill tapd-story-specify -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tapd-story-specify, .gemini/skills/tapd-story-specify, .github/skills/tapd-story-specify and .opencode/skills/tapd-story-specify in your project.

What does Tapd Story Specify need to run?

SKILL.md names no scripts, command-line tools or credentials: Tapd Story Specify is instructions for the agent only.

Does Tapd Story Specify access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Tapd Story Specify safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tapd Story Specify use?

Tapd Story Specify has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Tapd Story Specify use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.6k tokens, read only when the agent opens those files.

What are the alternatives to Tapd Story Specify?

Skills that share tags, products or a category with Tapd Story Specify: MCP Server Builder (anthropics/skills, 180k stars), Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Using Superpowers (farm-fe/farm, 5.6k stars) and Executing Plans Inline (obra/superpowers, 297k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tapd Story Specify?

TencentBlueKing (a GitHub organization) maintains it in TencentBlueKing/bk-bcs, which has 840 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 9, 2026.

Source: TencentBlueKing/bk-bcs on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.