指南與寫作技能

最後更新 2026 年 9 月 9 日 · 閱讀約 7 分鐘

一句話：這篇說明 Slima 怎麼把自己的規範餵給你的 AI 工具——一組用來「問」的工具、Slima 自己的操作指南，以及寫作技能。

這解決什麼問題

你的 AI 工具原本不知道 Slima 的規矩。它不知道一個檔案是稿件還是參考資料會決定字數要不要算進去，不知道 .map 不能整檔重寫，不知道每一次寫入都是一顆 commit。

它可以慢慢撞出來——用一次錯的寫法、拿一次拒絕、再試。也可以直接問。這一組工具就是拿來問的。

工具	回什麼
`get_capabilities`	這台伺服器現在支援什麼：哪些副檔名可寫、內容型別怎麼決定、有哪些工具、有哪些指南
`list_guides`	指南目錄：每一份的名稱與「什麼時候該載入」
`load_guide`	把一份指南完整載進來
`list_writing_skills`	寫作技能目錄
`load_writing_skill`	把一份寫作技能完整載進來

Slima 的 MCP 伺服器在連線一開始就會告訴 AI：第一件事是呼叫 get_capabilities。 它回的每一個欄位都是從伺服器實際執行的那份契約推導出來的，所以不會跟真實行為分岔。

裡面有四塊：

get_capabilities 列的是這台伺服器提供的每一支工具，所以 client 的工具說明跟伺服器對不上時，以它為準。

還附幾句「不講就會踩」的事：每次寫入都是一顆 commit、沒有存檔這一步；只有稿件會進字數與連勝；edit_file 比整檔覆寫安全，因為作者可能正在改同一個檔；檔案要用路徑指名，token 不是跨裝置穩定的身分。

這也是最省事的除錯方式。「AI 說它不能寫這種檔」的時候，先叫它跑一次 get_capabilities 把那張表念出來，比翻文件快。

指南教的是怎麼操作 Slima。要做那件事之前才載入那一份，不是全部載進來。

指南	什麼時候載
`getting-started`	第一次接一本 Slima 的書。它是地圖，會指你去下一份
`book-structure`	建檔案之前。稿件與參考資料的差別，以及怎麼不把作者的字從他自己的字數裡弄不見
`version-control-basics`	大改之前。寫入怎麼變成 commit、怎麼不蓋掉作者在你讀檔期間寫的東西
`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 不會只回「找不到」，它會把真實的清單一起回給你——所以猜錯一次就會走對。

那幾份 format-* 特別值得先載：它們講的是那個型別的規則本身（哪些欄位是內容、哪些是排版、刪掉一個東西會連帶什麼），而結構化編輯工具那篇講的是工具怎麼呼叫。

寫作技能是手藝的做法，不是 Slima 的操作方式。它們跟站內 AI 寫作教練照的是同一份步驟。

一句話分工：任務是關於「怎麼寫」就用寫作技能，關於「怎麼操作 Slima」就用指南。

因為套件的版本是你在釘的。指南寫在套件裡，就會跟著你釘住的那一版一起停在過去，而它會繼續用同樣的口氣教一件伺服器已經不支援的事。

從 Slima 這邊送出去的話，Slima 一部署就全部更新——不管你在跑哪一版 client。

還有一個附帶好處：那些指南裡跟型別有關的部分，跟站內 AI 寫作教練讀到的是同一份文字。兩邊讀同一份，才不會出現外部 AI 跟站內 AI 對同一個檔案講兩套規則的事。

在對話一開始就交代清楚，比事後糾正省事：

連上 Slima 之後先呼叫 get_capabilities。
接著載入 book-structure 指南。
要動年表或節拍看板之前，先載入對應的 format-* 指南。