用途:该技能以多阶段流程自动生成交互式软件手册,输出为 TiddlyWiki 风格的单文件 HTML,内含截图、API 文档与分级代码示例,适用于编写用户指南、软件说明与 API 参考。
主要能力:采用主 Agent 编排、子 Agent 执行的架构。子 Agent 分别产出 overview(产品介绍、功能、快速上手)、ui-guide(界面操作步骤)、api-docs(REST 与前端 API)、configuration(环境变量、部署、设置)、troubleshooting(FAQ、错误码、解决方案)、code-examples(初级/中级/高级示例)六个章节。支持通过 extract_apis.py 自动提取 FastAPI、TypeDoc、pdoc 文档;通过 Chrome MCP 批量截图。HTML 内嵌 marked.js 与 highlight.js,无 CDN 依赖,具备全文搜索、折叠展开、标签导航、明暗主题切换、离线可用与打印优化等特性,CSS/JS/图片以 Base64 内嵌。
使用方式:流程分阶段执行,依次为需求收集(manual-config.json)、项目探索(exploration-*.json)、API 提取、6 个子 Agent 并行分析、整合质检、截图捕获、HTML 组装与迭代优化。中间产物存放于 .workflow/.scratchpad/manual-{timestamp}/ 目录,最终输出 {软件名}-使用手册.html。子 Agent 返回路径与摘要(摘要不超过 50 字符),避免上下文溢出。
限制:截图为 Chrome MCP 依赖;API 提取仅列出 FastAPI、TypeDoc、pdoc 三种工具;具体安装命令、收费与价格信息暂未提供。