用途:审计项目文档质量,适用于任意技术栈。可被用户直接调用,也可由 ln-100-documents-pipeline 在 auditDocs=true 时于第 5 阶段调用。
主要能力:扫描项目内所有 .md 文件(CLAUDE.md、README.md、docs/**),以 CLAUDE.md 为根构建层级树,执行 8 类检查:1 层级与链接(无孤立文件、无断链);2 单一事实来源(去重、重复内容改为链接);3 主动压缩(删冗余、散文转表格);4 需求合规(章节、大小限制、文档内不放代码块);5 时效性(对照代码验证路径、函数、API、配置);6 遗留清理(无历史与废弃内容);7 技术栈适配(引用与官方文档匹配项目栈);8 语义内容(委托 ln-601-semantic-content-auditor 校验内容与 SCOPE 及代码实际行为一致)。随后按类别给出 X/10 评分并计算总分,输出审计报告,含关键发现与按优先级排列的建议动作表。
使用方式:直接调用该技能,或经流水线触发。语义审计阶段对 CLAUDE.md、docs/README.md、docs/documentation_standards.md、docs/principles.md、docs/project/*.md 逐份委托 ln-601,排除 docs/tasks/、docs/reference/、docs/presentation/、tests/。评分公式需读取 shared/references/audit_scoring.md,大小限制见 references/size_limits.md,检查清单见 references/audit_checklist.md,上下文校验见 shared/references/context_validation.md。
限制与注意:不得修改标准/规则文件来让违规通过,应修改违规文件;文档与代码冲突时以代码为准,更新文档;修复后需重新校验单一事实来源,重复内容只保留规范来源并改为链接;遗留内容应删除而非归档;文档只描述当前状态。文档中禁止代码块与实现片段,允许表格、ASCII 图、Mermaid 及单行方法签名。版本 4.0.0,最后更新 2026-01-28。