SuperAPI AI 工具集

ask-exemplar

智能体与模型

查看项目

更新于 10-15 22:10

技能介绍

用途:在做出或评判某个 Target(决策、计划、设计、已完成产物或 diff)前,先查阅当前外部证据。每次运行都是一次 Consultation,基于来源、不改变 Target。独立运行返回 Decision Brief;嵌入式评估只返回 Top Fixes。

主要能力:解析 Target 并判断其是开放还是已完成,开放用 Guidance、已完成用 Evaluation;识别领域、强制要求与用户硬约束。每次调用都搜索或重新验证当前在线来源,优先采用正式标准、官方文档、已发布作品、直接测量和 Exemplar 公开原则等一手来源,将 Standard Finding 分类为正式要求、主流惯例、有争议做法或无标准。挑选一至两个 Exemplar,并把支撑来源记录为 Verified Source Set。将证据转化为可对 Target 检查的可观察标准,区分强制要求、惯例与 Exemplar 特征,每条重要主张附来源链接。

使用方式:Guidance 中比较选项并默认选出一个,仅在某个未决选择会改变首选时才加条件;Evaluation 中逐条检查已完成 Target,每个缺口给一个具体修复,并按杠杆排序去重后的 Top Fixes,同时检查是否有可替代自研的社区工具、库、模式或惯用法。Decision Brief 含 Standard Finding、Exemplars、Observable criteria、Recommendation、Evidence limits;Evaluation 的 criteria 用表格,Recommendation 说明最高杠杆改动,并以 Top Fixes 收尾。Embedded Evaluation 只返回编号 Top Fixes,不编辑文件、不提交、不推送;无实质修复时返回 No Top Fixes。

限制:在线不可用时须报告 Evidence Gap,不对当前标准或最强 Exemplar 作断言,仅用本地来源作临时参考并标低 Confidence。仅当证据证明时才可称某 Exemplar 为世界最佳,否则称本 Target 的最强支持 Exemplar 并说明 Coverage Limit。可信二手来源仅在无一手证据时作临时背景。Verified Source Set 仅可在当前对话或父工作流中复用,且领域与 Standard Finding 未变,复用前须重查时效性主张。Confidence 用高、中、低并给简短理由,不用数值评分。代码、UI、文档、API、CLI、范围、可靠性、测试、短写作或 agent-skill 类 Target 需阅读 REFERENCE.md。