Index of every page on this site: llms.txt
All skills
steelan9199 avatar

/skill-bloat-auditor-yashu

@9e01957
Run it yourself

检查指定技能文档中的废话文字并输出诊断报告。激活条件:用户消息须包含以下关键词之一:`检查技能废话`、`这个技能文档有没有多余内容`、`清理技能文档废话`、`审查技能文档废话`、`清理技能文档历史说明`。

  • 2 files
  • 9.8 KB
  • Updated 4 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/steelan9199/wechat-publisher/skill-bloat-auditor-yashu

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesbloat-patterns.md

≈1.6k tokens on demand. Your agent reads this file only when SKILL.md points to it.

废话模式清单(Bloat Patterns)

本清单供 skill-bloat-auditor-yashu 技能扫描指定技能文档时使用。

废话定义:不构成当前生效规则、且对使用者无操作价值的文字——即"以前怎么规定、现已废除/更正"的历史说明,以及解释"为什么有这份文档 / 为什么这样规定 / 技能是什么属性"的导言与原理类装饰文字。

扫描目标文件:SKILL.md 与 references/ 下所有 .md。

命中分两类,标注不同置信度,便于人工取舍。


A 类:历史 / 已废除 / 更正类(高置信,命中即报)

纯历史说明,描述"旧规则已废除/更正/与别处矛盾",不是当前规则本身。

关键词(命中所在行整行上报)

  • 旧文档、旧文、旧版、老版本
  • 曾规定、原规定、原写、原版
  • 已废除、废止、弃用、deprecated、legacy
  • 矛盾裁定、文档矛盾、矛盾点
  • 以本文件为准
  • 统一更新、已更正、已统一
  • 取代旧、取代旧版
  • 此前、历史上、过去(当修饰"规定/写/文档/判定/认为/出现/设定"等过往说明性动作或状态时)
  • previously、originally、formerly

短语模式(正则)

  • 以前[如何如何]规定
  • 原本?规定、原来规定
  • 现已?(废除|更正|更新|弃用|统一)
  • 不再(设|有|强制|限制|要求|规定|使用) —— 例:不再设固定色数上限(隐含"此前有此限制、现已废除")
  • 取消(了)?(上限|限制|强制|规定|要求) —— 例:取消了字数限制
  • has been (removed|deprecated|superseded)、now deprecated、superseded by
  • previously 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.md
  • references/ 下所有 .md

减少误报的注意事项

  • 不要把单独的「为了」「因为」作关键词(过于常见);仅匹配导言式目的句(「为了…自包含/一致/漂亮/通用」)。
  • 不扫描注释掉的代码块、SVG 内 <text> 文字、代码块中的字符串。
  • 规则正文里若用「因 X 故 Y」解释当前约束(如「因 PNG 导出滤镜不一致,故禁用渐变」),属合理原理;本技能按最严档仍会标记 B 类,用户在报告中可酌情忽略。
  • 「为什么…」类原理(如为什么强制扁平/为什么禁注释/为什么这套规则专业)通常有教学价值,报告标 B 类但应提示「建议保留」。
  • 标题/元信息里的「自包含」一词计入 B 类;同理,「不依赖任何外部 AI 客户端命令」「所有知识都在本文件与示例内」若出现在标题/元信息,也计入 B 类。
  • 区分"属性自夸"与"内容指针":自包含、不依赖外部命令、所有知识都在本文件+示例内 是属性自夸(废话);而绘图规范完全内置在本技能内(见 references/X.md)是"内容在哪"的有效指针(保留)。前者说"我多独立",后者说"去哪找规则",判定不同。
  • 自指命中不得整篇归组保留:当被检查文档本身就是模式清单/定义性文档时,必须逐句区分——"列举要匹配的关键词/正则"是规则本体(保留);"历史依据括注/原理说明"是废话(按 A/B 类处理)。判定标准仍是"去掉后当前生效规则是否仍完整可执行"。

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 9e01957. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 4 months ago
agent_created
true

README badge

README badge for steelan9199/wechat-publisher/skill-bloat-auditor-yashu