用途:audit-noise 面向被版本跟踪的 Markdown 文档,包括规则、技能正文、指令文件(CLAUDE.md、AGENTS.md)、docs/ 与 README,用于分类与 FLAVOR 不同的五类 NOISE 噪音,并给出处理指引。它是只读分类器:只呈现候选项与处理建议,作者手动应用每一处编辑。
存在性预检:在分类页内噪音前,先判断整页是否值得存在——读者能否通过仓库检索从代码本身推导出该页内容。未通过者列为删除候选,建议先迁移可保留内容再删除,且绝不自动删除。决策、领域语言、精简导航、策略/接线四类无论可否推导都始终通过。当仓库声明了自己的文档存在性约定时,可经由 /discipline:follow-our-standards 的解析阶梯优先遵从。
五类噪音与默认层级:citation(历史引用,Tier 1);ghost-ref(指向切片作用域工作路径的引用,Tier 2);preamble(“为什么存在此文件”式开头,Tier 2);enum-list(硬耦合消费者清单,Tier 1);scope-meta(作用域/加载元注释,Tier 1)。Tier 1 为确定噪音,Tier 2 需审阅,Tier 3 可能合理仅作提示。
用法:默认动作为 audit。无参数且工作区干净时友好退出;无参数但有未提交 .md 文件时批量审计这些文件;传文件路径审计单文件;传目录路径批量审计(文件名按字典序排序保证输出确定)。/audit-noise <file> 等同于 /audit-noise audit <file>。内部对目标运行 bash "${CLAUDE_SKILL_DIR}/scripts/detect.sh",再把结果映射到层级表。
限制:只读,不执行 Edit、Write 或任何变更性 Bash 操作;不自动修改内容。输出格式确定:按文件名排序,逐行按行号排序,输出不含时间戳。部分小节始终豁免:## Recheck triggers、## Cross-references、## Sources / ## History / ## External authority 页脚、ADR 修订块、CHANGELOG.md 条目与发行说明、frontmatter。可用 <!-- markdown-discipline-ignore --> 与 <!-- markdown-discipline-ignore-line --> 选择跳过。惯例路径豁免按匹配路径而非按行生效;形如 .work/<slug>/ 的尖括号槽位变量视为模式占位符而非字面路径,但已弃用的 .claude/notes/ 即使为占位符形式也会被标记。
它不是 /compress(后者处理 FLAVOR),不是 Markdown 结构检查器(结构规范归 markdownlint-cli2 等工具),不是编辑操作,也不是内容去重器(跨 3 个以上文件重复同一概念属于 /extract-ssot)。