日志排查 Skill 实战演练：从请求到交付的全过程

运维与平台工程师经常要做「日志排查」这类事：从大量日志中找出错误模式与首次出现时间。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。

背景（虚构）

阿周是一名运维，每周都要做几次日志排查。过去靠复制粘贴提示词，结果不稳定。这次团队把它做成了技能，下面记录一次完整运行。

阿周在服务器、容器与部署流水线中输入：

这是今天的日志文件或查询结果，按团队的日志排查流程处理一下。

智能体根据技能描述判断任务匹配，加载「日志排查」的完整指令。它先运行技能自带的脚本做预处理，确保后续分析基于准确的数据。

智能体完成“过滤错误级别”，并在中间结果里注明依据，方便阿周回看。

智能体完成“按特征聚类”，并在中间结果里注明依据，方便阿周回看。

“定位首次出现”是最容易出错的环节，技能里专门写了要求，所以智能体给出了清楚的结果与理由。

智能体完成“关联部署时间”，并在中间结果里注明依据，方便阿周回看。

智能体交付错误摘要与时间线，末尾列出两条需人工确认的内容。阿周对照原始日志文件或查询结果抽查关键信息，修正一处表述后采用。

阿周发现智能体对团队内部术语理解不一致，于是在技能目录中加了一份术语表（reference.md），并在 SKILL.md 中写明“遇到术语先查表”。更多改法见定制指南。

技能不是把工作全部交出去，而是把重复、机械的部分交给智能体，人把住判断和责任：

风险较低，但输出仍需快速过目再使用。

在技能的参考资料里放一份你认可的错误摘要与时间线范例，往往比多写十条规则更有效。好范例应当：

范例不必多，一到两份即可；太多范例反而会让智能体机械模仿某一份的细节。

说明：文中的配置、代码与目录结构均为示意，用于说明思路；各平台的入口、字段名与能力会更新，落地前请以对应官方文档为准。示例中的数据与场景为虚构，不代表真实案例。