SuperAPI AI 工具集

docs-consistency-check

智能体与模型

查看项目

更新于 10-16 03:41

技能介绍

用途:对项目中的文档、模板、清单文件(package.json、plugin.json、.mcp.json)、安装脚本和指令文件(CLAUDE.md 等)做跨文件一致性审计,发现同一概念在多处出现时的冲突、过时、孤立引用、无法核实和重复表述。

主要能力:先应用安全护栏,过滤凭据与敏感文件,绝不读取或输出凭据值;随后识别文件集,加载有意保留的差异(intentional-variations.md),统计声明的不变量与泛化计数,构建概念清单,交叉比对并分类为 🔴 冲突、⚠️ 过时、↩️ 孤立、❓ 无法核实、🔁 重复表述。最后按严重度输出编号报告,含文件、行号、原因说明与修复建议,并可选择应用修复、记录有意差异。

使用方式:作为技能调用;以 docs-consistency-check review-intentional 调用时进入复查有意差异模式。安装命令与具体调用命令资料未提供。可选使用只读 git(git status、git diff、git log)提升精度,无 git 时仍可运行但精度较低。项目根目录可选放置 .docs-consistency-check-ignore 忽略文件与 intentional-variations.md。

适用场景:多文件项目中文档与实现容易不同步时,或清单、模板、脚本与说明文件需要保持一致时。

限制:不修改凭据值,修复仅针对已报告概念;❓ 与 🔁 不纳入“全部修复”,需逐项确认;修复后需收敛检查,最多三次迭代,仍未收敛则停止并报告。收费、价格、平台等信息暂未提供。