| name | user-manual |
| description | 可发布软件使用说明书（/manual）— 故事线 · 配图 regen · Manual Contract · 多 Capture Profile。项目无关 · 操作者无关。说「使用说明书」「用户手册」「配图 regen」「walkthrough 截图」时用。 |
user-manual · 软件使用说明书
用这个：生成或更新可单独发布的操作手册（故事线 + 实机截图 + 双层验收）。不是那个：上线前文档↔实现走查 → /delivery；行为红绿测试 → test；大改版 Sprint 编排 → plan DOC-*。
母版正文零业务词、零演示账号、零具体仓库路径。项目命令与命名 → Manual Contract（config/manual.yaml 优先；无则 learn/user-manual.md）。
详文：reference/pipeline.md · reference/manual-contract-schema.md · reference/extract-sources.md · reference/capture-profiles.md · reference/regen-gates.md · reference/reader-test.md · reference/storyline-template.md · reference/scaffold-bundle.md
何时进入
- 用户说
/manual · 「使用说明书」「用户手册」「配图重新生成」「walkthrough 截图」
- plan Done when 含可发布操作手册 / manual regen
/release 发版前：可选 manual regen + Reader Test（见 reference/regen-gates.md）
流程（五段 · 概览）
- 读 Contract —
config/manual.yaml 或 learn/user-manual.md；无则 AskQuestion + 用 templates/manual-contract.example.yaml 起草
- 提取 / 学习 — 按
reference/extract-sources.md 优先级补全 storylines · shots
- 门禁 — 项目
verify / task-verify 全绿后才 regen（发版档）；见 reference/regen-gates.md
- Capture regen — 按
capture.profile 跑 walkthrough → sync assets → 更新 doc
- 验收 — L1 脚本（文件/链接）+ L2 Reader Test（
reference/reader-test.md）
与下游分工
| 阶段 | user-manual | 不做 |
|---|
| ia | — | 导航结构规划 |
| test | 复用 walkthrough spec 作 capture 输入 | 替代行为断言 |
| delivery | — | regen 截图 · 替代 7 维走查 |
plan DOC-* | 协作写正文 · Reader Test 编排 | 替代 contract schema |
| release | 发版档可选 regen | 跳过 verify 门禁 |
Capture Profile 分流
| profile | 典型栈 | 详则 |
|---|
web-fullstack | SPA + API | reference/capture-profiles.md §web-fullstack |
web-spa-only | 纯前端 / mock | 同上 §web-spa-only |
electron | Electron 壳 | 同上 §electron |
flutter | Desktop / Mobile | 同上 §flutter |
native-window | MFC / Qt / 自绘 GUI | 同上 §native-window（系统 screenshot 兜底） |
Contract 未指定时：有 DOM/可访问树 → Playwright 系；仅窗口像素 → native-window。
禁止
- 在 skill 正文写死项目 URL、账号、业务术语、具体 PNG 文件名
- 无
verify 绿仍声称「配图已更新」
- 用 manual regen 替代 delivery 或 task-verify
- 无 Contract 时编造故事线而不标
inferred
