> 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/kontentsuwosuru/styleguide.md).

# スタイルガイド

専用のスタイルガイドでチームの執筆ルールを定義し、GitBook Agent を含むすべての作成者の表現を一貫させましょう。

スタイルガイドには、チームの執筆ルールがまとめられています。つまり、文体とトーン、用語、書式、構成です。対象となる読者は 2 つあります：

* **チーム:** 執筆者とレビュアーが同じ参照資料を共有するため、誰が編集してもドキュメントの一貫性が保たれます。
* **GitBook Agent:** Agent はコンテンツの執筆、編集、レビューの際に、常にスタイルガイドに従います。独自のデフォルト設定よりも、あなたのルールが優先されます。

GitBook Agent は、番号付き ID があるルール、または明確で確認可能なルールを適用し、それ以外はガイダンスとして扱います。詳しくは、 [GitBook Agent によるスタイルガイドの適用方法](https://gitbook.com/docs/documentation/ja-gitbook-documentation/kontentsuwosuru/styleguide/how-gitbook-agent-enforces-your-style-guide.md).

## 始める

このサイトでスタイルガイドを設定するには、管理者権限が必要です。

{% stepper %}
{% step %}
**スタイルガイドを設定する**

クリックします **スタイルガイド** サイトのサイドバーで、次に **セットアップ**をクリックします。テンプレートを使う、組織ですでに使用しているスタイルガイドを再利用する、または独自のものをインポートすることができます。詳しくは、 [開始方法を選ぶ](https://gitbook.com/docs/documentation/ja-gitbook-documentation/kontentsuwosuru/styleguide/build-your-style-guide.md#choose-a-starting-point).
{% endstep %}

{% step %}
**テンプレートを記入する**

各セクションのうち、 **入力が必要**と表示されている項目（製品名、対象読者、単語リストなど）を埋め、適用したいルールすべてに ID を付けます。詳しくは、 [スタイルガイドを作成する](https://gitbook.com/docs/documentation/ja-gitbook-documentation/kontentsuwosuru/styleguide/build-your-style-guide.md).
{% endstep %}

{% step %}
**最初のチェックを実行する**

スタイルガイドを開き、 **チェック** タブに移動して、 **チェックを実行** をクリックすると、既存のコンテンツをレビューできます。次の変更リクエストでスタイルガイドのレビューを依頼することもできます。詳しくは、 [スタイルガイドに照らしてコンテンツをチェックする](https://gitbook.com/docs/documentation/ja-gitbook-documentation/kontentsuwosuru/styleguide/check-content-against-your-style-guide.md).
{% endstep %}
{% endstepper %}

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>スタイルガイドを作成する</strong></td><td>開始方法を選び、テンプレートに記入し、Agent が適用できるルールを作成します</td><td><a href="https://gitbook.com/docs/documentation/ja-gitbook-documentation/kontentsuwosuru/styleguide/build-your-style-guide.md">スタイルガイドを作成する</a></td></tr><tr><td><strong>コンテンツをスタイルガイドと照合する</strong></td><td>ページ、変更リクエスト、またはスペース全体をレビューする</td><td><a href="https://gitbook.com/docs/documentation/ja-gitbook-documentation/kontentsuwosuru/styleguide/check-content-against-your-style-guide.md">コンテンツをスタイルガイドと照合する</a></td></tr><tr><td><strong>GitBook Agent がスタイルガイドを適用する方法</strong></td><td>Agent が読み取り、フラグを立て、変更する内容</td><td><a href="https://gitbook.com/docs/documentation/ja-gitbook-documentation/kontentsuwosuru/styleguide/how-gitbook-agent-enforces-your-style-guide.md">GitBook Agent がスタイルガイドを適用する方法</a></td></tr></tbody></table>

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

クリックします **スタイルガイド** サイトのサイドバーで、スタイルガイドを開きます。他のドキュメントと同様に編集できます。変更リクエストで変更を加え、マージしてください。

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

スタイルガイドは組織に属するため、複数のサイトで同じものを使い、同じルールに従えます。

スタイルガイドを作成すると、GitBook はまだスタイルガイドを持っていない組織内の他のサイトにそれをリンクすることを提案します。サイトを設定するときに、既存のスタイルガイドを共有版またはフォーク版として選ぶこともできます。

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

### スタイルガイドの接続を解除する

サイトでスタイルガイドを使用しないようにするには、サイトのサイドバーで **スタイルガイド** の横にあるアクションメニューを開き、 **スタイルガイドを関連付け解除**をクリックします。関連付けを解除してもスタイルガイドは保持されます。他のサイトで引き続き使用されている可能性があるためです。使用しているサイトがほかにない場合は、GitBook によって完全に削除するかどうか確認されます。


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
