用途:为智能教科书项目中的 MicroSim 提供管理与维护工具,作为单一入口按需加载五类工具指南,并可直接运行配套 Python 脚本。
主要能力:质量校验与评分(检查 main.html、index.md 等必需文件、代码结构、无障碍、文档与响应式设计,输出 0-100 分及建议);截图生成(Chrome 无头模式配合本地服务器,等待 3 秒渲染,输出 1200x800 PNG);图标管理(生成 favicon.ico、apple-touch-icon.png 等);索引页生成(网格卡片布局、截图、字母排序、MkDocs Material 格式并更新 mkdocs.yml);从章节内容提取未实现的图表规格为 TODO JSON;据 TODO JSON 生成 main.html、index.md、metadata.json 脚手架;同步 iframe 高度为 CANVAS_HEIGHT + 2;运行时 postMessage 自适应高度;用 Playwright 检查交互控件是否完整可见;用 Claude Vision 审查渲染布局;生成跨章节图表/MicroSim 状态报告。
使用方式:按触发关键词路由到 references/ 下对应指南,或运行脚本,例如 python3 /path/to/skills/microsim-utils/scripts/create-microsim-todo-json-files.py --project-dir /path/to/project、scaffold-microsims-from-todo.py、sync-iframe-heights.py(支持 --sim、--dry-run、--write-metadata、--verbose)。截图脚本为 ~/.local/bin/bk-capture-screenshot <microsim-directory-path>。iframe 测试需先 pip install playwright && playwright install chromium。
适用场景:校验 MicroSim 质量、生成预览图、管理图标、生成索引页、提取 TODO、生成脚手架、修正 iframe 高度、运行时自适应、验证控件可见性、视觉布局审查、图表覆盖审计。
限制:脚本需指定 --project-dir 指向含 mkdocs.yml 的项目根;scaffold 脚本即使加 --force 也不覆盖已有 main.html;布局审查最多 3 轮修补;旧 Node.js 版 iframe 测试已弃用,仅支持 Python 实现。其余细节暂未提供。