microcopy について
microcopyは、LobeHubのUI文言を作成する人向けのライティングガイドラインです。用語やトーン、状態別の表現例を示し、次の操作が明確な文面を促します。
主な機能
- 01固定された製品用語
- 02明確さを優先する執筆ルール
- 03重要な場面のトーン指針
- 04待機・エラー・コラボレーションの文例
- 05エラーメッセージの必須情報
活用シーン
- 01オンボーディングや空状態の文言作成
- 02長時間タスクの通知文作成
- 03障害と次の操作の説明
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ lobehub/ lobehub --skill microcopyインストール後、Claude Code で/microcopyを入力して読み込まれたか確認します。
同梱ファイルreferences/en.mdreferences/zh.md
詳細
LobeHub UI マイクロコピーガイドライン
このファイルはクイックリファレンスの要約です。豊富な例(アンチパターン、トーンのマトリックス、シナリオ別の解説)を含む、プロンプト形式の詳細なガイドラインについては、言語別のリファレンスを参照してください。
- 中国語の文案 —
references/zh.md - 英語のコピー —
references/en.md
ブランド:エージェントが協働する場所 — 「生成」だけでなく、エージェントの協働システムに焦点を当てます。
固定用語
| 中国語 | 英語 |
|---|---|
| 空間 | Workspace |
| 助理 | Agent |
| 群組 | Group |
| 上下文 | Context |
| 记忆 | Memory |
| 连接器 | Integration |
| 技能 | Skill |
| 助理档案 | Agent Profile |
| 话题 | Topic |
| 文稿 | Page |
| 社区 | Community |
| 资源 | Resource |
| 库 | Library |
| 模型服务商 | Provider |
| 评测 | Evaluation |
| 基准 | Benchmark |
| 数据集 | Dataset |
| 用例 | Test Case |
ブランドの原則
- 作成:一文から、すぐに使える Agent を作成し、明確な次のステップを示します
- 協働:複数のエージェント、共有 Context、制御可能な環境
- 進化:同意を得て記憶し、説明可能で、再現可能にします
執筆ルール
- 明確さを最優先:短い文、力強い動詞、形容詞は最小限にします
- 階層化:メインの文言(シンプル)+任意の詳細(正確)
- 動詞を統一:作成/接続/実行/一時停止/再試行/詳細を表示
- 次の行動を示す:すべてのメッセージで次のステップを伝え、汎用的な「OK/キャンセル」は避けます
人間味のある温かさ(バランス重視)
基本:情報80%、温かさ20% 重要な場面:70/30(初回利用、空の状態、失敗、長時間の待機)
上限:温かさを表す言葉は文の半分までとし、その後に明確な次のステップを示します。
順序:
- 状況を受け止めます(評価はしません)
- 操作の主導権を取り戻せるようにします(一時停止/再生/編集/元に戻す/Memory を消去)
- 次の行動を提示します
避けること:説教じみた励まし、大げさな物語、過度な擬人化
パターン
利用開始時:
- 「まずは一文からで十分です。目標を説明してください。」
- 「何から始めればよいかわからない場合は、実現したい結果を教えてください。」
長時間の待機:
- 「実行中です……別のタスクに切り替えても大丈夫です。完了したらお知らせします。」
- 「数分かかる場合があります。短縮するには、Context を減らすか、モデルを切り替えてください。」
失敗時:
- 「実行できませんでした。再試行するか、詳細を表示して原因を解決してください。」
- 「接続に失敗しました。設定で再認証するか、後でもう一度お試しください。」
協働:
- 「全員の Context を揃えましょう。」
- 「意見が異なっても問題ありません。まず目標を書きましょう。」
エラー/例外
次の内容を含める必要があります。
- 何が起きたか
- (任意)その理由
- ユーザーが次にできること
次の操作を提示します:再試行/詳細を表示/設定に移動/サポートに問い合わせる/ログをコピー
ユーザーを責めないでください。エラーコードは「詳細」に記載します。
コメント
Markdown 対応