用 Claude Skills 把内网工单分析 SOP 固化为可复用自动化能力

const { chromium } = require("playwright");

const browser = await chromium.launch();
const page = await browser.newPage();

await page.goto("https://inner.example.com");
await page.locator(".submit").click();

await browser.close();

order-analysis-skill/
├── scripts/
│   ├── check-agent-browser.sh
│   ├── check-cdp.sh
│   └── order-analysis.js
└── SKILL.md

#!/usr/bin/env bash
set -euo pipefail

CDP_PORT="${CDP_PORT:-9222}"

if curl -fsS "http://127.0.0.1:${CDP_PORT}/json/version" >/dev/null; then
  echo "Chrome CDP is available on port ${CDP_PORT}"
else
  echo "Chrome CDP is not available on port ${CDP_PORT}" >&2
  echo "Start Chrome with --remote-debugging-port=${CDP_PORT}" >&2
  exit 1
fi

#!/usr/bin/env bash
set -euo pipefail

if command -v agent-browser >/dev/null 2>&1; then
  agent-browser --version || true
else
  echo "agent-browser is not installed or not found in PATH" >&2
  exit 1
fi

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --remote-debugging-port=9222 \
  --user-data-dir="$HOME/.chrome-cdp-profile"

google-chrome \
  --remote-debugging-port=9222 \
  --user-data-dir="$HOME/.chrome-cdp-profile"

// scripts/order-analysis.js

(async () => {
  const productName = "API 网关"; // 留空表示查询全部产品
  const pageSize = 100;

  const result = {
    fetchedAt: new Date().toISOString(),
    productName,
    total: 0,
    tickets: []
  };

  let pageNo = 1;

  while (true) {
    const response = await fetch("https://inner.example.com/api/tickets/search", {
      method: "POST",
      headers: {
        "content-type": "application/json"
      },
      body: JSON.stringify({
        productName,
        pageNo,
        pageSize,
        type: "upgrade",
        status: "closed"
      }),
      credentials: "include"
    });

    if (!response.ok) {
      throw new Error(`Request failed: ${response.status} ${response.statusText}`);
    }

    const json = await response.json();
    const items = json?.data?.items ?? [];

    result.tickets.push(...items);

    if (items.length < pageSize) {
      result.total = result.tickets.length;
      break;
    }

    pageNo += 1;
  }

  return JSON.stringify(result, null, 2);
})();

sh scripts/check-cdp.sh
sh scripts/check-agent-browser.sh

agent-browser --cdp 9222 open "https://inner.example.com"

OUTPUT_DIR=".output/order-analysis/$(date +%Y%m%d-%H%M%S)"
mkdir -p "$OUTPUT_DIR"

agent-browser --cdp 9222 eval "$(cat scripts/order-analysis.js)" \
  > "$OUTPUT_DIR/order.json"

{
  "fetchedAt": "2026-06-07T10:20:30.000Z",
  "productName": "API 网关",
  "total": 2,
  "tickets": [
    {
      "id": "TICKET-001",
      "title": "升级后路由配置不生效",
      "product": "API 网关",
      "version": "v2.3.0",
      "createdAt": "2026-06-01",
      "description": "用户升级后发现部分路由没有按预期转发"
    },
    {
      "id": "TICKET-002",
      "title": "控制台升级提示不清晰",
      "product": "API 网关",
      "version": "v2.3.0",
      "createdAt": "2026-06-02",
      "description": "用户不理解升级前检查项的含义"
    }
  ]
}

---
name: order-analysis
description: 分析产品升级工单，识别共性问题、趋势变化和产品改进机会。通过 agent-browser 访问已登录的内网工单系统，提取工单 JSON 数据，并生成结构化分析报告。
---

# 工单分析 Skill

## 使用条件

当用户要求分析产品升级工单、定位共性问题、比较不同产品工单趋势，或输出产品改进建议时，使用这个 Skill。

## 环境检查

执行以下命令，确认 Chrome CDP 和 agent-browser 可用：

```bash
sh scripts/check-cdp.sh
sh scripts/check-agent-browser.sh

agent-browser --cdp 9222 open "https://inner.example.com"

OUTPUT_DIR=".output/order-analysis/$(date +%Y%m%d-%H%M%S)"
mkdir -p "$OUTPUT_DIR"

agent-browser --cdp 9222 eval "$(cat scripts/order-analysis.js)" \
  > "$OUTPUT_DIR/order.json"

这样一来，Skill 不只是“运行某个命令”，而是把完整 SOP 写成了 Agent 可以理解和执行的能力说明。

## 报告输出可以标准化

为了让多次分析结果可比较，报告结构最好固定下来。比如：

```markdown
# 工单分析报告

## 关键结论

- 本周期共采集工单 128 条，其中升级兼容类问题占比 36%。
- API 网关、消息队列、对象存储三个产品的升级工单数量最高。
- 共性问题集中在升级前检查不足、控制台提示不清晰、文档缺少异常处理说明。

## 工单概览

| 指标 | 数值 |
|---|---:|
| 工单总数 | 128 |
| 涉及产品数 | 12 |
| 涉及版本数 | 18 |
| 高优先级问题数 | 9 |

## 问题分类

| 分类 | 数量 | 占比 | 典型表现 |
|---|---:|---:|---|
| 升级兼容 | 46 | 36% | 配置迁移后行为变化 |
| 控制台体验 | 28 | 22% | 提示信息无法指导下一步操作 |
| 文档缺失 | 24 | 19% | 缺少升级前检查说明 |
| 代码缺陷 | 18 | 14% | 升级后功能异常 |
| 用户误操作 | 12 | 9% | 未按流程执行前置步骤 |

const productName = "API 网关";

const productName = "";

const productName = globalThis.productName ?? "";

--remote-debugging-port=9222
--user-data-dir="$HOME/.chrome-cdp-profile"

const items =
  json?.data?.items ??
  json?.data?.list ??
  json?.items ??
  [];

function sleep(ms) {
  return new Promise(resolve => setTimeout(resolve, ms));
}

await sleep(300);