用途：为文档产出可复现的产品截图集，目标是文档效果而非仅生成 PNG。先判断捕获边界：React 固定 props 用 astroshot react，固定 Ink 状态用 astroshot ink，真实终端/键盘流程用 astroshot pty，需登录、路由、实时数据或完整浏览器外壳用 agent-browser，原生应用需项目自有确定性截图钩子；固定输入能表达状态时用 fixture，需证明应用边界时用真实浏览器。可选 astroshots-review 做人工评审。
准备：先审计文档契约——找到内容根目录与公共资源目录，不预设框架；阅读附近两页了解图片语法、命名、尺寸与语气；找到截图清单或 playbook、已有 fixture 或浏览器旅程、文档构建或预览命令。无清单时在 fixture 源码或文档旁维护小型 manifest；无来源的已提交 PNG 会过期。
规划：每张图记录读者问题、稳定文件名与目标位置、捕获技能与模式、fixture/manifest/路由、视口或终端尺寸、就绪选择器或预期文本、合成数据、教学性 alt 文本、所属页面与再生成命令。用最小集合说明工作流。
产出与检查：按所选技能当前命令契约执行；原生 harness 用其文档化入口并等显式完成标记；fixture 与批量 manifest 纳入版本控制，尽量直接输出到文档资源目录。文档化 movie 时抓能教会读者的查看器状态而非仅海报帧；文档化用户故事时分别证明场景列表、运行历史/汇总与转录步骤证据。用可用图像检查工具打开每张图，检查教学状态可见、文字在渲染宽度可读、布局未被裁剪或仍在加载、终端颜色与画线可辨、合成名称值一致、无凭据/客户数据/内部主机名/工作树标识、透明角与裁剪干净。失败图从来源再生成，不手改 PNG。
可选评审：按 astroshots-review 技能以运行唯一 feature 流式展示资源，避免旧帧混淆；仅当当前运行与图像哈希匹配 review.json 中人工确认时才报 seen，seen 不等于批准或发布。非 macOS 或不可用时仍须目视检查每张 PNG。
嵌入与渲染：在目标页更新图片引用，alt 文本描述读者应理解的状态、选择或动作而非“截图”；更新清单含来源、再生成命令、尺寸、资源与所属页面；运行文档构建或预览，在桌面与窄宽度打开渲染页，确认路径文件名大小写、可读性、裁剪与上下文。
信任边界：React 与 Ink fixture、配置、导入、PTY 命令和浏览器页面会以当前用户权限执行代码，捕获前审查不可信变更；CI 中固定 npm 版本并审查包来源。报告中说明每项资源的来源与模式、资源与所属页路径、各帧证明内容、所做视觉与渲染检查、清单与再生成命令、Astroshots feature 与人工评审状态及每条意见、无法复现或检查之处。