storytelling

用途

该技能用于为网站创建或修订故事与体验方向，产出一份文档：docs/design/storytelling.md。它从项目已有的材料出发，说明意图——访客在每个时刻应感受到什么、理解什么，而不涉及页面如何排列或构建。文档中的每一条都是建议，构建者可以提出异议。该技能本身不构建任何东西。

主要能力

• 从现有材料中确定每个站点的角色，并检测工作起始状态。
• 评估当前体验（当项目站点存在时），描述体验今天交付了什么，保持描述性，不进行评判。
• 定义概念：论点（体验所主张的一句话）、张力（访客到达时的信念或感受，体验必须改变它）、感受（访客离开时的感受与理解）。
• 塑造弧线：从张力到解决排列各个时刻，每个时刻命名访客应感受或理解的内容，以及故事如何在此处调节节奏：暂停（访客停留）、保持（稳定）或加速（故事加快）。故事决定时刻的数量；承载相同意图的两个时刻应合并。
• 指导体验：用文字命名整个弧线的节奏、每个交互在故事中赢得角色的位置，以及故事所需的视觉氛围。决定运动（动效、视频或滚动）是否服务于故事并给出理由；不需要运动的故事应说明这一点。
• 给出建议：当项目站点被评估或视觉识别存在时，记录应保留什么、应重新诠释什么，以及视觉识别与概念或当前体验之间的任何冲突。建议保留在文档中；技能不编辑任何现有产物、代码或识别。
• 写入文档：阅读 storytelling.md。其 MUST NOT 列表说明哪些内容不进入文档。每条内容以现在时陈述其现状，而非达成它的交流或 deliberation；修订写入新状态，而非变更。对话中的任何内容都不进入文档：没有“如所讨论”、“用户接受了”、“我们同意”。当先前文档存在时，就地修订：保留新材料未触及的每个部分，并对照新材料重新检查每条已记录的声明。内容变化时将状态设为 draft；只有用户可设为 agreed。首次写入时设置 created，每次写入时设置 updated。
• 报告：报告路径、文档内容的一到三句话概述（修订时说明变更内容），以及它携带的开放问题。绝不粘贴文档。

使用方式

流程为：materials → state → assess → concept → arc → experience → recommend → document。若无项目站点，则跳过 assess。加载 context.md，找到材料，确定每个站点的角色，并检测工作起始状态。当项目站点存在时，加载 assessment.md 并描述体验今天交付了什么。评估保持描述性；此时尚无概念可供评判。从材料和评估中写出论点、张力和感受。当材料已陈述信息、受众或目标时，使用它们，只补充材料缺少的内容。先前文档的概念是起始主张：确认、调整或替换它。

适用场景

适用于需要为网站创建或修订故事与体验方向的场景，从项目已有材料出发，明确访客在每个时刻的感受与理解。

限制

• 描述每个时刻的意图，绝不描述排列：没有章节顺序、网格或线框。
• 外观留给视觉识别：调色板、字体和令牌不进入。
• 机制留给构建者：时序、缓动、滚动长度、渲染器、库和资产不进入。
• 每条消息只问一个问题，且仅在发现或概念需要答案时。未回答的项目记录在 Open Questions 下，而非猜测。
• 关于当前体验的每条声明都需有截图或代码位置作为证据；没有证据即为开放问题。
• 该技能不构建任何东西，不编辑任何现有产物、代码或识别。
• 文档中不得出现对话内容、交流或 deliberation。
• 状态只能由用户设为 agreed。