用途：面向 BK-CI 流水线插件（Atom）本体的开发，帮助完成插件的定义与交付，而非插件如何被执行。
主要能力：新增流水线插件；修改 task.json 配置与字段定义；设计插件输入、输出、错误码和敏感字段；选择 Java、Python、NodeJS、Golang 等实现方式；调试、测试、发布或排查插件行为。
使用方式：先确认是在开发 Atom，而不是改执行器链路。开发时优先参考三类资料：插件基础与目录（reference/1-plugin-foundation.md）；task.json、输入输出与错误码（reference/2-task-json-io.md）；调试、发布与最佳实践（reference/3-debug-publish-practice.md）。task.json 是插件契约，字段设计、运行时配置、敏感信息标记应先在此定清楚；输入输出以稳定契约为目标，不暴露临时实现细节；运行时和目标平台尽量前置明确。
适用场景：新增插件、调整 task.json、设计输入输出与错误码、选择多语言实现、调试发布与排查插件行为。
限制与不适用：不适用于修改 Worker 如何执行插件、Agent 如何拉起 Worker、Dispatch 如何调度构建机，以及流水线模型、YAML 转换或模板体系。若问题发生在插件被下载、执行、打日志或归档产物阶段，通常应转向 worker-module-architecture；若问题出在流水线模型，则参考 pipeline-model-architecture。
关键陷阱：把执行器问题误判为插件问题；task.json 塞入过多前端或运行时细节；忽略敏感字段、默认值和校验规则；先写实现后补契约导致输入输出不稳定。插件发布后会被大量流水线复用，兼容性与向后兼容应优先考虑。