// 蓝鲸作业平台任务耗时分布分析专家。当用户需要：(1) 分析任务各阶段耗时分布，(2) 定位任务执行中的性能瓶颈，(3) 了解任务执行链路和各阶段涉及的中间件，(4) 生成任务耗时分布统计报告时使用。基于六阶段模型，通过 request_id 查询完整链路日志进行分析。
经 APIGW 调用蓝鲸作业平台（BK-Job）开放接口，支持检索定时任务与最近定时执行的状态/日志、执行方案搜索与带参启动、按实例 ID 查询任务状态与执行日志。列举类查询默认先最近 20 条；大列表在本地用 jq 或短脚本过滤后再摘要。含 plan-execute 操作确认门禁（G1–G4）、对用户输出规范与可选业务记忆 memory/businesses。技能包以含 SKILL.md 的目录为根，可部署在 Cursor、CodeBuddy、OpenClaw 等任意技能加载路径下，脚本与文档路径均相对该根目录。当用户提及作业平台、蓝鲸作业、定时任务、cron、执行方案、job_plan、job_instance、APIGW 调用作业接口、执行作业方案时使用。
蓝鲸监控 APM 调用链分析专家。通过蓝鲸监控平台的 bkmonitor-tracing MCP 服务中的 search_spans 工具，查询和分析 APM Span 数据。当需要：(1) 通过 trace_id/request_id 查询完整调用链，(2) 定位调用链中的 Error Span 和耗时异常 Span，(3) 分析微服务间的调用关系和错误传播路径，(4) 结合 APM 数据辅助排查作业平台任务执行异常时使用。
蓝鲸作业平台日志查询专家。当需要：(1) 编写 KQL 查询语句查询作业执行日志，(2) 排查任务执行失败问题，(3) 分析 GSE/CMDB 调用问题，(4) 查看任务完整链路日志时使用。提供 KQL 语法指导和常用查询模板。
| name | task-duration-analysis |
| description | 蓝鲸作业平台任务耗时分布分析专家。当用户需要：(1) 分析任务各阶段耗时分布，(2) 定位任务执行中的性能瓶颈，(3) 了解任务执行链路和各阶段涉及的中间件，(4) 生成任务耗时分布统计报告时使用。基于六阶段模型，通过 request_id 查询完整链路日志进行分析。 |
当用户询问任务耗时分布时，按照以下六个阶段进行分析。分析时只需通过 request_id 查询整个链路的完整日志，根据日志内容和时间戳自行判断各阶段的耗时情况。
重要：不要使用特定的日志关键字构造查询语句，只需查询完整链路日志即可总结出耗时分布。
阶段描述：从接收 API 请求到发送 JobEvent 启动作业
涉及中间件/服务：
| 中间件/服务 | 用途 |
|---|---|
| CMDB API | 解析主机变量、动态分组、拓扑节点，获取主机信息 |
| IAM API | 权限鉴权 |
| MySQL | 保存任务实例、步骤实例 |
| RabbitMQ | 发送 JobEvent 到 task-out-0 队列 |
阶段描述：JobListener 消费 JobEvent，触发步骤执行
涉及中间件/服务：
| 中间件/服务 | 用途 |
|---|---|
| RabbitMQ | 消费 task-in-0 队列的 JobEvent |
| MySQL | 查询任务实例、更新任务状态 |
| RabbitMQ | 发送 StepEvent 到 step-out-0 队列 |
阶段描述：StepListener 消费 StepEvent，准备 GSE 任务
涉及中间件/服务：
| 中间件/服务 | 用途 |
|---|---|
| RabbitMQ | 消费 step-in-0 队列的 StepEvent |
| MySQL | 创建执行对象任务、创建 GseTask 记录 |
| Artifactory/文件源 | 文件分发时准备源文件（仅文件分发步骤） |
| RabbitMQ | 发送 GseTaskEvent 到 gseTask-out-0 队列 |
阶段描述：GseTaskListener 消费 GseTaskEvent，调用 GSE API 下发任务
涉及中间件/服务：
| 中间件/服务 | 用途 |
|---|---|
| RabbitMQ | 消费 gseTask-in-0 队列的 GseTaskEvent |
| Redis | 获取分布式锁 |
| MySQL | 加载任务和步骤实例 |
| GSE API | 下发脚本执行/文件分发任务 |
| MySQL | 更新 GSE 任务状态 |
阶段描述：脚本在目标机器上执行 + Job 系统周期性轮询 GSE 获取执行结果
涉及中间件/服务：
| 中间件/服务 | 用途 |
|---|---|
| GSE（目标机器） | 实际执行脚本/文件分发 |
| GSE API | 周期性查询任务执行结果 |
| MySQL | 批量更新执行对象任务状态 |
| MongoDB（job-logsvr） | 保存脚本执行日志 |
备注：脚本实际执行时间可通过 GSE 返回的 startTime 和 endTime 时间戳计算得出。
阶段描述：任务执行完成，更新状态、发送通知、执行回调
涉及中间件/服务：
| 中间件/服务 | 用途 |
|---|---|
| RabbitMQ | 发送/消费 StepEvent.refreshStep 和 JobEvent.refreshJob |
| MySQL | 更新任务/步骤最终状态和结束时间 |
| Redis | 清理目标主机密码缓存 |
| RabbitMQ | 发送通知消息到 notifyMsg-out-0 队列 |
| job-manage 服务 | 调用 ServiceNotificationResource 接口处理通知 |
| PaaS 消息中心 API | 最终发送通知（微信、邮件、短信等渠道） |
| RabbitMQ | 发送回调消息到 callback-out-0 队列（如配置了回调） |
| 外部 HTTP | 执行用户配置的回调 URL（支持 JSON 和 FormData 格式） |
备注：
finishJob() → MQ → NotifyMsgListener → job-manage → PaaS 消息中心 APIfinishJob() → MQ → CallbackListener → 外部 HTTP 调用（用户配置的回调地址）request_id 查询完整链路日志（使用 searchLogsByCondition 工具）此 Skill 包含必需的环境配置文件：
requests>=2.28.0首次使用前，必须运行：
./setup_venv.sh
这将创建 venv 虚拟环境并安装所有依赖。
后续使用时：
# 激活虚拟环境
source venv/bin/activate
# 运行脚本
python scripts/example.py
# 退出虚拟环境
deactivate
添加新依赖：
requirements.txt，添加新包（例如 pandas>=1.5.0）./setup_venv.sh 安装新依赖此 Skill 包含示例资源目录，展示了如何组织不同类型的捆绑资源:
可执行代码（Python/Bash 等），可以直接运行以执行特定操作。
其他 Skills 的示例:
fill_fillable_fields.py, extract_form_field_info.py - PDF 操作工具document.py, utilities.py - 文档处理的 Python 模块适用于: Python 脚本、shell 脚本或任何执行自动化、数据处理或特定操作的可执行代码。
注意:
source venv/bin/activate && python scripts/your_script.py旨在加载到上下文中的文档和参考资料，用于指导 Claude 的流程和思考。
其他 Skills 的示例:
communication.md, context_building.md - 详细的工作流指南适用于: 深入的文档、API 参考、数据库 Schema、综合指南，或 Claude 在工作时应参考的任何详细信息。
不打算加载到上下文中的文件，而是在 Claude 生成的输出中使用。
其他 Skills 的示例:
适用于: 模板、样板代码、文档模板、图像、图标、字体，或任何要在最终输出中复制或使用的文件。
可以删除任何不需要的目录。 并非每个 Skill 都需要全部三种类型的资源。