技能：Tour Narrative Scripting
所有者：Sara
版本：1.0
首次使用：2026-03-24（Reddi Agent Protocol 双重受众游览）
此技能的功能
从单个游览规格输入生成双用途副本：
标题 — 简短的标签，用于幻灯片显示（≤12 个字）
叙述 — 每步 1-2 句用于 TTS 声音
常见的失败模式是为幻灯片编写优化的标题，然后发现叙述需要完全重写。
此技能通过从一开始将两个注册视为单个写作单位来避免这种情况。
输入
来自 Phase 1 / Archie 的游览规格，包括：
步骤表（ID、标题、URL 路径、受众标签、交互）
叙述弧（3-4 句故事摘要）
双重注册模式
标题（幻灯片）：≤12 个字。名词短语或片段可接受。不做受众假设。
叙述（TTS）：1-2 个完整句子。主动语态。自然的口语节奏。建立在标题之上。
标题和叙述服务于相同的步骤，但面向不同的上下文：
标题在屏幕上静默阅读。它必须瞬间定位查看者。
叙述被听到，而不是阅读。它必须听起来像一个人在说话，而不是手册。
同时编写两者，每一步都这样做。不要先完成所有标题，然后编写所有叙述 — 注册将会漂移。
输出格式
步骤 03 — 代理市场 [所有]
标题： 浏览 11 个注册的专家 — 按模型、费率、声誉筛选
叙述： 代理索引列出了每个注册的专家及其模型、每次通话费率和链上声誉评分。没有策划、没有批准 — 注册是无需许可的。
每一步一个块。步骤编号使用零填充（01、02...）。受众标签在标题末尾的方括号中。
示例
良好的标题：“两条路径。一种协议。”
叙述：“无论您是提供计算资源还是雇用它，协议都是相同的。在链上托管、盲声誉评分和按次付费 — 没有月度订阅、没有守门人。”
为什么有效：标题是一个钩子，而不是描述。叙述扩展了这个想法，而不是重述可见的内容。两者都可以独立工作。
糟糕的标题：“登录页面显示产品”
叙述：“此截图显示了 Reddi Agent Protocol 应用程序的登录页面。”
为什么失败：标题是对截图的描述，而不是关于产品的陈述。叙述僵硬，听起来像标签，而不是声音。两者都无法通过大声朗读的测试。
受众标签规则
标签 您的受众 代词使用
[所有] 尚未确定路径的人 “你”可以；避免“作为专家”或“作为编排者”
[专家] 提供计算资源/运行代理的人 “你”= 专家 — “您的 Ollama 实例”，“您的费率”
[编排者] 雇用计算资源/提交作业的人 “你”= 编排者 — “您的简报”，“您的托管”
永远不要在单个标题中混合受众假设。如果步骤是 [所有]，则标题必须对两条路径上的任何人都有意义。
计时检查
在最终确定之前，大声朗读每一步：
元素 目标时长 超过时的操作
标题 ≤3 秒 剪切字 — 片段可以
叙述 8-15 秒 分成两个步骤，而不是加快 TTS 速度
如果叙述经常超过 15 秒，则该步骤尝试承载太多内容 — 将其分解或将解释移到较早的步骤中。
常见错误
叙述描述了可见的内容。完全剪切“这里我们可以看到...”和“这显示...”
查看者可以看到截图。叙述应该描述它的含义，而不是它是什么。
在每一步中过度解释机制。建立核心协议概念一次（理想情况下在步骤 1-3 中）。之后，简要引用它（“相同的托管机制”），而不是从头开始重新解释。
重复听起来像对受众的不信任。
丢失叙述线索。每一步都应该感觉像同一个故事的下一个句子。忽略截图，连续阅读所有步骤的叙述。它是否像一个连贯的 60-90 秒的独白一样流畅？如果它听起来像断开的要点，请重写以实现连续性。
在双重受众游览中发生的代词漂移。[所有] 步骤意外使用“您的代理作业”（编排者框架）会疏远专家。检查 [所有] 步骤中的每个代词，以确保受众中立规则。
将叙述保存到标题完成后。仅为眼睛编写的标题通常使用片段逻辑（“按模型筛选。费率。声誉”），这需要为耳朵重写（“您可以按模型、费率或声誉评分筛选”）。同时草拟两者；调整一个注册，然后调整另一个。
清单
在交付给 Kit（第 3 阶段）之前
每一步都有标题和叙述行
所有标题 ≤12 个字
所有叙述通过大声朗读的计时测试（8-15 秒）
[所有] 步骤不包含受众特定的代词
叙述弧可在所有步骤中跟踪
输出格式为步骤块（见上面的输出格式）
相关游戏手册：playbooks/product-tour/PLAYBOOK.md
上游
by