SuperAPI AI 工具集

operator-scorecard

办公与效率

查看项目

更新于 10-15 11:23

技能介绍

用途

operator-scorecard 是 Aeon 项目中的一个技能,提供三种针对 Aeon 自身活动的回顾视图。它共享一段前置逻辑(读取记忆、计算日期、解析选择器),然后分支到完全不同的处理逻辑,各分支不混合。

三种模式

默认:operator scorecard

将最近 7 天的智能体活动综合成一份操作员可在 30 秒内读完的纯语言记分卡。包含三段(智能体健康 / 社区增长 / 经济活动)加一行判定(OK / WATCH / DEGRADED)。该分支回答操作员在一周自主运行后常问的问题:这一周是否值得?

它刻意是综合视图而非测量视图——打印的每个数字都来自其他技能已写入的文件。不引入新 API、新密钥、新 cron 状态。若上游技能未运行,对应段落会优雅降级(“本周无数据”)而非编造数字。

配置:无新配置、无新密钥。读取:

  • output/articles/skill-analytics-*.md — 窗口内最新文件,用于机群通过率与异常数(由 skill-health 的分析视图写入)
  • output/articles/heartbeat-.md(或 memory/logs/.md 的 heartbeat 段落)— P0–P3 判定统计
  • output/articles/tweet-allocator-*.md(遗留;该技能已退役,通常不存在)— 每周分发总额与接收者数
  • output/articles/repo-pulse-*.md(遗留;该技能已退役,通常不存在)— 窗口内每日 star/fork 增量求和
  • memory/MEMORY.md — 上次整合日期与“Skills Built”近期行
  • memory/issues/INDEX.md(可选)— 未关闭 issue 数

无出站 HTTP,无 gh api 调用。纯文件扫描加算术。

ops:运营回顾

单日运营摘要——交付了什么、什么失败了、什么需要跟进。读取当天活动日志、memory/cron-state.json 和 issues 索引,去重重跑,要求每个已交付项都有 URL,浮现需要人工介入的调用,并以一句话 TL;DR 判定开头。绝不是日志堆砌。

可选日期覆盖写在关键词后(ops 2026-06-30 或 ops:2026-06-30);日期为空表示今天(UTC)。

push:推送回顾

读取 diff 的推送深度回顾。按被监视仓库获取推送事件、提交和已合并 PR,读取 diff,将每个提交分类为用户可见 / 内部 / 基础设施,按影响排序,并以一行判定开头——带显著性门控,安静的日子不发送任何内容。

可选仓库范围写在关键词后(push aeonfun/aeon 或 push:owner/repo);为空表示所有被监视仓库。

使用方式

通过 ${var} 选择模式。第一个 token 决定分支,其余为分支特定参数。

  • 空 → operator scorecard(默认)。也接受 dry-run(跳过通知——文章和 JSON 规格仍写入)和/或整数 N 覆盖窗口小时数(默认 168 = 7 天,上限 720)。示例:``、dry-run、336、dry-run 336。
  • ops → 运营回顾。
  • push → 推送回顾。

共享前置逻辑(每个分支都运行):读取 memory/MEMORY.md 获取高层上下文,扫描最近约 3 天的 memory/logs/ 获取近期活动,丢弃已报告的内容;计算 ${today}(UTC 日期,YYYY-MM-DD);解析 ${var} 得到分支与分支参数;分派到匹配分支,仅该分支执行。

默认分支步骤概要

  1. 解析 var 并解析窗口:dry-run 前缀设 MODE=dry-run;正整数 N 设 WINDOW_HOURS=N 且 WINDOW_DAYS=N/24(向下取整),上限 720 小时(30 天);否则 WINDOW_HOURS=168、WINDOW_DAYS=7。计算 WINDOW_START_DATE。
  2. 收集智能体健康信号:最新分析文章、heartbeat 判定、未关闭 issue,计算健康判定。
  3. 收集社区增长信号:star/fork 增量、新贡献者、值得注意的提及,计算增长判定。
  4. 收集经济活动信号:$AEON 分发额,计算经济判定。
  5. 汇总为总体判定:取三段判定中最差者。INSUFFICIENT_DATA 段落不强制总体为 DEGRADED——降级为 WATCH。判定行使用与 heartbeat 的 P 标志相同的词汇:🟢 OK / 🟡 WATCH / 🔴 DEGRADED。
  6. 构建文章:路径 output/articles/operator-scorecard-${today}.md,同日重跑幂等覆盖。
  7. 写入仪表盘 JSON 规格:路径 apps/dashboard/outputs/operator-scorecard.json。若写入失败,记录警告但不中止——文章是权威产物,JSON 规格是仪表盘便利。
  8. 发送通知:dry-run 模式跳过通知并退出;否则调用 ./notify。
  9. 记录日志。

适用场景

适用于 Aeon 项目的操作员,需要在一周自主运行后快速判断整体状况,或需要单日运营摘要、推送深度回顾。

限制

  • 默认分支是综合视图,不自行测量任何数据;所有数字来自其他技能的文章。
  • 上游技能未运行时对应段落降级为“无数据”。
  • tweet-allocator 和 repo-pulse 技能已退役,在新实例上通常不存在,相关段落会降级为“无数据”。
  • 新贡献者统计依赖 GitHub API;不可用时 new_contributors=null。
  • 无出站 HTTP、无 gh api 调用(默认分支)。
  • 具体收费、价格、平台等信息暂未提供。