ガイドとライティングスキル

ひとことで：Slimaが自分のルールをあなたのAIツールに渡す仕組みです。「ここで何ができるのか」に答えるツール、Slima自身の操作ガイド、そしてライティングスキル。

これで解決すること

あなたのAIツールは、Slimaの作法を知らないままやってきます。ファイルが原稿なのか参考資料なのかで文字数に入るかどうかが決まることも、.mapは丸ごと書き直せないことも、書き込みが毎回コミットになることも知りません。

ぶつかりながら覚えることもできます。間違った書き方を1回、拒否を1回、そしてもう一度。あるいは、聞けばいい。このツール群が、その「聞く」です。

ツール	返すもの
get_capabilities	このサーバーがいま何に対応しているか。どの拡張子に書けるか、内容の種別はどう決まるか、どんなツールがあるか、ガイドの目次
list_guides	ガイドの目次。それぞれの名前と「いつ読み込むか」
load_guide	ガイドを1つ、全文
list_writing_skills	ライティングスキルの目次
load_writing_skill	ライティングスキルを1つ、全文

最初にget_capabilitiesを呼ぶ

SlimaのMCPサーバーは、接続が開いた瞬間にAIへこう伝えます。最初にやることはget_capabilitiesを呼ぶこと。 返ってくるフィールドはどれも、サーバーが実際に守っている取り決めから導かれています。だから、書かれた説明のように実際のふるまいとずれることがありません。

返ってくるのは4つのかたまりです。

• 拡張子ごとの方針と、その方針が言葉で何を意味するか（丸ごと書ける／フィールド単位のツールだけ／まったく書けない）
• 内容の種別：どんな値があるか、そして指定しなかった新しいファイルの種別がどう決まるか（入っているフォルダから受け継ぎ、いちばん外側なら参考資料）
• ツールの一覧
• ガイドの目次

get_capabilitiesは、このサーバーが公開しているツールをすべて並べます。 だから、クライアント側のツール説明とサーバーの言うことが食い違ったときは、こちらが決め手になります。

そこに、黙っていると必ず誰かが時間を失う事実がいくつか付いてきます。書き込みは毎回コミットで、保存という段はないこと。文字数と連続記録とBeta Readerに効くのは原稿だけだということ。作者が同じファイルを編集しているかもしれないので、丸ごとの上書きよりedit_fileのほうが安全なこと。ファイルはパスで指すこと、トークンは作者の端末をまたいで安定した身元ではないこと。

どんなガイドがあるか

ガイドが教えるのはSlimaの操作です。全部を先に読み込むのではなく、これからやることのぶんだけ読み込みます。

ガイド	いつ読み込むか
getting-started	Slimaの作品に初めて触れるとき。これが地図で、次に読むものを指してくれます
book-structure	ファイルを作る前。原稿と参考資料の違い、そして作者の書いた字を作者自身の文字数から消してしまわない方法
version-control-basics	大きく書き直す前。書き込みがどうコミットになるか、読んでいるあいだに作者が書いたものをどう潰さずに済むか
notes-and-foreshadowing	メモを残すとき、伏線の仕込みと回収を追うとき
comments-review-loop	編集のやり取りに入るとき。コメントを残す、自分あてのコメントに答える、そして何が作者の決めることとして残るか
beta-reader	Beta Readerのレポートを頼む前。どれくらいかかるか、何を使うか、結果をどう受け取るか
team-knowledge-base	出版社や制作チームの中で作業するとき。共有されているのは何か、自分には見えないものは何か
script-studio	古い脚本スタジオの作品に当たったとき。何が構造化されていて、何なら書けるか
format-beats	.beatsを触る前
format-timeline	.timelineを触る前
format-script	.scriptを触る前
format-relationship-map	.mapを触る前
format-geomap	.geomapを触る前

load_guideに存在しないslugを渡しても、返ってくるのは素っ気ない「見つかりません」ではありません。本物の一覧が一緒に返ってくるので、1回外しても次で当たります。

format-*のガイドは早めに読み込む価値があります。こちらが扱うのはその型そのものの決まり（どのフィールドが内容でどれがレイアウトか、1つ消すと何が一緒に消えるか）で、構造化編集ツールが扱うのはツールの呼び方です。

どんなライティングスキルがあるか

ライティングスキルは書く仕事の手順であって、Slimaの操作ではありません。アプリの中のAI コーチがたどるのと同じ手順です。

スキル	何をするか
character_develop	すでにいる人物を深める：弧、声、関係、成長
character_create	新しい人物を、作者と一緒にゼロから立ち上げる
plot_architect	構成・あらすじ・物語の弧を設計する、あるいは検討する
scene_craft	1つの場面を磨く：テンポ、感覚の細部、緊張、つなぎ
tension_map	章をまたいだ、あるいは作品全体の緊張の曲線を分析する
voice_polish	この作品の声と文体を見つけて強める
dialogue_coach	台詞を話し言葉らしくし、人物ごとの声を描き分ける
consistency_audit	時間、場所、人物、論理の矛盾を体系的に調べる
world_build	世界観の仕組みを設計・検討する：魔法、文化、政治、経済
opening_hook	冒頭を検討して直す

一行で分けるなら、書くことについての用ならスキル、Slimaの操作についての用ならガイドです。

なぜこれらをパッケージに同梱しないのか

バージョンを固定しているのはあなただからです。ガイドをクライアントの中に書き込んでしまうと、固定したバージョンのまま過去に止まり、しかもサーバーがもう対応していないことを、同じ自信のある口ぶりで教え続けます。

Slimaの側から配れば、Slimaがデプロイした瞬間に全部が新しくなります。あなたがどのバージョンを走らせていても、です。

もう1つ、おまけがあります。ガイドの中の型に関わる部分は、アプリの中のAI コーチが読んでいるのと同じ文章です。1つの文章を2人が読む。外のAIと中のAIが、同じファイルについて別々のルールを教えはじめないのは、そのためです。

実際の使い方

会話の最初に伝えておくほうが、あとで直すより安上がりです。

Slimaにつないだら、まずget_capabilitiesを呼んでください。
次にbook-structureガイドを読み込んでください。
年表やビートボードを触る前に、対応するformat-*ガイドを読み込んでください。

関連

• Docs：構造化編集ツール
• Docs：スキーマのリソースを問い合わせる
• Docs：MCPがファイル種別ごとにできること
• Docs：Slima MCPとは