| name | why |
| description | 系统性诊断和纠正错误。当用户报告任何 bug、视觉异常、内容错误时执行此 skill。基于 wiki/doc/why.md 记录的根因模式进行排查。 |
此 skill 编码了 wiki/doc/why.md 中的所有根因模式，提供一套快速诊断-分析-修复的工作流。
/why <问题描述>
例如：
/why 页面加载卡在"载入中"/why 诗歌检测错了，第001回把非诗段标成了诗歌/why 对话底色看起来不明显按优先级逐层执行，stop-on-first-hit：一旦找到根因即停止深入。
触发条件：页面卡在"载入中"、JS 完全不运行、SPA 白屏。
检查清单：
# 1. JS 语法检查（核心渲染文件 + 插件）
node --check docs/wiki/js/renderer.js
node --check docs/wiki/js/main.js
# 2. 常见语法错误模式（手工追加的 `}`、未闭合 `*/`）
# 从行号倒推出出错区域
已知高发故障模式：
| 症状 | 根因 | 修复方法 |
|---|---|---|
| 整个 app 不加载 | JS 语法错误（多余/缺少 } )） | node --check 定位行号，检查附近括号平衡 |
| 部分功能不工作 | 注释块未闭合 /** → */ | 搜索 /** 确认每个都有对应 */ |
| 样式完全错乱 | CSS 语法错误或选择器泄漏 | 检查是否有未闭合 { |
修复步骤：
node --check 找到错误行号和描述node --check 确认通过/** 和 */触发条件：用户反馈"不好看"、"看不清"、"位置不对"、"间距不对"。
检查清单：
PN 标签：
.pn-label { float: left; margin-left: -6.8em }）@media max-width 覆盖）::before CSS content，用真实元素 + user-select: all）navigator.clipboard.writeText）对话底色：
rgba(210,155,40,0.22) 或更深）诗歌样式：
.chapter-poem { margin: 0 }）： 。」 ！」 ？」）标题：
pointer-events: none; color: inherit; text-decoration: none）移动端适配：
触发条件：用户反馈"标注不对"、"链接错了"、"内容语义有问题"。
检查清单：
运行 wikilink lint：
python3 wiki/scripts/build_registry.py wiki/public/pages --out /dev/null 2>&1 | grep '\[lint\]'
关注 单汉字 wikilink 警告——[[记]]、[[花]] 等通常是拆分书名的错误。
诗歌检测检查：
.chapter-poem 的段落是否真的是诗text.endsWith('：') 排除过渡句标题 wikilink 检查：
书籍/作品名完整性检查：
[[西厢记]]，不拆分为 [[西厢]] + [[记]][[牡丹亭]]触发条件：用户反馈"少了内容"、"引文不足"。
检查清单：
## 原文描写 节（NNN-PPP）corpus/ 原文一致检查完以上步骤后，将当前问题匹配到 wiki/doc/why.md 中的根因模式：
| 模式 | 匹配特征 | 输出 |
|---|---|---|
| A 视觉设计迭代 | 连续的视觉调整反馈 | 建议：一次问清三个参数再改 |
| B 语义判断错误 | 启发式误判、wikilink 错误 | 建议：查注册表、加排除条件 |
| C 编辑操作失误 | JS 崩溃、语法错误 | 建议：改后必须 node --check |
| D 并发修改冲突 | 另一 session 也在改同一文件 | 建议：git diff 检查冲突 |
| E 内容完整性 | 缺少引文或字段 | 建议：对照类型检查表确认 |
修复完成后，执行一次快速验证：
node --check 通过git diff --stat 列出受影响文件/wiki skill 或正常对话）升级红楼梦 wiki 页面质量一档。五级阶梯：stub→basic→standard→featured→premium。诊断页面当前指标缺口，执行对应补充操作（补PN引文、写散文、加节）。当用户说 /enrich PAGE 或 /enrich PAGE 目标档 时触发。
启动红楼梦 Wiki 管家永续 loop。三队列系统（content/housekeeping）。每轮：W1三队列选任务→W2执行→W3自评→记账，无需用户逐轮确认。每11轮discover+housekeeping-scan，每17轮自动/wiki发布，每29轮W5反思，每37轮H17覆盖扫描。工作目录：/home/baojie/work/knowledge/honglou。支持 --focus 参数指定任务范围（多实例并发时使用）。
红楼梦 Wiki 编委审稿：检查近期 butler 工作是否违反质量规范，输出分级违规报告，给出具体纠正建议。工作目录：/home/baojie/work/knowledge/honglou。
一键发布红楼梦 Wiki：重建注册表 → 重算质量分 → 同步 docs/ → git commit → git push。此 skill 明确授权自动 commit 和 push，覆盖项目 CLAUDE.md 中的禁止自动提交/推送限制。
逐章反思，一次只扫一章，发现原文章节中遗漏的实体页面和改进建议。工作目录：/home/baojie/work/knowledge/honglou。
从红楼梦 Wiki 随机抽取 1-3 个页面作为灵感种子，到网上搜索相关分析文章，发现 Wiki 真正的缺口并补齐。可接受参数指定灵感方向。标准模式写作严格限于红楼梦原文；--ext 模式允许为原文引用的现实作者/典故建页，可补充外部背景知识。工作目录：/home/baojie/work/knowledge/honglou。