nw-collapse-detection

仓库创建 2026年2月13日最近提交 1 个月前SkillHot 收录 21 天前
▸ 精选理由

帮助维护面向不同读者的文档结构与可读性,适合文档团队。

这个 Skill 做什么

检测文档“类型坍塌”反模式并给出修复策略与范例。

检测文档里把不同文档类型混到一起导致的“Documentation collapse”或 type‑mixing 问题,比如教程里掺太多原理或 How‑to 教程反而讲基础概念。会给出明确的检测规则、坏例子和可执行的修复策略(如拆分文档、重写目录、加交叉链接等)。适合整理文档库、让每类读者都能被导到合适页面,恢复内容结构清晰度。

▸ 展开 SKILL.md 英文原文

Documentation collapse anti-patterns - detection rules, bad examples, and remediation strategies for type-mixing violations

内容创作文档质量反模式检测修复建议通用
585
Stars
59
Forks
40
仓库内 Skill
+15
7 日增星
安装 / 使用
给你的 Agent 一句话(通用)
帮我安装这个 skill:https://raw.githubusercontent.com/nWave-ai/nWave/main/nWave/skills/nw-collapse-detection/SKILL.md
或 curl 直取 SKILL.md
curl -fsSL "https://raw.githubusercontent.com/nWave-ai/nWave/main/nWave/skills/nw-collapse-detection/SKILL.md"
SKILL.MD 节选查看完整文件 ↗
# Collapse Detection

Documentation collapse = types merge inappropriately, serving no audience well.

## Anti-Patterns

### Tutorial Creep
Description: Tutorial explains "why" extensively | Detection: explanation >20% | Fix: extract to separate doc, link back

### How-to Bloat
Description: How-to teaches basics first | Detection: teaching fundamentals before steps | Fix: link to tutorial, assume baseline

### Reference Narrative
Description: Reference includes conversational prose | Detection: prose paragraphs in entries | Fix: move to explanation doc, keep factual

### Explanation Task Drift
Description: Explanation ends with "do this" steps | Detection: step-by-step in explanation | Fix: 
via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有