# 店舗資料とSkill

接客が読む店舗資料を編集し、画像やZIPを含めて下書きへ保存します。

Web: /help/ja/store-skills
Markdown: /help/content/ja/store-skills.md

## 店舗資料とPluginの違い [#店舗資料とpluginの違い]

店舗資料のSkillは、料理の食べ方や店舗の案内など、接客が必要なときに読む知識です。Agent Pluginに同梱される店舗設定用skillとは別です。店舗資料へスクリプトやtool名を書いても実行権限は増えません。接客が参照するのは公開した版です。

## 管理画面で編集する [#管理画面で編集する]

接客設定の資料ツリーからファイルを選び、プレビュー・原文・グラフィカル編集を切り替えます。見出し、リスト、コード、表、画像、リンクを編集できます。`SKILL.md`の名前・説明などのメタデータは本文と分けて編集します。

保存前に画像とコードブロックを含む内容を確認します。ファイルを改名したら、そのファイルへのリンクも修正してください。画像には出所と代替テキストを付け、生成画像を写真として扱いません。画像は公開配信されるため、秘密情報や会員の個人情報を載せないでください。

## 資料をまとめる [#資料をまとめる]

各Skillに`SKILL.md`を置き、先頭のYAMLへフォルダーと同じ名前と説明を記載します。入口は短くし、詳しい説明は相対リンクで参照するファイルへ分けられます。

```text
local-sake/
  SKILL.md
  references/serving.md
  assets/bottle.webp
```

```markdown
---
name: local-sake
description: 店舗の地酒の飲み方と提供温度を案内するときに読む。
---

確認済みの提供方法は[提供案内](references/serving.md)を参照する。
```

資料は最大8 Skill、各30ファイル、1ファイル32,000文字、全体256,000文字です。文字数はUTF-16単位で数えます。原材料や価格は確認した情報だけを使い、顧客の記憶や認証情報を店舗資料へ転記しません。

## ZIPで持ち運ぶ [#zipで持ち運ぶ]

5MiBまでのZIPを取り込めます。1つのSkillならルートに`SKILL.md`、複数なら上のようなSkill別フォルダーを置きます。同じIDの資料を置き換える場合だけ置換を選びます。画像の出所を確認できない場合は補ってください。TableCastの書出ZIPには画像の出所と代替テキストも含まれます。

管理画面で取り込んだ後は下書き保存が必要です。Skill検査で必須ファイル、名前・説明、参照切れを確認し、エラーを直してから[公開前の検証](/help/content/ja/configuration.md)へ進みます。検査の成功は資料の内容が事実であることを保証しません。

## agentに任せる [#agentに任せる]

> この料理説明と写真を店舗資料へ整理して。既存の資料を保ち、長い説明は参照ファイルへ分けて。画像の出所、参照切れ、保存した下書きを確認して。公開はまだしないで。

agentは`list_store_skills`で一覧を読み、`read_store_skill_file`で必要な本文を取得します。編集は`edit_store_skill`、ZIPは`import_store_skills`・`export_store_skills`、検査は`lint_store_skills`を使います。各変更の返却版を次の`expectedVersion`へ渡します。書出結果のリンクを受け取るだけではZIPの取得完了になりません。クライアントが取得できない場合は管理画面の書出を使います。

関連：[設定と公開](/help/content/ja/configuration.md)、[困ったとき](/help/content/ja/troubleshooting.md)、[目次](/help/content/ja/index.md)。
