القائمة
可发布软件使用说明书（/manual）— 故事线 · 配图 regen · Manual Contract · 多 Capture Profile。项目无关 · 操作者无关。说「使用说明书」「用户手册」「配图 regen」「walkthrough 截图」时用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
总入口（/master）— 迷路时 AskQuestion 路由 plan/run/learn 等
交付验收（/delivery）：视觉 · i18n · 文档对齐 · 后端对接 · 组件完整度 · 可维护性 · 生产就绪。Sprint 收尾或 /release 分支前走查。说「交付验收」「上线前检查」「生产就绪」时用。
规划（/plan）：需求→先总后分→Sprint→plan.md→/run。说「规划」「拆任务」时用。禁止写业务代码。≠ IDE Plan 模式。
Sprint 出口（/release）：分支 merge/PR/保留/丢弃 4 选 1 · semver · CHANGELOG · tag。 说「收尾」「merge」「开 PR」「发版」「打 tag」「分支怎么办」时用。自治发版→ship agent。
执行（/run）：gate-check→ACTIVE→验收→审计→CHANGELOG→README（门面）→plan→必 commit。每任务/Sprint 收尾自动提交。
脚手架（/scaffold）：空项目创建栈模板，已有项目审计与建议。说「初始化」「创建项目」「脚手架」时用。须用户确认后再创建。
| name | user-manual |
| description | 可发布软件使用说明书（/manual）— 故事线 · 配图 regen · Manual Contract · 多 Capture Profile。项目无关 · 操作者无关。说「使用说明书」「用户手册」「配图 regen」「walkthrough 截图」时用。 |
用这个：生成或更新可单独发布的操作手册（故事线 + 实机截图 + 双层验收）。不是那个：上线前文档↔实现走查 → /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 截图」/release 发版前：可选 manual regen + Reader Test（见 reference/regen-gates.md）config/manual.yaml 或 learn/user-manual.md；无则 AskQuestion + 用 templates/manual-contract.example.yaml 起草reference/extract-sources.md 优先级补全 storylines · shotsverify / task-verify 全绿后才 regen（发版档）；见 reference/regen-gates.mdcapture.profile 跑 walkthrough → sync assets → 更新 docreference/reader-test.md）| 阶段 | user-manual | 不做 |
|---|---|---|
| ia | — | 导航结构规划 |
| test | 复用 walkthrough spec 作 capture 输入 | 替代行为断言 |
| delivery | — | regen 截图 · 替代 7 维走查 |
plan DOC-* | 协作写正文 · Reader Test 编排 | 替代 contract schema |
| release | 发版档可选 regen | 跳过 verify 门禁 |
| 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。
verify 绿仍声称「配图已更新」inferred