废话模式清单(Bloat Patterns)
本清单供 skill-bloat-auditor-yashu 技能扫描指定技能文档时使用。
废话定义:不构成当前生效规则、且对使用者无操作价值的文字——即"以前怎么规定、现已废除/更正"的历史说明,以及解释"为什么有这份文档 / 为什么这样规定 / 技能是什么属性"的导言与原理类装饰文字。
扫描目标文件:SKILL.md 与 references/ 下所有 .md。
命中分两类,标注不同置信度,便于人工取舍。
A 类:历史 / 已废除 / 更正类(高置信,命中即报)
纯历史说明,描述"旧规则已废除/更正/与别处矛盾",不是当前规则本身。
关键词(命中所在行整行上报)
- 旧文档、旧文、旧版、老版本
- 曾规定、原规定、原写、原版
- 已废除、废止、弃用、
deprecated、legacy - 矛盾裁定、文档矛盾、矛盾点
- 以本文件为准
- 统一更新、已更正、已统一
- 取代旧、取代旧版
- 此前、历史上、过去(当修饰"规定/写/文档/判定/认为/出现/设定"等过往说明性动作或状态时)
previously、originally、formerly
短语模式(正则)
以前[如何如何]规定原本?规定、原来规定现已?(废除|更正|更新|弃用|统一)不再(设|有|强制|限制|要求|规定|使用)—— 例:不再设固定色数上限(隐含"此前有此限制、现已废除")取消(了)?(上限|限制|强制|规定|要求)—— 例:取消了字数限制has been (removed|deprecated|superseded)、now deprecated、superseded bypreviously stated、originally specified- 括注式历史依据:
(.{0,5}(此前|以前|原本|原).{0,20}(判定|认为|规定|为|出现|设定))—— 例:(此前被判定为多余属性描述)(括注内含历史性词,解释"为什么这样规定",去掉不影响当前规则)
B 类:导言 / 规则原理 / 自包含属性类(中置信,报出供人工确认)
解释"为什么有这份文档""为什么这样规定"或描述技能属性的多余文字。正常技能文档里这类有时有教学价值,故标中置信,由用户判断是否保留。
模式(正则,不区分大小写)
为什么.{0,10}(强制|禁|规定|规则|这样|要|不)—— 例:为什么强制扁平、为什么禁注释、为什么这套规则专业(通常保留,有教学价值)自包含—— 例:技能完全自包含、技能内置,自包含、合为自包含画图知识不依赖(任何|外部)?(AI )?(客户端)?命令—— 例:不依赖任何外部 AI 客户端命令、不依赖外部命令(自包含属性的同义变体,实战中最常漏检)所有(绘图|画图|技能)?(知识|绘图知识)?(都)?(在|位于|于)本(文件|技能)及本文件、[^。]*与示例内—— 例:所有绘图知识都在本文件、svg-drawing-knowledge.md 与示例内(自包含范围声明,常与下文重复)通用能力/原本?藏在/固化进技能/本(文件|文档|技能).{0,20}固化—— 例:原本藏在 AI 的通用能力里、本文件把它们固化进技能- 导言式开头:
本(文件|文档|技能).{0,20}(旨在|用于|补充|补全|提供).{0,30}(知识|规范|规则|能力) 为了.{0,20}(让|使|避免|保证).{0,20}(自包含|一致|漂亮|通用|任何 AI)—— 例:为了自包含、使任何 AI 照做即可产出一致、漂亮的图
冗余与重复表述(跨行去重原则)
同一"自包含/属性"类主张若在同一文档内被多次复述,属于冗余废话:除保留一处(通常最完整、最靠前的一处)外,其余复述都应报为 B 类。
- 判定:对以下主张做跨行归并——
自包含、不依赖外部命令、所有知识都在本文件/示例内、本技能内置。若某主张出现 ≥2 次,除首处外其余标 B 类,说明写「与 X 行重复,建议只留一处」。 - 例(
svg-diagram-yashu实战):不依赖任何外部 AI 客户端命令在 SKILL.md 行 17、SKILL.md 行 131、design-system.md 行 4 三处复述 → 仅留最合适的一处,另两处为废话。 - 注意:仅仅是"指向内容所在位置"的写法则不算冗余,例如
绘图规范完全内置在本技能内(见 references/design-system.md)是有效指针,应保留。
置信度与处理建议
- A 类(高):基本可判定为废话,建议直接删除。
- B 类(中):可能是合理原理或有价值的"为什么",报告时标注「中置信·请人工确认」,不自动判定。
扫描范围
SKILL.mdreferences/下所有.md
减少误报的注意事项
- 不要把单独的「为了」「因为」作关键词(过于常见);仅匹配导言式目的句(「为了…自包含/一致/漂亮/通用」)。
- 不扫描注释掉的代码块、SVG 内
<text>文字、代码块中的字符串。 - 规则正文里若用「因 X 故 Y」解释当前约束(如「因 PNG 导出滤镜不一致,故禁用渐变」),属合理原理;本技能按最严档仍会标记 B 类,用户在报告中可酌情忽略。
- 「为什么…」类原理(如
为什么强制扁平/为什么禁注释/为什么这套规则专业)通常有教学价值,报告标 B 类但应提示「建议保留」。 - 标题/元信息里的「自包含」一词计入 B 类;同理,「不依赖任何外部 AI 客户端命令」「所有知识都在本文件与示例内」若出现在标题/元信息,也计入 B 类。
- 区分"属性自夸"与"内容指针":
自包含、不依赖外部命令、所有知识都在本文件+示例内是属性自夸(废话);而绘图规范完全内置在本技能内(见 references/X.md)是"内容在哪"的有效指针(保留)。前者说"我多独立",后者说"去哪找规则",判定不同。 - 自指命中不得整篇归组保留:当被检查文档本身就是模式清单/定义性文档时,必须逐句区分——"列举要匹配的关键词/正则"是规则本体(保留);"历史依据括注/原理说明"是废话(按 A/B 类处理)。判定标准仍是"去掉后当前生效规则是否仍完整可执行"。