关于 clarity-gate
clarity-gate 是面向文档作者的审查 Skill,用于文档进入 RAG 知识库或交给其他 AI 系统前检查不确定性标注。它不核实事实真伪,判定通过前必须进行人工审核。
主要功能
- 01入库前文档检查
- 02标记缺失的不确定性说明
- 03支持 AI 会话间文档交接
- 04要求人工核实声明
适用场景
- 01检查待进入 RAG 的文档
- 02审阅预测和假设
- 03准备交给其他 AI 系统的文档
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ sickn33/ agentic-awesome-skills --skill clarity-gate安装后在 Claude Code 中输入/clarity-gate确认已加载。
附带文件references/detailed-guide.md
详细介绍
Clarity Gate v2.1
用途: 文档进入 RAG 知识库前的摄取验证系统,用于确保文档符合认知质量要求。生成符合 Clarity Gate Format Specification v2.1 的 Clarity-Gated Documents(CGD)。
核心问题:“如果另一个大模型读取这份文档,会不会把假设误认为事实?”
核心原则: “检测会发现现状,约束会确保应有状态。实际做法是:找出缺失的不确定性标记,避免它们变成令人信服的幻觉。”
详细指南
执行此技能前,请阅读详细指南。指南保留了完整流程和参考材料。其安全要求、前置条件和验证要求均为强制要求。对于有针对性的工作,请加载相关章节;对于端到端工作,请完整阅读指南。
重要限制
Clarity Gate 验证的是形式,而非真相。
此技能会检查声明是否正确标注了不确定性,但无法验证声明本身是否属实。
**风险:**大模型可能会将事实幻觉式地加入文档,然后通过给错误声明添加来源标记,“通过” Clarity Gate。
**解决方案:**在宣布 PASS 之前,必须进行 HITL(人在回路)验证。
适用场景
- 将文档摄取到 RAG 系统之前
- 与其他 AI 系统共享文档之前
- 编写规格说明、状态文档或方法说明之后
- 文档包含预测、估算或假设时
- 发布未经验证的声明之前
- 在不同大模型会话之间交接文档时
此技能不会做什么
- 不对文档类型进行分类(此类工作请使用 Stream Coding)
- 不重构文档
- 不添加深层链接或参考资料
- 不评估写作质量
- 不会自主检查事实准确性(需要 HITL)
目录可用性与如实标注状态
此副本仅提供指导:既未随附所引用的规范性规格,也未随附声明 ID、哈希值或验证器脚本。不要运行不存在的路径,不要将示例摘要用作实际完整性证据,不要设置计算得出的摄取标志,也不要仅凭这段文字认证符合 v2.1。包含 REVIEWED/confirmed-by 的字段示例均为虚构说明;在对确切声明和文档修订版本进行实际、可识别的人为确认之前,请保留 PENDING 状态。哈希值只能检测字节或规范化方面的变化,不能证明真相、真实性或审核权限。八位十六进制字符的 ID 需要进行重复检测;规模较大时请使用更长的 ID。
缺失的证据不能通过伪造引文、精确度或不确定性限定词来弥补。请将原始声明和来源与注释分开保留,保留真实的历史日期,并将无法核实的事实报告为未核实。将某个来源称为 SOT 并不能证明其可靠性。未经授权,不得将私人来源文档发送给 RAG 服务。此 AAS 修订版在保留 Francesco Marinoni Moretto 的 CC-BY-4.0 署名的同时,修正了有关可用性、时间戳和状态真实性的指导。