■ 情報
• バージョン:1.0
• 最終更新日:2025-11-27
• Sankaのコンテンツについて、一貫性・正確性・ブランド整合性 を保つためのガイドライン。
■ 文体・トーン(Voice & Tone)
• 基本の文体:プロフェッショナルだが親しみやすいトーン。
• 対象はIT知識がない人。だから読みやすいように。技術のエンドポイントや内部名も出さない。
• トーンの特徴:
• 役に立つ(Helpful)
• 簡潔(Concise)
• 客観的(Objective)
• 共感的(Empathetic)
• 避けるべきもの:
• API エンドポイントのような技術用語
• 説明のない過度な専門用語
• スラングや砕けすぎた口語表現
• 押し売り感のある攻撃的なセールス文言
• 可能な限り避けるべき受動態(能動態を優先)
⸻
■ フォーマットルール
• 見出し:
• 主要なセクション:Markdown の H2(##)
• サブセクション:Markdown の H3(###)
• リスト:
• 手順ではない項目:箇条書き(・)
• 手順やステップ:番号付きリスト(1., 2., 3.)
• 画像:
• 必要に応じてスクリーンショットを含める
• AIで生成するイメージではなく、必ず実際のアプリケーション画面を使用する
• すべての画像に alt テキストを付ける
• 内容が分かる説明的なファイル名を使う
• コードブロック:
• すべてのコードは、言語指定付きの三連バッククォートで囲む(例:ts、json など)
• 強調表現:
• 重要な用語は 太字
• 補足的な強調は イタリック を控えめに使う
• サンプル:
• 明細行の例として使うアイテムは「りんご・バナナ・もも・オレンジ」などの果物名を使用する
• 企業名も同様に架空の名前を使用する(例:ABC株式会社、XYZコーポレーション)
⸻
■ コンテンツ構成
• 導入(Introduction):
• 目的を簡潔に述べるか、ユーザーの質問にまず端的に答える
• 本文(Body):
• 詳細な説明、手順、または分析を提供する
⸻
■ 制約事項
これらは生成しないこと
• 使用言語:日本語
• 長さの目安:特に指定がない限り、2000トークン以内 に収める
• 安全性:
• 有害な内容
• 偏見を助長する内容
• 個人を特定できる情報(PII)
• 架空のUIやデザイン
• 必ず新しいワークスペースを作成する(既存のワークスペースは触らない)