--- name: user-facing-content-boundary description: 当写、重写或重新设计任何用户可见内容时使用,包括官网、首页、UI 文案、更新提示、release notes、changelog、README 对外说明、用户文档、产品介绍、营销内容、截图说明和社交分享元信息;尤其适用于隔离内部讨论与最终呈现、判断旧内容能否继续作为结构基线、区分能力说明与真实用例场景、校验截图数据源,以及检查中文文案是否自然。 --- # 用户可见内容边界 ## 目标 把“内部怎么判断、怎么生产”和“用户最终看到什么”隔离开。用户可见内容只呈现产品结果、用户场景、可观察能力和必要边界,不暴露团队内部的方案讨论、方法论、分类依据或改版理由。 ## 固定流程 1. **先判定表面**:这是对外页面、UI 文案、更新提示、用户文档或 release note,还是内部 design / plan / log。只有内部文档才可以解释决策过程。 2. **先定事实源**:重写或重新设计时,按“当前产品愿景与源码/真实运行界面 > 已确认仍有效的对外事实 > 同类产品调研 > 旧页面”的顺序取材。旧页面只是待核实的信息来源,不因已经存在就自动成为信息架构、篇幅或文案基线。 3. **审计旧内容**:对遗留页面逐项标记保留、重写、取消导航或删除;先按当前产品和用户任务建立完整覆盖矩阵,再决定复用哪些内容。禁止只换主题、导航或首页,却继续沿用已经失效的内容骨架。 4. **拆分材料**:把内部依据、原则、取舍、分类、实现顺序放到方案文档或协作回复;把用户能感知的能力、结果、步骤和限制放到最终内容。 5. **结果化表达**:每句话都回答用户关心的一个问题:我能做什么、在哪里做、得到什么、有什么限制、下一步怎么用。 6. **截图数据源校准**:官网、产品介绍或用户文档中的同一批产品截图必须使用一致的数据源。用户要求真实/本地数据时,所有被引用截图都要来自真实实例和代表性内容,不得混入空态、临时 mock 或只替换局部真实数据。NextClaw 对外产品截图统一使用产品的 `default` 主题;只有用户明确要求展示其他主题时才覆盖。 7. **截图与文案对齐**:产品界面截图必须直接截自正在运行的真实界面;合成宣传卡片、重新排版的界面拼图或仅嵌入真实素材的概念图不得冒充产品截图。每张截图必须完整看见文案声称的关键界面、对象或结果;只出现空壳、标签栏、加载态、空白预览区、被裁断的结果或相邻能力时,必须换图或重截,不能靠文字解释补足。 8. **用例校准**:用例必须是用户带着待办来完成的具体任务,标题应包含对象、动作或结果;`接入模型`、`安装技能`、`统一入口`、`连接渠道` 这类能力入口只能放在能力说明区,不能冒充用例。 9. **动作与受众检查**:标题、价值主张和用例都必须让读者想到具体对象、界面、动作与结果,并能拍成一段真实操作。声称覆盖多类用户时,要逐类指出读者从哪段文字看到了什么实际选择理由;列举“最典型 / 最容易感受价值”的受众时,不得写成排他的“只适合 / 主要面向”名单,除非产品确实限制其他用户。产品对比优先正面说明自身优势在哪些需求中格外明显,不得靠暗示其他用户不适合、其他能力较弱或其他场景不如竞品来建立可信度。`开源`、`本地`、`可扩展` 等泛标签不能单独算作命中。工具或资源名词的并列清单也不算功能说明,必须改写为读者能完成的动作、对象和结果。`融合`、`留在工作台`、`长期表面` 等只有产品作者能解释的结构词,必须改成用户实际会做和看到的事情。 10. **显式分组守恒**:用户已经明确给出受众、主题、优势或场景的数量与分组时,把它当成内容结构合同;不得擅自增删类别,也不得把支撑能力拆成新的并列项。确需重组时,先在讨论中说明理由并获得确认。 11. **中文语感检查**:中文用户可见内容必须像中文直接写成,而不是英文翻译。优先短句和动词句,少用抽象名词堆叠;如果大声读起来不顺,就改成用户日常会说的话。 12. **红旗扫描**:最终内容里出现这些信号时必须重写或删除:`我们决定`、`应该展示`、`官网优先`、`这个设计`、`本轮`、`核心判断`、`第一现场`、`不是只展示`、`不抢权重`、`方法论`、`取舍`、`分类依据`、`内部`、`方案`、`原则`。 13. **翻译腔扫描**:中文最终稿里出现这些模式时必须重写:`能力进入流程`、`能力在背后连接`、`任务优先的界面`、`持续看见上下文`、`工作流里发现能力`、连续堆叠 `能力 / 流程 / 入口 / 上下文 / 场景 / 体系` 等抽象词。 14. **视角转换**:把“我们为什么这样做”改成“用户现在可以怎样完成事”。如果一句话只能说明生产过程,移回内部文档。 15. **最终自检**:发布前至少读一遍成品,不看设计文档也能成立;读者不需要知道团队内部争论,也能理解产品价值。 ## 可用句式 - 用户可以在 `<界面/入口>` 中 `<动作>`,并 `<结果>`。 - 当 `<场景>` 发生时,NextClaw 会 `<可观察行为>`。 - 目前支持 `<能力范围>`;`<限制>` 仍需用户确认或配置。 - 从 `<起点>` 到 `<结果>`,中间的 `<上下文/工具/材料>` 会保留在同一个工作流里。 ## 常见改写 - 内部话:`主界面才是产品的第一现场。` 对外话:`在主界面里开始任务、查看上下文,并继续后续操作。` - 内部话:`官网优先展示真正发生工作的地方。` 对外话:`你可以在一个工作台里使用会话、技能、浏览器和材料。` - 内部话:`Provider 不抢主界面的表达权重。` 对外话:`模型、渠道和工具连接在背后,工作时仍回到同一个界面。` ## 收尾要求 - 对外内容不得混入内部讨论过程。 - 对外截图必须和内容表达互相支撑;如果截图是空态、弱状态或与文案无关,先换真实素材或调整展示位置。 - 内部方案文档可以保留原则和取舍,但必须和最终呈现分开。 - 如果发现当前成品已经混入内部话,先修成品,再判断是否需要更新本 skill 或上游内容 skill。