scene-list

name	scene-list
description	当用户提到「场景清单」「场景梳理」「梳理一下需求」时触发。新项目 / 复杂链路第一步自动触发，场景边界模糊或需求描述笼统时优先于其他 skill 触发。
type	pipeline
output_format	.md
output_prefix	scene-list-
pipeline_position	1
depends_on	[]
optional_inputs	[]
consumed_by	["architecture-diagrams","interaction-map","prototype","prd","cross-check"]
owns	["view-划分","编号","优先级","设备","叙事主线"]
forbids	["字段表","状态全集","池策略","埋点","跳转规则"]
scripts	{"render_scene_list.py":"可选 HTML 视觉版 — python3 .claude/skills/scene-list/scripts/render_scene_list.py {项目名}","check_scene_list.py":"结构自检（重复编号 / 优先级值 / 设备空）— python3 .claude/skills/scene-list/scripts/check_scene_list.py {scene-list.md} [--strict]"}

场景清单 Skill（Scene List）

触发与定位

做什么：所有复杂链路的第一步，锁定三件事供下游 skill 复用：

1. View 划分 — 产品拆为几个独立端 / 视角
2. 场景编号 — 每个场景的唯一编号（确定后不可改动）
3. 优先级 — P0 / P1 / P2 / 后续

何时触发：新项目 / 复杂链路第一步 / 场景边界模糊时优先于其他 skill 触发。

不做：交互细节（归 interaction-map）/ 行为规格（归 prd）/ 页面结构（归 prototype）。

改脚本前 30 秒

hook 守的是「Read 过本文件」不看读了多少行。改 scripts/render_scene_list.py 用 Read 此文件 limit=80（§1+§2 即够）。改产出物建议全文。

Public API（不可改签名）：

• python3 render_scene_list.py {项目名} — 唯一入口，读 projects/{项目}/scene-list.md，输出 projects/{项目}/deliverables/scene-list-{项目}.html
• python3 check_scene_list.py {scene-list.md} [--strict] — 结构自检；hook + 人工自检共用

会拦你的 hook：

• post-script-syntax-check — pyflakes / py_compile
• post-cjk-punct-check — 全角标点强制（输出 HTML 中文文案）
• scene-list-gate — 存 scene-list.md 自动跑 check_scene_list.py（warn 级，重复编号等）

改完跑啥：

python3 .claude/skills/scene-list/scripts/render_scene_list.py {真实项目} && open projects/{真实项目}/deliverables/scene-list-*.html

深入读什么：完整自检规则 grep -A 20 "^## 自检清单" SKILL.md

硬规则（FAIL 即拦）

1. 编号锁定：scene-list.md 确认后编号不可改动；新增场景在末尾追加，禁插入老编号中间
2. 叙事主线唯一源：scene-list 顶部 叙事主线：xxx 一行（≤ 30 字）是 IMAP parts[].story 的唯一来源。脱钩 → IMAP build 报错
3. 场景顺序：按 §5 Step 2.5 叙事主线（叙事型）/ IA 归属（规则系统型）排，禁按字母序硬排——A 在 B 前是因为故事先讲 A
4. 项目形态分流硬度：
   • 叙事型（用户旅程清晰）：Step 0 痛点提问 + Step 2.5 叙事一句话强制
   • 规则系统型（IA + 数据枚举 + 规则映射，无典型主流程）：Step 0 改问 IA 切分，Step 2.5 叙事主线可填「—」显式跳过
5. 设备列必填：每个场景标 📱phone 或 🖥web，下游 IMAP 骨架脚本读此列决定设备壳类型

核心输出规范

• 位置：projects/{项目名}/scene-list.md（md 是 source of truth）