用途
readable-output 用于把已有的素材、经历、资料整理成「给人读的 HTML 长文」。它的定位是「输出工程」——让 AI 输出长内容时按清单想一遍，而不是直接套模板。其元原则是：写作是 thinking on paper，不是模板填空；终点是「读者下次能用」，而非「读者这次能懂」。
触发与不触发
触发场景（需要给人读的中长 HTML 内容）：
- 「做个复盘 / 总结 / 汇总 / 整理」
- 「做个教程 / 学习指南 / 上手文档」
- 「把 X 讲清楚 / 整理成可读的 HTML」
- 「做份报告 / 说明文档」
- 任何要求产出 > 500 字的结构化阅读内容
不触发场景：写代码 / 修 bug / 改文件；一两句话回答；代码 diff / 短列表；用户明确说「用 markdown 答」或「聊天里直接说」；PRD、文章写作、起名等有专门技能的场景。
重要限制：本技能产出只有 HTML 一种格式。如果用户要 markdown，不用本技能。
主要能力与运作模式
整体流程为：触发 → 阶段 1 强制用结构化询问工具一次性问 4 个关键问题 → 用户选完后，阶段 2-6 在 AI 内部进行（不对用户念稿）→ 产出 HTML，顶部加「本次配置」确认条，浏览器自动打开。
例外（跳过阶段 1 提问）：用户在 prompt 里已明确所有 4 个参数；或用户明确说「快速做」「随便给我一份」「别问」。
阶段 1：一次性问 4 个问题
必须用结构化询问工具发起一次询问，包含 4 个维度：
- 给谁看（受众）：PM / 产品经理、工程师 / 技术新人、高管 / 决策者、自己 / 备忘、外部用户 / 客户。
- 读完拿什么（终点）：决策依据、操作步骤、概念理解、故事共鸣、备忘归档。
- 要详到什么程度：速读卡（TL;DR + 1 个核心框架 / 1 张主图，约 3 分钟）、标准版（默认推荐，核心点 + 故事 + 反例 + 出口，5-8 分钟）、教学版（+ 背景延伸 + 多视角对照 + 可复用框架 + 边界声明，20-30 分钟）、AI 自选。字数不进用户视图，只承诺「包含什么」和「阅读时间」。
- 风格 + 侧重（合并）：工程严肃（清新蓝，教训方法论为主）、故事化阅读（暖色书卷，故事完整性为主）、决策简洁（极简黑白，数据冲击为主）、技术深度（暗色科技，含代码细节）、AI 自选。
阶段 1.5：素材体量自检 + 主动反劝
问题 4 答完后、进入阶段 2 之前必须自检。触发反劝的场景只有一个：单文档型素材（单个 README / 单个 PRD / 单篇文章）且原文 < 3K 字 + 用户选了「教学版」。触发后 AI 必须中断流程，向用户主动反劝，建议改标准版或补充素材。用户坚持继续教学版才产出，且必须加「素材体量警告」横幅 + 每段推演加「推演」标签。多源素材 / 非教学版不触发反劝。
阶段 2-6（AI 内部进行）
- 阶段 2 · 定终点（backward design）：具体化读者读完手里多了什么「可复用的东西」，如对照表、判断框架、决策路径、口诀、checklist。反模式是终点只定到「读者理解」。
- 阶段 3 · 抓核心点（≤ 3 个）：依据工作记忆铁律，默认 3 个，最多 5 个，超过必须合并或降级到附录。核心点之间关系须显式想清楚（并列 / 依赖链 Why → What → How），并做砍半测试。
- 阶段 4 · 选主结构（一个，不要叠）：按内容性质选时间线、分类章节、问题导向 Q&A、由浅入深教学梯度、before/after、危机-转折-启示之一；主视觉选一种主导（表 / 对比卡 / ASCII 图 / Callout）。
- 阶段 5 · 写：开篇 TL;DR / 钩子前置；每段一个论点句开头；每个正面论点配反例；结尾给「出口」（可复用产物 + 下一步行动 + 边界声明）；数据带出处；复盘类内容遵循 blameless 原则；加入检索提示。
- 阶段 6 · 自检 5 问：不懂这事的人能看懂吗；读完一周后能复述核心吗；最长那段砍一半还说得通吗；每段是否都在一屏内；是按详略档完成度产的还是为凑字数硬加的吗。
输出文件规则
HTML 顶部必加「本次配置 + 追加提示」条，位于 Hero 区下方、正文上方，包含两行：配置行（受众 / 终点 / 详略 / 风格）与提示行（可让用户追加「展开某章节」「加背景/案例/可复用框架」或「砍到要点」「合并某两章」）。配置条只写阅读时间不写字数。
文件路径默认写入项目 docs/ 下：docs/[内容主题]-[YYYYMMDD].html；若项目没有 docs/，写入用户指定路径或当前目录。写完 HTML 后运行 open <path> 在浏览器打开供 review。
适用场景
适合需要产出结构化、可读 HTML 长文的复盘、总结、教程、学习指南、报告、说明文档等；不适合短输出、操作型任务、非 HTML 需求，以及已有专门技能覆盖的 PRD、文章写作、起名等场景。
限制
产出只有 HTML 一种格式；依赖结构化询问工具（没有该工具时用一条消息问清同样四个维度）；单文档素材选教学版会触发反劝；字数不进用户视图，仅承诺阅读时间。