SuperAPI AI 工具集

ln-ln-612--content-auditor

写作与研究

查看项目

更新于 10-15 23:59

技能介绍

用途:对项目文档做语义适配性审计,判断内容是否匹配其声明的 SCOPE 和文档类型,是否服务项目目标,并返回带严重级别、位置和修复建议的结构化发现。不核对代码事实(路径、版本、端点)。

适用范围:仅针对项目文档,如 AGENTS.md/CLAUDE.md、docs/README.md、documentation_standards.md、principles.md 及 docs/project/ 下的 requirements、architecture、tech_stack、api_spec、database_schema、design_guidelines、infrastructure、runbook;排除 docs/tasks/、docs/reference/、docs/presentation/、tests/。

主要能力:先读取文档头部与顶部区块,解析 SCOPE、DOC_KIND、DOC_ROLE、READ_WHEN、SKIP_WHEN、PRIMARY_SOURCES,缺失时按文档类型推断;按 DOC_KIND(index/reference/how-to/explanation/record)进行类型感知判断;产出 OFF_TOPIC、MISSING_COVERAGE、SCOPE_CREEP、SSOT_VIOLATION 四类发现;按覆盖度、相关性、聚焦度加权评分(10 分制);采用渐进式阅读,仅在必要时通读全文;发现须含行号与可执行修复建议,避免误报。

使用方式:由协调器调用,输入 doc_path、output_dir、project_root、tech_stack;需读取 shared/references/audit_worker_core_contract.md、docs_quality_contract.md、markdown_read_protocol.md、audit_scoring.md、audit_summary_contract.md 及报告模板。报告写入 {output_dir}/ln-612--{doc-slug}.md,类别为 Semantic Content,检查项 scope_alignment;无 summaryArtifactPath 时摘要写入 .hex-skills/runtime-artifacts/runs/{run_id}/audit-worker/{worker}--{identifier}.json。

限制:不做事实校验;路径以 skills 仓库根为基准,若 CWD 下找不到 shared/,可经 WebFetch 从 raw.githubusercontent.com/levnikolaevich/claude-code-skills/master/skills/{path} 获取。具体收费与平台信息暂未提供。