pipeline-plugin-development
Provides a comprehensive guide to building, configuring, and publishing流水线 (pipeline) plugins.
Install
mkdir -p .claude/skills/pipeline-plugin-development && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/3330" && unzip -o skill.zip -d .claude/skills/pipeline-plugin-development && rm skill.zipInstalls to .claude/skills/pipeline-plugin-development
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
开发 BK-CI 流水线插件时使用，例如新增 Atom、编写 `task.json`、定义输入输出、处理多语言运行时、调试和发布插件。当用户要做插件本体而不是执行器或流水线模型时优先使用。Key capabilities
- →Add a new pipeline plugin
- →Modify task.json configuration and field definitions
- →Design plugin input, output, error codes, and sensitive fields
- →Select Java, Python, NodeJS, Golang for plugin implementation
- →Debug, test, and publish plugins
How it works
This skill guides the development of pipeline plugins by focusing on defining the plugin body and its delivery. It emphasizes `task.json` as the plugin contract for field design, runtime configuration, and sensitive information.
Inputs & outputs
When to use pipeline-plugin-development
- →Create a new pipeline plugin
- →Configure task.json definitions
- →Debug plugin input and output errors
- →Implement multi-language plugin runtimes
About this skill
流水线插件开发
适用场景
- 新增一个流水线插件
- 修改
task.json配置和字段定义 - 设计插件输入、输出、错误码和敏感字段
- 选择 Java、Python、NodeJS、Golang 等插件实现方式
- 调试、测试、发布或排查插件行为
不适用场景
- 修改 Worker 如何执行插件
- 修改 Agent 如何拉起 Worker
- 修改 Dispatch 如何调度构建机
- 修改流水线模型、YAML 转换或模板体系
快速指导
- 这个 skill 关注的是“插件本体怎么定义和交付”，不是“插件如何被执行”。
- 先确认你是在开发 Atom，而不是在改执行器链路。
- 开发插件时优先看三类信息：
- 插件基础与目录：
reference/1-plugin-foundation.md task.json、输入输出与错误码：reference/2-task-json-io.md- 调试、发布与最佳实践：
reference/3-debug-publish-practice.md
- 插件基础与目录：
task.json是插件契约，字段设计、运行时配置、敏感信息标记都应先在这里定清楚。- 输入输出要以“稳定契约”为目标，不要把临时实现细节暴露给使用者。
- 运行时和目标平台要尽量前置明确，避免发布后再补兼容。
- 如果问题发生在插件被下载、执行、打日志或归档产物的阶段，通常要切到
worker-module-architecture。
高信号规则
- 插件开发的核心对象是
task.json和插件执行入口 - 输入字段、输出变量、错误码属于对使用者可见的契约
- 多语言只是实现手段，契约稳定性比语言选择更重要
- 插件发布后会被很多流水线复用，兼容性和向后兼容要优先考虑
关键陷阱
- 把执行器问题误判成插件问题
task.json塞入过多前端/运行时细节，导致难以维护- 忽略敏感字段、默认值和校验规则
- 先写实现，后补契约，最后导致输入输出不稳定
延伸阅读
- 插件基础与目录：
reference/1-plugin-foundation.md task.json、输入输出与错误码：reference/2-task-json-io.md- 调试、发布与最佳实践：
reference/3-debug-publish-practice.md - 如果问题出在执行阶段：再看
worker-module-architecture - 如果问题出在流水线模型：再看
pipeline-model-architecture
When not to use it
- →Modifying how Worker executes plugins
- →Modifying how Agent pulls up Worker
- →Modifying how Dispatch schedules build machines
Limitations
- →Does not modify pipeline models, YAML conversion, or template systems
- →Does not address issues with Worker execution, Agent, or Dispatch scheduling
How it compares
This skill provides structured guidance for developing pipeline plugins and their contracts, unlike ad-hoc plugin creation or modifying execution infrastructure.
Compared to similar skills
pipeline-plugin-development side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| pipeline-plugin-development (this skill) | 1 | 3mo | No flags | Advanced |
| migrate-backend-to-dts | 0 | 3mo | Review | Advanced |
| project-workflow | 0 | 6mo | Review | Beginner |
| managing-api-cache | 2 | 24d | Review | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by TencentBlueKing
View all by TencentBlueKing →You might also like
migrate-backend-to-dts
Azure-Samples
Migrate existing Azure Durable Functions apps from existing backend storage providers (Azure Storage, Netherite, MSSQL) to the Durable Task Scheduler. Use when switching backends, converting to azureManaged storage provider, upgrading from Azure Storage default provider, migrating from Netherite Eve
project-workflow
sumanin5
项目启动、环境搭建与日常开发工作流。涵盖 local 与 docker 两种模式下的启动指令。
managing-api-cache
jeremylongshore
Implement intelligent API response caching with Redis, Memcached, and CDN integration. Use when optimizing API performance with caching. Trigger with phrases like "add caching", "optimize API performance", or "implement cache layer".
generating-rest-apis
jeremylongshore
Generate complete REST API implementations from OpenAPI specifications or database schemas. Use when generating RESTful API implementations. Trigger with phrases like "generate REST API", "create RESTful API", or "build REST endpoints".
slack-bot-builder
davila7
Build Slack apps using the Bolt framework across Python, JavaScript, and Java. Covers Block Kit for rich UIs, interactive components, slash commands, event handling, OAuth installation flows, and Workflow Builder integration. Focus on best practices for production-ready Slack apps. Use when: slack bot, slack app, bolt framework, block kit, slash command.
catalyst-sdk
catalystbyzoho
Catalyst SDKs — initialization patterns, service access, and method reference for Node.js, Web (browser), Python, Java, Android, iOS, and Flutter. Trigger on 'SDK', 'zcatalyst-sdk-node', 'Node.js SDK', 'Web SDK', 'Python SDK', 'Java SDK', 'Android SDK', 'iOS SDK', 'Flutter SDK', or 'initialize SDK'.