SuperAPI AI 工具集

ln-614-docs-fact-checker

通用与其它

查看项目

更新于 10-16 00:00

技能介绍

用途:从 Markdown 文档中提取可验证声明,并对照实际代码库逐条核验,同时检测跨文档之间的矛盾,用于审计文档准确性。

主要能力:覆盖 9 类声明——文件路径、版本号、数量/统计、API 端点、配置键与环境变量、CLI 命令、函数/类名、行号引用、Docker/基础设施声明。核验方式包括 Glob/ls 检查路径存在性、Grep 包清单比对版本、统计实际实体数量、Grep 路由定义、检查 package.json 脚本与 Makefile 目标等。跨文档一致性检查可发现同一路径、版本、数量或端点的冲突与缺口。

使用方式:作为 L3 Worker 单次调用(非逐文档),接收 contextStore(tech_stack、project_root、output_dir)。流程为解析上下文、发现文档、提取声明、核验声明、跨文档比对、评分与报告。报告写入 {output_dir}/ln-614--global.md,类别为 Fact Accuracy。需先读取 references/audit_worker_core_contract.md、docs_quality_contract.md、markdown_read_protocol.md、mcp_tool_preferences.md 等契约文件。

适用场景:审计文档准确性,优先处理 canonical 与高声明密度文档,范围包含 docs/reference/、docs/tasks/、tests/。

限制:不检查范围对齐或结构质量;不自动修复,仅报告违规;代码为准,文档与代码矛盾时判定文档错误(除非代码有 bug);每条发现需附核验命令与结果;过滤模板占位符、示例路径、未来时态、外部服务路径等误报;不确定时归为 LOW。排除 node_modules/、.git/、dist/、build/、docs/project/.audit/、CHANGELOG.md。