GPU_GUARD_MONOREPO/packages/backend/skills/tycm-callback/SKILL.md

name	description	license	metadata
tycm-callback	TYCM审核结果回推。将AI审核结果状态、原因和Markdown报告通过HTTP POST回推到TYCM车主权益管理系统的/agent-invoke-callback接口；不使用token鉴权，支持dryRun链路验证，并在审核异常时回推failed状态。	MIT	version category skillType tags 1.2.0 integration compute-entry tycm callback 投保审核

TYCM审核结果回推

当 AIflow 已得到审核结论，或 OCR、规则审核、报告生成任一步骤失败时，都必须调用本技能给 TYCM 一个最终响应。只允许回调 TYCM 的 /agent-invoke-callback 接口，不再使用 /ai-audit-callback。

优先使用 TYCM 发起请求时传入的 message.callbackUrl。如果上游误传了 /ai-audit-callback，本技能会在发送前自动改写为 /agent-invoke-callback。如果 URL 中带有 token，本技能会自动移除。

{
  "name": "tycm-callback",
  "input": {
    "callbackUrl": "http://127.0.0.1:5610/system/order/agent-invoke-callback?orderNo=20260427093006929543",
    "orderNo": "20260427093006929543",
    "status": "manual_review",
    "reason": "购买方名称不一致，需人工复核",
    "reportMarkdown": "# 审核报告\\n..."
  }
}

使用规则

• 审核成功通过时回调 status: "approved"。
• 审核明确驳回时回调 status: "rejected"。
• 需要人工干预时回调 status: "manual_review"。
• AI、OCR、规则执行、报告生成或其他链路异常时也必须回调，使用 status: "failed"，并在 reason 中写明失败原因。
• 不要调用 /ai-audit-callback。本技能不会生成 HMAC 签名。
• 不要传 token。本技能不会写 X-AiFlow-Token，也会从 callbackUrl query 中删除 token。

输入

• callbackUrl: 必填，TYCM回调地址。优先使用 TYCM 传入的 message.callbackUrl。
• orderNo: 必填，订单号或理赔单号。
• status: 可选，推荐直接传 approved、rejected、manual_review、failed；也兼容 PASS、REJECT、MANUAL_REVIEW 等旧值。缺失或无法识别时会按 failed 回调。
• reason: 可选，审核原因或失败原因。
• reportMarkdown: 可选，Markdown报告正文。
• auditResult: 可选，完整审核JSON，会随body回传，并可作为 orderNo/status/reason/reportMarkdown 的补充来源。
• timeoutMs: 可选，默认 15000。
• retries: 可选，默认 1。
• dryRun: 可选，true 时只生成请求，不发HTTP请求。
• extra: 可选，会合并到请求body中；合并后仍会强制规范 orderNo/status/reason/reportMarkdown。

环境变量

• TYCM_CALLBACK_TIMEOUT_MS: HTTP超时，默认 15000。
• TYCM_CALLBACK_RETRIES: HTTP失败重试次数，默认 1。

输出

成功时返回：

{
  "success": true,
  "dryRun": false,
  "statusCode": 200,
  "response": {},
  "request": {
    "url": ".../agent-invoke-callback?orderNo=...",
    "authMode": "none",
    "headers": { "Content-Type": "application/json" },
    "body": {
      "orderNo": "20260427093006929543",
      "status": "manual_review",
      "reason": "购买方名称不一致，需人工复核",
      "reportMarkdown": "# 审核报告\n..."
    }
  }
}

详细协议见 references/tycm_callback_contract.md。