> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/creating-content/styleguide.md).

# スタイルガイド

スタイルガイドは、チームの文章ルールと慣例をまとめた専用の場所です。サイト上のコンテンツをどのように書くべきかについての唯一の基準となるもので、トーン、用語、書式、構成を定めます。

スタイルガイドは 2 つの対象に役立ちます：

* **あなたのチーム** — 執筆者とレビュー担当者が、どのように書くべきかを共有できる参照先を 1 つ持てるため、誰が編集してもドキュメントの一貫性が保たれます。
* **GitBook Agent** — Agent はスタイルガイドを読み、コンテンツを生成または編集するたびに従うべき唯一の基準として扱います。Agent 独自の既定値と一般的な文章ルールを上書きします。

{% hint style="info" %}
**スタイルガイドは早期アクセス中です**

スタイルガイド機能は段階的に展開されています。サイト設定にまだ表示されない場合は、組織では有効になっていません。
{% endhint %}

### スタイルガイドを作成する

サイトの **設定** を開き、 **スタイルガイド** セクションを選択します。サイトにまだスタイルガイドがない場合は、いくつかの方法で作成できます：

{% tabs %}
{% tab title="空白" %}
空のスペースから始めて、ルールをゼロから書きます。
{% endtab %}

{% tab title="スターターテンプレート" %}
ボイスとトーン、執筆原則、書式、用語をすでにカバーしている組み込みテンプレートから始めます。各セクションをチーム向けに調整してください。これは固定されたルールブックではなく、出発点として扱ってください。
{% endtab %}

{% tab title="インポート" %}
既存のコンテンツ、たとえば別のツールで管理しているスタイルガイドを、新しいスタイルガイド用スペースにインポートします。
{% endtab %}
{% endtabs %}

スタイルガイドを初めて開くと、GitBook は、他のスペースと同じように編集することを説明する短い導入を表示します。

### スタイルガイドに記載する内容

スタイルガイドは、チーム内で間違えやすかったり、一貫性が崩れやすかったりする決定事項を記録しているときに最も役立ちます。一般的なセクションには次のようなものがあります：

* **ボイスとトーン** — 読者への呼びかけ方、どれだけフォーマルかフレンドリーか。
* **執筆原則** — 時制、能動態と受動態、文と段落の長さ。
* **書式** — 見出しの表記、リスト、ステッパー、ヒント、その他のブロックをいつ使うか。
* **用語** — 製品名や機能名、優先する用語、略語の扱い方。

{% hint style="warning" %}
**主要なルールは最初のページに置く**

GitBook Agent はスタイルガイドの **最初のページ全体** をすべてのタスクのコンテキストに読み込むため、そのページが常に作業の指針になります。ほかのページは、目次を使って必要なときだけ読み込みます。最も重要なルールは最初のページに置き、追加のページは、Agent が必要に応じて参照できる詳細情報に使ってください。
{% endhint %}

### スタイルガイドを編集する

スタイルガイドはスペースなので、ドキュメントの他の部分を編集するのと同じように編集します：

* **GitBook では** — 変更を [変更リクエスト](/docs/documentation/ja-gitbook-documentation/collaboration/change-requests.md)に加え、準備ができたらマージします。
* **Git Sync を使う場合** — スタイルガイドのスペースが [GitHub または GitLab に同期されている](/docs/documentation/ja-gitbook-documentation/getting-started/git-sync.md)場合は、リポジトリ内の Markdown として編集します。

スタイルガイドを開くには、サイトのサイドバーにある **スタイルガイド** エントリ、または **編集** アクションを **サイト設定 → スタイルガイド**.

### サイト間でスタイルガイドを共有する

スタイルガイドは組織に属するため、複数のサイトで同じものを利用できます。まだスタイルガイドがないサイト用に設定し、組織に既存のスタイルガイドがある場合は、次のことができます：

* **既存のスタイルガイドを使う** — そのまま関連付けて、同じものを使う他のサイトと共有します。編集内容は、そのスタイルガイドが使われているすべての場所に反映されます。
* **フォークする** — このサイト専用のコピーを作成します（名前は `スタイルガイド - {site name}`）独立して発展させることができます。

組織内のすべてのスタイルガイドと、それぞれを使用しているサイトを確認するには、組織のサイドバーにある **スタイルガイド** エントリを開きます。

### スタイルガイドの関連付けを解除する

サイトがそのスタイルガイドを使わないようにするには、 **サイト設定 → スタイルガイド** を開き、 **関連付けを解除**を選択します。関連付けを解除してもスタイルガイドのスペースは保持され、他のサイトで使われ続けることがあります。ほかに参照しているサイトがなければ、GitBook は完全削除を提案します。

### GitBook Agent がスタイルガイドを使う方法

GitBook Agent がサイト上でコンテンツを書いたり編集したりするたびに、そのサイトのスタイルガイドを読み込み、唯一の基準として従います。実際には：

* 変更リクエストの各タスクで、Agent はスタイルガイドの **最初のページ** と目次を最初に読み込み、その後、必要に応じて他のセクションを取り込みます。
* を使って、Agent にページをスタイルガイドと照合するよう直接依頼できます。 **スタイルガイドとの整合性を確認** を [改善メニュー](/docs/documentation/ja-gitbook-documentation/gitbook-agent/write-and-edit-with-ai.md#improve-page-content-with-gitbook-agent).

{% hint style="info" %}
スタイルガイドは、サイトレベルの [カスタム指示](/docs/documentation/ja-gitbook-documentation/gitbook-agent/what-is-gitbook-agent.md#add-a-style-guide-and-custom-instructions) として GitBook Agent に与えられるものを補完します。カスタム指示は短くてサイト固有の指示であり、スタイルガイドは文章ルールをまとめた完全な共有ドキュメントです。
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/creating-content/styleguide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.