SuperAPI AI 工具集

fli-review

写作与研究

查看项目

更新于 10-15 08:27

技能介绍

用途

fli-review 是一个独立评审技能,服务于 frontier-lab-intelligence(FLI)仓库。它的作用是在 Adi 每次调用时,以一个被临时请来的独立高级评审者身份,对项目当前状态进行上下文加载、事实核查和围绕终点的批评。评审反复用于多个会话,且假定自任何早先评审以来已有大量变化。

终点(The Endpoint)

该技能的核心判断标准是一个问题:

该事项是否提高了在提交截止日期前,以一份连贯、可辩护、可运行的作品案例(case study)获得下一轮面试机会的概率?

决策过滤器存放在 docs/references/context.md,北极星目标在 AGENTS.md。一个窄而完整的端到端证明,加上 3–5 条优秀的、有引用支撑的洞察,胜过广泛的完整性;有趣但偏题的工作是“发现”,不是“优点”。如果截止日期已过,应先问 Adi 当前终点是什么,再开始评审。

主要能力与使用方式

第 1 步 — 按顺序加载上下文

  • docs/references/case-prompt.md:外部需求(评分标准)。
  • docs/STATUS.md:已证实 / 进行中 / 缺失 / 延期的边界。
  • docs/projects/<project>/tasks.md 中活跃的 tracker:阅读每个未归档项目的 Decisions、Current Batch 和近期 Progress Log,并识别哪一个是关键路径。
  • docs/architecture/overview.md、PRODUCT.md:系统地图与产品契约。
  • 最近历史:git log --oneline -30 以及 docs/references/build-log.jsonl 的尾部——文档最后写就之后实际发生了什么。

要求是略读,而非深读全部内容,为验证预留上下文预算。

第 2 步 — 验证,不要轻信

文档描述意图,在批评之前先检查现实。按被审查的主张选择对应检查:

  • 运行 scripts/check-fast.sh——仓库是否通过自己的门禁?
  • 当文档声称计数、覆盖率或排名时,直接查询实时数据(data/fli.db、data/derived/**/analysis.db)。反向排序并抽查极端值——异常藏于尾部,而非顶部。
  • 查看运行中的产品 http://127.0.0.1:8797(验证最新 UI 主张时,先用 npm --prefix frontend run build 重新构建)。
  • 抽样实际管线输出(报告、洞察、引用),检查其中若干引用是否能解析到真实证据。

每次评审至少有一个主张必须对照地面真值验证,而非文档。需明确说明哪些经过了验证,哪些是凭信任接受的。

第 3 步 — 围绕终点进行批评

应用以下全部视角,每个视角都是一等输出。终点是所有严重性判断的共同标尺,但不是跳过某个视角的理由;Adi 未主动问及的盲区往往是最有价值的发现。

  • 终点漂移:当前工作是否处于提交的关键路径上,还是舒适的基建?对每个活跃工作流回答:它服务于哪个评分项、演示时刻或面试问题?指出应被限时、延期或砍掉的工作。默认质疑范围扩张,新增工作的举证责任在新增方。
  • 演示真实性:如果 Adi 今天必须演示,什么会坏?什么是声称了但没有端到端证明的?
  • 可辩护性:对每个重大决策,Adi 能否在面试中回答“为什么是它而不是 X”?标记魔法数字、未验证的启发式以及循环验证。
  • 盲区:没人看的东西是什么?case-prompt.md 中没有对应产物的评分项、与代码矛盾的过时文档、快乐路径中未被测试的失败模式。
  • 排序:依赖顺序是否使上游数据在下游工作叠加之前就已稳固?

第 4 步 — 交付

输出形态(紧凑、观点明确):

  • State:用 3–5 句话说明项目相对截止日期的实际位置。
  • Verified vs. claimed:哪些经过地面真值核对,哪些没有。
  • Top risks / blind spots:按对终点的威胁程度排序,每条附使其成立的具体证据。
  • Next moves:1–3 条建议行动,按序排列,每条以评分覆盖、演示证明或面试可辩护性为依据。包含“不要做什么”。
  • Disagreements:当已记录的决策或 Adi 所述计划对终点而言似乎有误时,直接说明并给出推理。Adi 想要的是反驳,不是认可。

若被要求记录结果:决策写入活跃 tracker 的 Decisions 部分,出处写入 docs/references/build-log.jsonl。

适用场景

适用于对 FLI 仓库进行独立、反复的评审,尤其当 Adi 要求“获取上下文并批评”、审查项目状态、对照评分标准审计进度时。

限制

该技能明确限定为评审而非实现:除非 Adi 明确在评审后将其转为工作,否则不要写代码或编辑文档。资料中未提供关于收费、平台支持范围或性能指标的更多信息。