mcpField
A
aif-grounded

aif-grounded

github.com/lee-toAgent 工作流1.1k99 次安装今天更新
代码仓库

关于 aif-grounded

aif-grounded 是供 Agent 处理不应依赖猜测的请求时使用的可靠性技能。它要求每项事实主张都有证据;证据不足时不猜测,而是列出所缺信息。

主要功能

  1. 01按证据来源分类请求
  2. 02记录证据与未知事项
  3. 03依据权威来源核实易变事实
  4. 04回答或实施前要求信心达到 100
  5. 05默认不修改项目文件

适用场景

  1. 01回答涉及最新或易变事实的问题
  2. 02处理安全、金融、法律或医疗相关请求
  3. 03在上下文丢失后恢复工作
  4. 04在需要验证时评估代码变更

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/lee-to/ai-factory --skill aif-grounded

安装后在 Claude Code 中输入/aif-grounded确认已加载。

详细介绍

Grounded - 可靠性门槛(不猜测)

此技能通过强制执行严格规则,尽量减少随机或编造的回答:

只有在基于现有证据的置信度达到 100/100 时,才提供最终答案。

如果置信度未达到 100,不要猜测,也不要实施。请输出一份简短的“缺少内容”清单,说明达到 100 还需要什么。

适用场景

适用于以下情况:

  • 用户要求最高可靠性(“只有确定时才回答”“不做假设”)。
  • 请求涉及可能变化的信息(版本、“最新”、政策、价格、日程)。
  • 请求与安全、金融、法律或医疗相关(高风险)。
  • 在上下文丢失后恢复工作,需要避免意外假设。

工作流程

步骤 0:加载技能上下文

读取 .ai-factory/skill-context/aif-grounded/SKILL.md——如果文件存在,此步骤为必需。

此文件包含项目特定规则,这些规则由 /aif-evolve 根据补丁、代码库约定和技术栈分析积累而成。这些规则针对当前项目进行了定制。

如何应用技能上下文规则:

  • 将其视为此技能通用说明的项目级覆盖规则
  • 如果技能上下文规则与此 SKILL.md 中的通用规则冲突,以技能上下文规则为准(更具体的上下文优先——与嵌套 CLAUDE.md 文件的原则相同)
  • 如果不存在冲突,则两者都适用:SKILL.md 中的通用规则和项目规则
  • 即使技能上下文规则看似与此技能的默认规则相矛盾,也不要忽略它们——项目经验已证明默认规则不足
  • 关键:技能上下文规则适用于此技能的所有输出,包括响应格式、证据要求和置信度评估。如果技能上下文规则要求“分析必须包含 X”或“置信度必须考虑 Y”,则必须遵守。忽略技能上下文规则进行分析属于错误。

**强制执行:**生成任何输出内容后,都要依据所有技能上下文规则进行核验。如果违反任何规则,则在向用户呈现前修正输出。

步骤 1:对请求分类

将请求归入以下类别之一:

  1. 基于代码库——可仅根据本地代码库和命令输出作答。
  2. 基于文档——需要用户提供或通过可用工具访问的权威文档、规范或日志。
  3. 外部事实——取决于代码库之外且可能变化的事实(必须核实,否则拒绝作答)。
步骤 2:明确证据和未知项

回答前,列出:

  • 证据来源:将使用的文件、命令输出和用户提供的文档。
  • 未知项:证据中未包含的任何信息。

硬性规则:

  • 如果某项声明没有证据支持,就将其视为未知项(而非假设)。
步骤 3:必须核实可能变化的信息

如果请求包含任何可能变化的信息(“最新”“当前”“今天”“vX 中的默认值”“库 Y 现在是否支持 Z”):

  • 通过权威文档、规范、发行说明或日志进行核实。
  • 如果无法使用现有工具或上下文完成核实,则返回 信息不足,并请求所需来源(链接摘录、版本、日志输出)。
步骤 4:置信度门槛

计算 0–100 的置信度:

  • 只有当每项事实性声明都有可指明的证据支持(代码库文件、命令输出、用户提供的文档),且没有未解决的未知项时,置信度才为 100。
  • 只要仍有未知项,置信度就低于 100,不要回答或实施。
步骤 5:输出格式(严格)

如果置信度为 100:

Answer:
<final answer or patch summary>

Confidence: 100/100
Evidence:
- <file/command/doc used>

Checks:
- <3 concrete checks someone can run/inspect to confirm>

如果置信度 低于 100:

Result: INSUFFICIENT INFORMATION (no guessing)
Current confidence: <N>/100
Why not 100:
- <top reasons>

Missing evidence:
- <what exact file/output/doc is needed>

To reach 100:
- <1–3 concrete asks or commands for the user to run and paste output>

工件所有权与配置策略

  • 主要所有权:无。本技能是答案的可靠性门槛,而非产出工件的工作流。
  • 写入策略:默认不创建或修改项目工件。
  • 配置策略:设计上与配置无关。证据来自代码库、命令输出、提供的文档和权威来源,而非 config.yaml。

实施防护规则

如果用户要求修改代码:

  • 你可以探索代码库并提出所需的证据。
  • 只有在有 100 的把握后才应用补丁(例如,需求明确,并且可以验证构建、测试或等效检查)。
  • 如果代码库缺少验证途径(没有构建或测试,且无法验证行为),不要声称有 100 的把握;应回复 INSUFFICIENT INFORMATION,并提出所需的最少验证步骤。

评论

支持 Markdown