用途:Andocs 技能用于启动本地 Andocs 演示或预览、介绍与展示 Andocs、引导新用户,以及编写 Andocs 文档。
主要能力:涵盖 Markdown 渲染(图表、数学公式、交互式 html-preview 块、Andocs 专属链接)、原型(prototype.json、HTML 页面、页面导航、相对静态文件、共享资源、原型块)、评审状态与发布(屏幕评审徽章、releases.json、<id>@<release>.html 屏幕变体)、原型状态(刷新后保留数据、迁移有状态原型)、Web Components(Custom Elements、Shadow DOM)以及 OpenDesign 交接。
使用方式:介绍或本地演示时按介绍流程操作,并用指南中发布的 CLI 命令启动本地预览。其他编辑任务需先从请求或仓库中确定文档根目录;若存在多个可能根目录,应询问使用哪一个,并遵循仓库的语言与预览规则。按任务类型阅读对应参考文档。请求本地预览时,确认文档根目录并检查 Bun 是否可用;仅在用户与仓库说明授权启动服务器时,使用 bunx andocs@latest serve --path <docs-root>。CLI 帮助为 bunx andocs@latest -h。
限制:完成前需检查引用的文件是否存在、围栏代码块语言是否正确,以及原型状态能否处理存储不可用的情况。公开的 Andocs 演示展示了完整的原型仓库。