SuperAPI AI 工具集

agent-isles-render

写作与研究

查看项目

更新于 10-16 07:19

技能介绍

用途:当用户需要渲染、预览、监视或冒烟测试一份 Agent Isles Markdown 文档时使用本技能。

主要能力:调用 isles CLI 将 Markdown 渲染为 HTML,支持指定输出文件与资源模式,支持实时监视文档变化,并对生成产物做校验。

使用方式:先确认源 Markdown 路径存在。若项目已安装 agent-isles,优先使用项目内 CLI:npm 用 npm exec -- isles render <file.md> --out <file.html> --assets local;pnpm 用 pnpm exec isles render <file.md> --out <file.html> --assets local;yarn 用 yarn exec isles render <file.md> --out <file.html> --assets local。若尚未安装或用户要求不改动依赖,可运行内置 doctor 辅助工具(--json --smoke <file.md>)并采用其 commands.oneShotRender 建议,形如 npx agent-isles@next render <file.md> --out <file.html> --assets local。仅在用户希望把 Agent Isles 加入项目时才使用 agent-isles-install-update。实时编辑使用 isles watch <file.md> --out <file.html>。

校验:确认输出文件存在,并包含 Agent Isles 主题引用、组件包引用,以及源文档中预期的正文文本或自定义元素。

限制与建议:对可信 Markdown 渲染时可选默认模式;渲染不可信或混合可信度 Markdown 时应使用 --mode sanitized;需要持久审阅产物或离线环境时使用 --assets local。生成的 HTML 应作为产物保留,源内容修改在 Markdown 中进行。其他功能细节暂未提供。