iWiki MD 发布器

解决什么问题

很多团队已有 HTML 报告、产品说明、CLI 文档或周报，但直接粘进 iWiki 后容易变成朴素 Markdown：结构散、样式不可控、代码块与卡片割裂，甚至被富文本渲染拆行。iWiki MD 发布器 关注的是把用户可见内容转成稳定可发布的 iWiki MD 页面，而不是重新写一份说明文。它默认产出报告风或门户风页面，保留源文案，并围绕 iWiki 的兼容边界做布局、卡片、章节和代码展示。

技能如何工作

该技能会先把环境作为前置条件：需要 PAT token、可在新登录 shell 中调用的 iwiki-cli，以及持久化的 PATH 与 IWIKI_TOKEN。在这些条件未满足时，它会先停下来处理 setup，而不是继续生成内容。内容阶段则按以下步骤推进：

• 从源 HTML 或 MD 中提取章节、标题、正文、链接和命令片段，不依赖 DOM 结构。
• 用 iwiki-cli metadata 检查目标页；更新已有页面时先 iwiki-cli get 拉取云端正文并备份。
• 从通用门户、产品 / CLI、功能介绍、帮助手册、资讯摘要等模板中选择变体，而不是每次从零拼页面。
• 对代码内容选择两种模式之一：原生复制 使用 fenced code block；一体化视觉 使用保守内联 HTML 代码面板。
• 发布前尽量使用 div、span、a、strong 和简单 flex 布局，避免 JavaScript、SVG、复杂语义标签和高级 CSS。

适用边界

它适合把已有内容整理成 iWiki 页面，不适合凭空生成新增解读、培训说明或品牌化文案。若目标页类型不兼容，技能会倾向在父节点下新建 MD 页面，而不是硬改旧页。若 CLI 因运行时环境阻塞，输出中会明确说明这是环境阻塞，而不是内容转换失败，并提示先完成运行时升级、setup 与发布校验。