Skip to main content
■ 情報 • バージョン: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やデザイン • 必ず新しいワークスペースを作成する(既存のワークスペースは触らない)