SuperAPI AI 工具集

ln-612-semantic-content-auditor

智能体与模型

查看项目

更新于 10-16 09:58

技能介绍

用途:对项目文档做语义适配审计,验证内容是否匹配文档声明的 SCOPE 与文档类型,是否服务项目目标,识别覆盖缺口、离题内容和 SSOT 违规。仅针对项目文档(如 AGENTS.md、CLAUDE.md、docs/README.md、docs/project/ 下各文档),不用于 reference/tasks/presentation/tests 目录文档,也不核对代码中的路径、版本、端点等事实。

主要能力:按 DOC_KIND 分类判断——index 看路由效率、reference 看精确可查、how-to 看步骤可执行、explanation 看心智模型、record 看决策痕迹。检查项输出为 OFF_TOPIC、MISSING_COVERAGE、SCOPE_CREEP、SSOT_VIOLATION。针对 AGENTS.md/CLAUDE.md 还额外检查 NOT_A_LINTER、NON_UNIVERSAL_RULE、OBSOLETE_PATTERN,三者均为 WARN 级,需人工判断。评分从 1-3(不符合声明用途)到 10(全部内容服务范围且范围完整覆盖)。

使用方式:作为 L3 Worker 由协调器调用,接收 doc_path、output_dir、project_root、tech_stack 等输入。先读取文档头部与顶部段落提取 SCOPE、DOC_KIND、DOC_ROLE 等契约,缺失时按文件名推断,再按类型审计,最后按 audit_scoring.md 计算加权分数(coverage、relevance、focus)。报告写入 {output_dir}/ln-612--{doc-slug}.md,并用单次原子 Write 调用;摘要按 audit_summary_contract.md 输出,独立模式下写入 .hex-skills/runtime-artifacts/runs/{run_id}/evaluation-worker/{worker}--{identifier}.json。依赖 references/audit_worker_core_contract.md、docs_quality_contract.md、markdown_read_protocol.md、mcp_tool_preferences.md 等参考文件。

适用场景与限制:适合审计文档相关性、范围对齐和文档间内容重复。不验证事实,不做代码核对;hex-line MCP 为可选,不可用时改用内置 Read/Grep/Glob/Bash,不应因此阻塞。避免误报,发现须带行号和可执行修复建议;不支持为各文件自定义范围规则。版本 2.0.0,最后更新 2026-03-01。