approval-engine Skill

Description

审批流程引擎 + 异常处理系统。提供规则驱动的多级审批、实时异常检测、自动恢复策略（重试/降级/人工介入）和 Discord 通知集成。

When to Use

• 需要对业务操作（报价、订单、权限变更）实施审批控制时
• 需要检测和告警系统/业务异常（超时、错误率升高、订单异常）时
• 需要配置自动恢复策略（API 失败重试、服务降级）时
• 需要通过 Discord 推送审批请求和告警时

Location

<approval-engine-root>/ 或 $APPROVAL_ENGINE_ROOT

Modules

Configuration

编辑 config/approval-rules.json 配置：

• rules[] — 审批规则列表（触发条件、审批人、超时策略）
• thresholds — 数值阈值（报价金额上限等）
• auto_recovery — 自动恢复策略映射
• escalation_rules — 升级规则（升级时间、升级对象）
• notification_templates — Discord 消息模板

所需环境变量：

• DISCORD_BOT_TOKEN — Discord 机器人令牌
• DISCORD_APPROVALS_CHANNEL — 审批通知渠道 ID
• DISCORD_ALERTS_CHANNEL — 告警通知渠道 ID
• DISCORD_EXCEPTIONS_CHANNEL — 异常通知渠道 ID
• DISCORD_RECOVERY_CHANNEL — 恢复通知渠道 ID

Invocation

触发审批（自动匹配规则）

const engine = require('<approval-engine-root>/src/approval-engine');
// 或使用环境变量
const engine = require(process.env.APPROVAL_ENGINE_ROOT + '/src/approval-engine');

// 提交业务数据，引擎自动评估规则
const approvals = await engine.autoCreateApprovals({
  quotation: { amount: 15000 },
  sales: { owner: 'alice' }
});
// 返回：所有被触发规则创建的审批列表

手动创建并提交审批

const engine = require('<approval-engine-root>/src/approval-engine');
// 或使用环境变量
const engine = require(process.env.APPROVAL_ENGINE_ROOT + '/src/approval-engine');

// 创建审批
const approval = await engine.createApproval('quotation-approval', {
  quotation: { amount: 15000, no: 'QT-2026-001' }
}, { submitter: 'alice' });

// 审批人决策
await engine.submitApproval(approval.id, 'wilson', 'approved', '金额合理，已审批');

// 查询状态
const status = await engine.getApprovalStatus(approval.id);

异常检测（周期巡检）

const detector = require('<approval-engine-root>/src/exception-detector');
// 或使用环境变量
const detector = require(process.env.APPROVAL_ENGINE_ROOT + '/src/exception-detector');

// 全量检测（返回新发现的异常列表）
const exceptions = await detector.detectAll();

// 定时周期检测（含告警推送 Discord）
await detector.runPeriodicCheck();

自动恢复

const recovery = require('<approval-engine-root>/src/recovery-engine');