「订单异常排查」Skill 极简版与进阶版：怎么选、怎么升级

电商运营经常要做「订单异常排查」这类事：找出异常订单并给出处理建议。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。

很多人纠结一开始要不要把技能写得很完整。答案是：先极简，再按需升级。下面对比「订单异常排查」的两种写法。

极简版：五行就够

你负责订单异常排查。
输入：订单数据。
步骤：定义异常规则；筛选订单；分类原因；建议处理。
输出：异常清单。
信息不足先提问，不要编造。

适合个人临时使用、验证流程是否合理。缺点是输出格式不够稳定，边界情况处理不一致。

进阶版：完整技能包

.claude/skills/order-anomaly/
├── SKILL.md
├── scripts/order_anomaly.py
└── reference.md      # 可选：团队规范、模板等长资料，按需加载

进阶版在极简版基础上增加：

• 精确的 description，确保自动触发
• 固定的输出结构与“需人工确认”清单
• 约束段落（权限、领域规矩、不可逆操作）
• 参考资料（团队规范、范例），按需加载
• 脚本，负责确定性的解析与校验
• tests/ 测试样例

对比

什么时候该升级

• 每周使用超过几次
• 输出要给别人看或进入正式流程
• 已经发现两次以上同类错误
• 属于中等风险：结果会影响业务判断，建议在输出前设置人工审核点

升级时参考SKILL.md 写法，并用测试用例验证。

交付物结构示例

建议把异常清单固定成下面的结构（示意），方便复核与归档：

## 结论
一句话说明最重要的发现或结果

## 主要内容
- 定义异常规则：……
- 筛选订单：……
- 分类原因：……
- 建议处理：……

## 依据
- 引用输入中的具体位置或数据

## 需人工确认
- ……（没有则写“无”）

结构固定之后，复核的人只要先看“结论”和“需人工确认”两部分，就能快速判断结果能否使用。

平台选择建议

同一个「订单异常排查」技能可以落在不同平台上，选择时主要看你在哪里工作、要不要执行代码、要不要接外部系统：

• Claude 应用中的 Skills：在 Claude 的网页或桌面应用里。详见Claude 应用中的 Skills 版
• LangChain / LangGraph 工具：LangChain 用 @tool 装饰器把函数变成工具。详见LangChain / LangGraph 工具 版
• 腾讯元器：腾讯元器是腾讯推出的智能体创作平台。详见腾讯元器 版

这个技能需要运行本地脚本（解析文件、调用命令行工具等），要求运行环境允许执行代码，可据此排除不支持相应能力的平台。

智能体与人的分工

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

属于中等风险：结果会影响业务判断，建议在输出前设置人工审核点。

延伸阅读

• 订单异常排查 · 文心智能体平台 版
• 订单异常排查 · AGENTS.md 版
• 订单异常排查 · 测试用例
• 店铺日报 · 极简与进阶
• 商品图拍摄需求 · 极简与进阶
• 智能体Skills 分类：625 个技能 × 32 个角度

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