停止过度分享 是做什么的?
构建者提示是私有上下文,绝不是客户文案。客户界面应读起来像是由人类产品团队所写:零内部泄露、零填充性副标题、零 AI 文案写作痕迹。
表面范围
- 严格适用: UI 组件、落地页、定价、用户引导、设置、表单、模态框、空状态、提示条、加载器、错误消息、商店列表、SEO 元数据。
- 平静且基于事实:
/privacy、/terms、/security、llms.txt、SDK 文档、更新日志(允许平实的纯技术事实;禁止炒作、元叙事如“added to replace”、以及 AI 套话)。 - 豁免: 代码注释、提交消息、拉取请求、内部文档、管理员视图。
1. 受众门控
在编写 UI 文案前,对提示中的每个事实进行分类:
- 丢弃(UI 中 0 个字): 审核队列(
in review、TestFlight、pending approval)、KYC 或 DNS 阻塞、存储和数据库管道(localStorage、IndexedDB、SQLite、Redis、向量数据库、模型名称)、托管成本动机、密钥存储、包或商店标识符在文案中出现、签名说明。 - 翻译: 将构建者上下文重写为平静的客户语言:
| 内部上下文 | 绝不要写 | 改为写 |
|---|---|---|
| 应用或扩展正在审核 | In App Store review、Pending approval | Coming soon (仅限路线图徽章) |
| 离线或浏览器存储 | Stored in IndexedDB、No backend | 0 个字 (或在主页中写 Works offline) |
| AI 搜索和回退 LLM | Querying Pinecone vectors via Haiku fallback... | Ask your docs / Searching... |
| 计费或 SSO 阻塞 | Stripe KYC pending、SAML blocked | 写明已上线路径(Subscribe in app) |
| 未签名的桌面构建 | Notarization pending; right-click Open | Direct download · macOS and Windows |
| 加密管道 | Military-grade encryption outside DB | Encrypted sync (在 /privacy 上详细说明) |
| 应用或包标识符 | com.acme.app、id1234567890 | 从文案中省略;仅提供商店徽章链接 |
- 保留: 当前可用的功能及下一步操作。参见 references/translations.md 和 references/leak-patterns.md。
2. 密度契约与重复标题规则
删除重复其标题或标签的帮助文本(Notifications -> “Configure how you receive notifications”)。切勿叙述可见布局(“The table below compares...”、“Use the form below to...”)。切勿填充稀疏的卡片。
| 插槽 | 字数上限 | 规则 |
|---|---|---|
| 主页副标题 | 1 句话,<= 18 个字 | 成果和支持的平台 |
| 状态徽章 | 1 到 3 个字 | 默认已上线;仅徽章 Coming soon |
| 计划列表项 | <= 6 个字 | 仅已上线功能 |
| 卡片副标题 | <= 10 个字 (或为 0) | 当标题和按钮已足够时省略 |
| 设置或表单帮助文本 | 默认 0 个字 | 仅对非明显格式 <= 10 个字 |
| 空状态 | <= 6 个字 + 1 个按钮 | 零数据库、表格或查询名词 |
| 提示条 | 1 到 4 个字,无 ! | Saved、Copied、Invite sent |
| 加载状态 | 1 到 3 个字 | Searching...、Generating... |
| 错误 | 失败内容 + 下一步操作 | 零 HTTP 状态码、路由或速率窗口 |
3. 反偏执规则
切勿主动发表未经要求的否认声明(“Never leaves your computer”、“Zero servers”、“100% local”、“Military-grade”)。在 /privacy 上平静地披露数据处理方式。
4. 人类语气
在内部泄露之外,同时清除合成 AI 文案写作痕迹:
- 不使用“不只是 X,而是 Y”对比: 删掉否定式设定(“Not just a note app, it's...”、“Built for speed, not bloat”、“No fluff, just...”)。直接陈述产品功能。
- 不使用强制排比或断续口号: 删掉三拍片段(“Fast. Simple. Powerful.”、“Plan. Track. Ship.”)。将三连词(“design, collaborate, and scale”)替换为一项具体功能或数字。
- UI 文案中不使用破折号(
—)或空格--: 使用句号、逗号或冒号,或删掉第二个从句。 - 不使用标准 AI 流行语或
-ing结尾: 禁止seamless、seamlessly、effortless、effortlessly、supercharge、unleash、elevate、empower、streamline、cutting-edge、next-generation、game-changing、robust、tailored、delve、tapestry、pivotal、reimagining、crafted for modern teams,以及附加的现在分词短语(“...ensuring effortless sync”)。优先使用简单的动词(is、has、syncs、exports),而不是serves as或boasts。 - 不使用装饰性格式: 以句子大小写书写标题、卡片标签和按钮(仅对专有名词和计划名称保留首字母大写)。绝不在功能列表或标题上使用表情符号项目符号(
🚀、✨、⚡、🔒、💡、🎉)。绝不在功能列表中重复**Bold Label:** explanation模式。 - 不使用聊天机器人或虚假高兴的微文案: 删掉套话开场白(“Let's dive in”、“Here's what you need to know”)、夸张的赞美(“You're all set!”、“Awesome!”)、虚假道歉(“Oops! Something went wrong”),以及常规 UI 状态中的感叹号。
5. 审计模式与红旗标志
使用 python3 scripts/audit.py src/ app/ 扫描源文件树,然后基于具体事实重写被标记的文案,而不是用同义词替换单词。参见 references/examples.md。
需要立即重写的红旗标志:in review、pending approval、localStorage、local storage、IndexedDB、no backend、vector embeddings、fallback model、rate limit、KYC、notarization、never leaves your、military-grade、文案中的包 ID、重复的设置副标题、“has been successfully saved”、seamless、effortless、supercharge、unleash、not just a、断续的三个字口号、表情符号功能项目符号、括号中的破折号、“Oops! Something went wrong”、“You're all set!”。