技能 HTML 介绍页生成器

问题

Agent Skill 往往有 SKILL.md（面向 AI 触发匹配）和可选的 USAGE.md（面向人类用户），但缺少一份可直接分享的 HTML 介绍页：Hero、功能卡片、Quick Start 分栏、折叠文档区、右侧锚点导航等。手写静态页成本高，且与 Markdown 源文件容易脱节。

工作方式

本技能读取目标技能目录，按优先级选择源文件：--source → USAGE.md → SKILL.md（回退时页面顶部会提示，终端打印 [WARN]）。解析 Markdown 结构后生成 ./output/-intro.html（可用 --output 覆盖），并抽取 ## 小节作为 Highlights / Features（无内容则隐藏区块，不填假数据）。

• 主题：light（默认）、aurora、techblue、finance
• Hero 副标题：建议用 --subtitle 写一句 pitch；否则会从长 description 截断，观感通常较差
• 渲染：优先使用内置 vendored mistune；缺失 vendor/ 时回退到内置正则渲染，不会崩溃
• 部署：不绑定任何托管平台；配置 SKILL_INTRO_DEPLOY_CMD 后可将 HTML 交给你的脚本，成功部署后把 dashboard id 写入 ~/.cache/skill-introduction/cache.json，下次运行更新同一 URL

作者名解析顺序：--author → SKILL_INTRO_AUTHOR → git config user.name → $USER。

边界与注意

• 目标目录必须存在 USAGE.md 或 SKILL.md，否则脚本直接报错退出
• 不要为「好看」而改写 SKILL.md 里的触发描述，那会破坏 AI 匹配；面向用户的文案应放在 USAGE.md
• 未提供 --skill-dir 时不应猜测路径，需向用户确认
• SKILL_INTRO_DEPLOY_CMD 视为可信命令，只指向你控制的脚本