API文档生成器（生成即用·API文档）
> 设计范式：触发 → 弹窗分步引导（模式/参数/确认）→ 直接落盘成品文件 → 预览精修。
> 适用：按风格与端点，直接生成 API 文档（Markdown 或 OpenAPI）。
★ 核心：输出模式选择器（主动弹窗确认）
Skill 激活后，第一步用交互式选项向用户确认输出模式，不靠猜词：
- ① 成品：用户提供真实数据/素材 → 直接生成可运行/可投稿的成品文件。
- ② 半填充模板：给部分数据、留占位符 → 半填充的可运行文件。
- ③ 模板：只给骨架 + 占位符 + 说明，用户自行填。
若用户已显式说"模板/教我"或"直接出/帮我画好/生成文件"，直接走对应模式；若提供真实数据，自动偏成品并提示可切回模板。
触发词
「生成API文档」「写接口文档」「openapi文档」
示例：「给用户和订单两个接口出份Markdown文档」
参数弹窗（领域参数）
激活并选定模式后，弹窗确认以下参数（支持多选与条件分支）：
- 风格：Markdown / OpenAPI 3
- 端点清单：粘贴 / 逐个填
- 含示例：请求/响应示例 是/否
- 鉴权说明：是 / 否
生成与落盘
按所选模式+参数，直接写出文件到用户指定/默认目录：
- 产出物：API 文档（端点/参数/响应码/示例）+ 可选 openapi.yaml。
- 成品模式规范：字体≥8pt、配色对比达标、含必要标注（误差棒/单位/图例）、导出路径明确、命名规范。
选型与说明（领域）
内部→Markdown轻量；跨团队/前端→OpenAPI可生成客户端；必含错误码表。
领域模板 / 产出示例
- 端点块：METHOD /path | 参数表 | 200示例 | 4xx说明。
- OpenAPI：paths+components.schemas结构。
异常处理（三级响应）
- 需求模糊 → 弹窗反问关键项（用途/受众/格式/数据）。
- 超出边界（需实时API/付费数据/联网抓取）→ 说明限制并转诊或给替代方案。
- 数据/素材缺失 → 要示例数据，或先给占位结构（模板模式）。
反模式（8条）
- 不看模式直接写：必须先弹窗确认成品/半填充/模板三模式，不靠猜词。
- 一次性甩太多参数：用多选弹窗 + 条件分支 + 渐进披露，首屏只问必填项。
- 产出无明确路径：每次必须回显文件落盘位置，默认当前工作目录。
- 模板与成品混为一谈：两模式严格区分，模板留占位符、成品填实数据。
- 忽略异常处理：三级响应（模糊→反问 / 超界→转诊 / 缺料→要示例）必写。
- 风格飘忽：成品模式强制样式规范（字体≥8pt、对比达标、含必要标注）。
- 不回显参数：输出首段回显"模式+关键参数"，避免跑偏。
- 超能力承诺：边界内交付，需实时API/付费数据/联网抓取时明说并转诊。
FAQ（10条）
- 和纯指南类 skill 区别？ 本 skill 每次运行必产出可打开/可编辑的落地文件，不是只给建议。
- 弹窗在别的平台能用吗？ WorkBuddy 内是真实多选卡片；其他平台 SkillHub 下载包退化为清晰多选文字，仍比被动猜词稳。
- 模板和成品怎么选？ 想学方法/反复换数据用模板；赶投稿/工期用成品（给真实数据直接出图）。
- 产出文件在哪？ 输出首段回显绝对路径，默认当前工作目录，可指定。
- 能改风格/配色吗？ 参数弹窗可选配色预设、输出格式（md/docx/xlsx/html/png 等）。
- 不提供数据能出吗？ 模板模式可不给数据，只给骨架+占位符+说明。
- 支持哪些输出格式？ 见各 skill「产出物」说明，多为 md/docx/xlsx/html/py/png/svg。
- 中途出错怎么办？ 异常处理三级响应会引导你补齐信息或转诊。
- 能一次出多个文件吗？ 支持"多文件套装"（主文件+配套），弹窗可勾选。
- 怎么二次修改？ 产出文件可直接编辑；或把修改点告诉 agent 重跑微调。
固定输出结构（5段）
- 模式与参数回显 2. 选型依据 3. 生成文件清单+绝对路径 4. 关键参数/样式说明 5. 使用与修改提示
