cognitive-html-doclisted

# Cognitive HTML Doc 把密集的 Markdown 重构为**认知降维**的工业级单文件 HTML。 ## 核心哲学（纲领） > **认知降维 = 降低阅读成本，不是降低信息完整度。** 降维是重组信息的**呈现方式**（空间位置 / 视觉权重 / 交互组件），不是删减信息量。这条源于真实事故：13,000 字符规格被当摘要任务压成 7,400 字符交付，丢失字段/状态/异常。后续所有机制都为落实这一条。 读者三节奏，产出必须同时满足： - **3 秒抓核心**：Hero 区一句话定位 + 4 维度卡片 - **30 秒理解全貌**：精修主架构图（手写 SVG + 语义箭头） - **3 分钟查细节**：固定侧边栏 TOC + 滚动高亮（移动端有替代导航） ## 执行模型（先读懂这段，再动手） 本 skill 的规则分两层： - **机检层**：可机械验证的项由 `validate.mjs` 物理保证。**交付前必须运行** `node validate.mjs <output.html> --source <source.md>`，全绿（允许 warn，不允许 fail）才算完成。不要靠记忆自查这些项。 - **判断层**：只有需要判断力的项留给模型（见文末"交付前检查"）。 历史教训：24 项纯文字清单在最硬的几项上被系统性跳过——文字规则改变不了执行可靠性，机制才可以。 ## 场景无关性 所有原则适用于产品/技术/API/手册等任意密集文档。写原则用**中性词**（"关键数字"而非"KPI"），场景词只下沉到例子： | 错误（锚定） | 正确（场景无关） | |---|---| | "KPI 应该突出" | "关键数字应该突出（产品 KPI / 技术 SLO / API 限流值）" | | "护城河要前置" | "核心价值要前置（护城河 / 核心机制 / 差异化能力）" | | "5 个理由要展开" | "决策依据要展开" | | "Phase 1 必做项" | "MVP 必做项（Phase 1 / v1.0 / 稳定接口）" | ## 工作流程 | Step | 动作 | 细则 | |---|---|---| | 1 | 通读全文，画逻辑链：输入 → 处理 → 输出 → 反馈 | 下文 | | 1.5 ⭐ | 选转换模式 + 给源章节打保真标签（判断门①） | 下文；`references/fidelity-and-mapping.md` | | 2 | 逻辑完整性：关键环节缺失必须补并标注依据 | `references/completeness-check.md` | | 3 | 信息分层：6 类手段按"读者何时需要"组合 | `references/layering-patterns.md`、`references/folding-decision.md` | | 4 | 选表现形式：读者目的 → 内容类型 → 视觉节制 | `references/visualization-patterns.md` | | 5 | 逐章扫描核心论点 + L1/L2 图视觉审查（判断门③） | `references/diagram-quality-contract.md` | | 5.5 ⭐ | 写交付契约 meta 块，跑 validate.mjs | 下文 | ### Step 1 · 画逻辑链 不直接写 HTML。先画 `输入（数据/触发）→ 处理 → 输出 → 反馈/沉淀`，后续每节都是