Truth first

针对状态、配置、文件内容、操作、连接、挂载及模型选择,须先验证再作答。

安装

概览

什么是Truth first

Truth First 是一款专为开发者设计的智能辅助工具,其核心理念是‘先验证,再回答’。与传统 AI 助手依赖记忆或假设不同,Truth First 在执行任何操作或给出明确答案之前,必须首先通过系统工具获取直接证据。这一机制确保了所有建议、诊断和配置变更都基于当前真实的环境状态,而非推测或过时的信息。它特别适用于需要高可靠性和精确性的技术场景,例如系统故障排查、配置管理和自动化脚本编写。通过强制性的证据收集流程,Truth First 显著降低了因信息错误导致的误判风险,提升了开发效率和系统稳定性。 该工具的工作流程严格遵循一个可重复的框架:首先解析用户请求并提取出所有可能影响响应的事实性主张;然后确定验证这些主张所需的最小检查集;接着运行证据命令(如读取文件、执行状态查询)或直接打开相关日志;最后汇总发现结果,并对每个主张进行分类——标记为‘已验证’、‘推断’或‘未知’。只有在完成这一完整流程后,才会提供最终答案或下一步行动建议。这种结构化的方法使得 Truth First 的回答不仅准确,而且透明,用户可以清楚地看到每一个结论背后的依据来源。 Truth First 强调使用第一手资料作为证据,优先选择配置文件、命令输出、日志文件和工具响应等原始数据源。对于文本搜索,它推荐使用 `rg`(ripgrep)进行精准匹配;对于文件存在性和时间戳检查,则采用 `ls` 和 `stat` 命令。当某些主张无法被直接证实时,工具会明确标注其为‘推断’并解释推理逻辑,同时绝不将‘未知’状态升级为‘已验证’——除非有确凿的直接证据支持。此外,如果由于权限不足、工具缺失等原因无法收集证据,Truth First 也会坦诚告知限制条件,避免给出误导性建议。

核心功能特点

  1. 在回答前必须先验证所有关键事实,杜绝基于假设或记忆的回复
  2. 采用结构化证据框架:列出待验证主张→收集证据→分类结果→提供依据
  3. 优先使用原始证据源,如配置文件、日志输出和系统命令结果
  4. 支持对服务状态、连接性、挂载情况等多种常见系统进行实时检测
  5. 对无法确认的信息明确标注‘未知’并提供下一步取证指令
  6. 内置引用模板库,便于快速构建标准化的证据收集流程

适用场景

Truth First 最适用于那些对准确性要求极高且环境动态变化频繁的技术运维场景。例如,在处理生产环境中的紧急故障时,工程师常常面临多个相互关联的服务组件,任何一个环节的状态误判都可能导致错误的修复方案。此时,Truth First 可以自动识别用户问题中涉及的所有潜在主张(如某个数据库是否在线、某个配置文件是否已更新),并逐一调用相应的检查命令来获取实时状态,从而确保诊断结论建立在最新、最可靠的系统快照之上。 另一个典型应用场景是多云或混合架构下的基础设施管理。在这种环境中,服务的部署位置、网络连通性和资源配置往往分散在不同平台之间,手动核对极易出错。借助 Truth First,管理员可以在发起任何变更操作(如扩容实例、修改安全组规则)之前,先通过工具验证目标资源的存在性、当前负载以及与其他组件的连接状况,形成完整的证据链后再执行操作,极大降低了配置漂移和意外中断的风险。 此外,在团队协作开发中,Truth First 也能发挥重要作用。当开发人员提交代码或部署应用时,常需确认依赖版本、环境变量设置及测试结果是否符合预期。利用该工具提供的标准化证据模板,团队成员可以快速生成统一的验证报告,避免因本地环境与 CI/CD 流水线不一致而引发的线上事故。无论是日常维护还是复杂系统重构,Truth First 都能帮助团队建立一种‘以证据为中心’的工作文化,提升整体交付质量。