把高频流程打包成可复用 Skill：Microsoft Agent Skills for Python 实战

Skills API 已稳定，先装包（建议 Python 3.10+）：

# 创建虚拟环境（推荐）
python -m venv .venv && source .venv/bin/activate

# 安装带 skills 支持的 Agent Framework
pip install "azure-ai-agents"   # 或对应 MS Agent Framework 的 PyPI 包
pip install "semantic-kernel"   # skills 常配合 SK 使用

# 验证
python -c "import semantic_kernel; print('ok')"

每个 skill 是一个独立目录，里面放指令、资料和脚本：

skills/
└── ticket-triage/            # 工单分类技能
    ├── skill.yaml            # 元信息：名称、描述、触发条件
    ├── instructions.md       # 给 Agent 看的「怎么干」
    ├── references/           # 参考资料（SOP、字段表）
    │   └── category-table.md
    └── scripts/              # 可执行的校验/处理逻辑
        └── validate.py

把原来散落在各 Agent 提示词里的规则，集中写进 skill：

# skill.yaml（示意）
name: ticket-triage
description: 当用户提交/处理客服工单时，按公司 SOP 做分类与优先级判定
triggers: [工单, 客服, 分类, 优先级]

# instructions.md（节选）
你是工单分诊助手。收到工单后：
1. 读取 references/category-table.md 判定所属类别
2. 按「影响人数 × 严重度」给出 P0-P3 优先级
3. 调用 scripts/validate.py 校验必填字段
4. 不确定时输出 NEEDS_REVIEW，不要瞎猜

Skill 里可以带脚本，并配置人在回路审批——高风险动作先等人点确认：

# scripts/validate.py
def validate(ticket: dict) -> dict:
    required = ["title", "reporter", "module"]
    missing = [k for k in required if not ticket.get(k)]
    return {"ok": not missing, "missing": missing}

# 在 skill 配置里声明需要审批
# execution:
#   scripts: [validate.py]
#   require_approval: true   # 执行前弹确认

把 skill 挂到 Agent 上，框架会在任务匹配时自动加载：

from semantic_kernel import Kernel
from skill_loader import load_skill

kernel = Kernel()
load_skill(kernel, "skills/ticket-triage")

# 模拟：提交一条工单
result = await kernel.invoke(
    function_name="ticket-triage",
    input="用户反馈登录页 500，影响全部付费用户"
)
print(result)  # 应判定 P0 + 触发审批

稳定版还提供过滤（拦截不合适的调用）与缓存（相同输入不重复算）：

# 过滤：挡掉明显不匹配的请求，避免误加载
filters:
  - if: input.length < 5
    action: skip

# 缓存：同类工单分类结果复用，省 token
cache:
  ttl: 3600
  key: hash(input.module + input.title)

# 多 Agent 共享同一份 skill 定义，
# 一处更新，所有引用者同步生效。