停止過度分享 是做什麼的?
建構者(Builder)的提示是私有上下文,絕非客戶文案。客戶介面應讀起來像由人類產品團隊所撰寫:零內部資訊洩漏、零填充副標題、以及零 AI 文案寫作痕跡。
適用範圍
- 嚴格適用: UI 元件、登陸頁面、定價、入門引導、設定、表單、對話框、空狀態、Toast 提示、載入狀態、錯誤訊息、商店列表、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、向量資料庫、模型名稱)、主機成本動機、金鑰儲存、套件或商店 ID(以文字形式)、簽署藉口。 - 轉譯: 將建構者上下文改寫為冷靜的客戶用語:
| 內部上下文 | 絕不寫 | 改寫為 |
|---|---|---|
| 應用或擴充功能正在審查 | In App Store review、Pending approval | Coming soon (僅限 roadmap 徽章) |
| 離線或瀏覽器儲存 | 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 個按鈕 | 零資料庫、表格或查詢名詞 |
| Toast 提示 | 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 文案痕跡:
- 不要 "Not X, just 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 文案中不要使用 em 破折號(
—)或間隔--: 使用句號、逗號或冒號,或直接刪除第二個子句。 - 不要常見 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。 - 不要裝飾性格式: 標題、卡片標籤與按鈕使用 句首大寫(專有名詞與方案名稱才保留 Title Case)。功能列表或標題中絕不使用表情符號作為項目符號(
🚀、✨、⚡、🔒、💡、🎉)。功能列表中不要重複使用**粗體標籤:** 說明格式。 - 不要聊天機器人或假裝活潑的微文案: 刪除套用模式的開場白("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、斷句的 3 字標語、表情符號功能項目符號、括號內的 em 破折號、"Oops! Something went wrong"、"You're all set!"。