前言¶
Web 或 SaaS 产品的用户手册往往滞后于界面迭代：截图散落在需求文档里，说明文字不成体系，目录和章节编号需要人工维护。常见做法是产品经理或运营从零写 Markdown，或把截图贴进 Word 再排版，重复劳动多，且很难在「分批补图」时保持结构一致。
下面介绍 SkillHub 社区 Skill screenshot-to-manual（坐标 @user_e6037293/screenshot-to-manual）。它把「用户提供截图与简短说明、Agent 负责结构化撰写」写进工作流，输出标准 Markdown 操作手册，并支持按批次追加截图、逐步完善章节。
这是什么¶
screenshot-to-manual 是面向 office-efficiency 分类的社区 Skill，当前版本 1.0.0，由发布者 user_e6037293 维护；包内 SKILL.md 标注作者为 MeMeShun。SkillHub 页面显示该 Skill 不需要 API Key（requires_api_key=false）。
一句话定位：根据用户提供的 UI 截图和简短文字说明，自动生成结构化的产品操作手册（Markdown），并支持增量迭代——用户分批交图，Agent 按同一套目录与写作规范持续补章、改结构、做审查。
核心功能¶
以下能力均来自官方 SKILL.md，可按四个阶段理解。
初始化手册框架（Phase 1）¶
首次提出编写需求或提供首批截图时，Agent 会：
- 结合截图与描述梳理页面层级、功能模块、用户角色与操作类型（如增删改查、审批、配置等）。
- 设计推荐大纲（系统概述、首次使用、按模块展开的功能章、字段说明与 FAQ 附录等）。
- 创建 Markdown 主文件，写入标题、版本、更新日期与完整目录占位。
增量式内容编写（Phase 2）¶
用户分批提供截图时，Agent 对每张图做结构化分析（页面位置、功能操作、UI 元素、表单/表格字段、状态与操作流程等），将图片整理到 assets/manual_images/ 并按 {编号}_{功能模块}_{具体操作}.png 命名，再按统一模板撰写「操作步骤」「表单字段」「表格字段」等小节，并在文中嵌入  截图引用。
结构重组与优化（Phase 3）¶
内容增多后，可按用户反馈调整模块归属、插入中间层级、合并或拆分章节；重编号时强调从大到小替换、目录/正文/交叉引用三处同步，并用检索验证无遗漏。
质量审查与完善（Phase 4）¶
提供审查清单：目录与正文一致、编号连续、锚点有效、截图路径存在、格式统一、步骤完整等；并建议优化第 1 章概述与 FAQ 附录，重大更新时递增文档版本号。
核心理念在 Skill 中写得很明确：用户负责提供素材，AI 负责结构化撰写；UI 描述须基于截图实际内容，用户文字说明用于功能定性。
安装与启用¶
安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可执行（完整安装含默认 Skill，见 SkillHub 安装说明）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 screenshot-to-manual¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别：
skillhub install screenshot-to-manual --namespace user_e6037293 --dir <skills 目录>
常见路径示例（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将下面提示交给支持 Skill 的 Agent，由其按安装文档拉取：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_e6037293/screenshot-to-manual`。
安装后需在对应客户端按其产品说明启用或刷新 Skills 目录（SkillHub 页面亦采用上述安装提示）。
典型用法¶
Skill 内给出的协作流程可直接复现，无需额外配置字段。
Step 1：初始化
用户：这是注册和登录页面的截图，写操作手册吧
AI：→ 分析截图 → 创建手册框架 → 编写第 1–2 章
Step 2：增量迭代
用户：这是助手页面-智能体管理的截图
AI：→ 分析截图 → 新增对应小节 → 更新目录
用户：继续写技能管理
AI：→ 分析截图 → 新增下一小节 → 更新目录
Step 3：结构调整（按需）
用户：第 4–9 章应该归属在后台管理下
AI：→ 重组章节结构 → 重编号 → 更新交叉引用 → 验证
Step 4：质量优化
用户：整体看看还有哪些不足
AI：→ 全面审查 → 优化概述章 → 补充 FAQ → 修复锚点 → 更新版本号
手册文件头可采用 Skill 提供的模板，例如：
# [产品名称] — 产品操作手册
> **适用系统**：[产品全称]
> **文档版本**：V1.0
> **更新日期**：[YYYY-MM-DD]
---
## 目录
[自动生成的目录]
适用场景与注意¶
适合谁
- 需要为 Web/SaaS 产品编写或维护用户操作手册的产品、运营或技术写作者。
- 界面已部分成型、能持续提供截图与简短模块说明，希望输出可版本管理的 Markdown 而非一次性长文档的团队。
限制与注意
- 效果依赖截图清晰度与说明准确性；Skill 明确要求不要臆造截图中不存在的 UI。
- 增量编写时需保持
assets/manual_images/命名与章节引用一致，重组章节后务必同步目录与锚点。 - SkillHub 统计（以页面抓取为准）：评分 100000，下载约 971 次，安装计数为 0——仅反映商店数据，不代表本地启用情况。
- 本 Skill 为通用写作流程指引，不绑定特定构建工具或 CI；产出为 Markdown 文件，发布到帮助中心或静态站点需自行对接现有文档管线。
结尾¶
screenshot-to-manual 把「截图 + 短说明 → 结构化手册 → 分批迭代与审查」固化成 Agent 可执行的规范，适合在界面迭代频繁时降低手册维护成本。官方 Skill 包地址：https://api.skillhub.cn/user_e6037293/screenshot-to-manual；SkillHub 浏览页：https://www.skillhub.cn/skills/user_e6037293/screenshot-to-manual。
