Menú
编写、压缩或重构 BK-CI skill 时使用，例如收紧 `description`、统一主文件骨架、下沉重内容到 `reference/`，并固化渐进式披露规则。当用户要新增或规范化 skill 时优先使用。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
处理 BK-CI AI 编码任务分流时使用，例如判断日常任务是否需要 OpenSpec、多 Agent、影响面清单或验证清单。
用于跨模块开发、排查链路归属、判断某个需求应该落在哪个 BK-CI 模块，或需要快速理解流水线全链路协作时使用。单模块修改时优先读取对应模块 skill，而不是停留在这里。
处理 BK-CI Agent 构建机侧能力时使用，例如守护进程、心跳、Ask 轮询、任务拉起、升级更新和与 Dispatch/Worker 的协作。当用户要改构建机宿主侧行为而不是 Worker 执行细节时优先使用。
设计 BK-CI API 契约时使用，例如 Resource 路径设计、HTTP 方法选择、请求响应对象、错误码和版本策略。当用户要定义接口而不是实现业务逻辑时优先使用。
处理 BK-CI 制品上传下载、制品元数据、BkRepo 或磁盘后端存储、文件任务和清理链路时使用。当用户提到构建产物、制品归档、下载令牌、报告文件、BkRepo 集成或制品清理时优先使用。
处理 BK-CI Auth 模块时使用，例如 RBAC 权限校验、用户组与资源管理、IAM 集成、授权迁移和 OAuth2 认证。当用户要改权限平台实现而不是单次权限模型变更时优先使用。
| name | skill-writer |
| description | 编写、压缩或重构 BK-CI skill 时使用，例如收紧 `description`、统一主文件骨架、下沉重内容到 `reference/`，并固化渐进式披露规则。当用户要新增或规范化 skill 时优先使用。 |
SKILL.mdSKILL.md + reference/description，提升 skill 路由命中率description 当成路由触发器，而不是功能简介。优先写“用户在什么场景下会需要它”。SKILL.md 只保留高信号内容：
SKILL.md 的目标不是“尽量短”，而是“短到只剩路由和行动指导”。在当前仓库里，主文件通常应收紧到约 40-80 行。reference/：
scripts/ 或模板文件。token_estimate、core_files、related_skills，除非仍有明确消费方依赖。# Skill 名称
## 适用场景
## 不适用场景
## 快速指导
## 高信号规则
## 关键陷阱
## 延伸阅读
ai/evals/，确认稳定后再调整 skillname 与目录名一致，且只使用小写、数字、连字符description 简短、第三人称、可路由SKILL.md 通常控制在约 40-80 行，特殊导航型 skill 可略宽，但不应回到手册化正文适用场景 / 不适用场景 / 快速指导 / 高信号规则 / 关键陷阱 / 延伸阅读reference/ 或其他辅助文件00-bkci-global-architecture../../HARNESS.md