エンジニア向け 仕様全体の筋を通す

仕様全体を、 食い違わせない。

READMEなら簡単です。1章の要件が3章のデータモデルに耐えないといけない設計文書となると、話は変わります。Slimaが構成を支え、Markdownの面倒を引き受け、どのセクションも読んでいます。

app.slima.ai · ライティングスタジオ
📐 決済基盤RFC v2 · 8セクション
概要
アーキテクチャ
APIリファレンス
変更履歴
進行中のRFC3件をひもづけ
+ セクションを追加
アーキテクチャ · 約6分✓ 保存済みMarkdown ⇄ 書き出し

サービス構成

決済サービスは台帳を持ち、書き込み経路をひとつだけ公開する。読み取りはレプリカから返すため、強い一貫性が必要な呼び出し側は、明示的に書き込み経路を通す。

状態遷移はすべて冪等である。同じキーを持つ重複リクエストには元の結果を返し、 利用者に二重請求はしない。

タイムアウトはバックオフ付きで再試行し、上限は2回。それを超えたリクエストはデッドレターキューに退避し、人が確認する。

✓ 保存済み · v48セクション中2つめ読了目安6分
AI コーチ
仕様全体を読みました
ここの再試行の上限は、§1のSLAと合っていますか
少しずれています。§1では可用性99.9%を約束していますが、再試行が2回までだと、遅い依存先が出たときの余裕がありません。上限を上げるか、数字のほうを緩めてください。↳ §1「概要」より
整合性チェック未解決の論点
Markdownそのまま
素のテキストで書いて · きれいに書き出す
🗂️ 文書ツリー
8セクション · RFC3件をひもづけ
📤 書き出し
Markdown、PDF、Wordをすぐに
✦ AI コーチ
仕様全体を読んでいます…
出荷するのと同じくらい書いているエンジニアへ
バックエンドチームプラットフォームエンジニアテックリードOSSメンテナー
技術文書のために

最初の下書きから、 レビューを通る仕様まで。

文書の実際のかたちのまま構成を組めます。Markdownはそのまま扱え、用語や参照はセクションをまたいで追いかけられます。MCPに対応しているので、ふだん使っているAIクライアントから原稿を読み書きすることもできます。

ひとつの作業場

組む、書く、レビュー、 出す。

どの段階も、エンジニアが書き物で本当に詰まる場所に手を当てています。AI コーチは4つの段階すべてに付いてきます。

🗺️

崩れない構成

散文を1行も書く前に、概要から付録まで、文書のかたちのまま骨組みを組めます。

🗂️

一緒に動く構造

セクションを並べ替えると、見出しもリンクも参照も一緒に動きます。間違った場所を指したまま残るものはありません。

✍️

素のMarkdownで書く

見出し、コードブロック、表、注記。打っているそばからAI コーチが全部読んでいます。

📤

どこへでも出せる

そのレビューが求める形にワンクリックで書き出し。Markdown、PDF、Word。

文書ツリー

散文より先に、 構造を決める。

ツリーの中でセクションを動かすと、見出しも参照も一緒に移ります。色の帯がどのセクションがどの筋を運んでいるかを示すので、§9のリンクは変わらず解決しますし、気づかないうちにずれるものもありません。

  • ツリーと構成の表示、そしてつながっている箇所のための関係マップ
  • 作った初日からあるジャンルの骨組みと、形が変わったときのビートボード
文書ツリー
ドラッグで並べ替え · リンクも追随します
概要 · §1
目標と非目標
アーキテクチャ · §2
サービス境界
API · §4
エンドポイントとスキーマ
Markdownそのまま

ひとつの原本から、 すべての形式へ。

素のMarkdownで書いて、描画された文書をワンクリックで確認できます。見出しもコードブロックも表も、そのまま整います。レビューが求める版を書き出せて、同期し続ける二つめのファイルは要りません。

  • コードブロック、表、注記は最初から使えます
  • 見出しは構成と常に同期します
決済基盤RFC
Markdownプレビュー
1ファイル、きれいな書き出し
## 認証

すべてのリクエストは署名付きのベアラートークンを持つ。トークンは15分で失効し、背後で静かに更新される。

### トークンの発行

クライアント資格情報をPOST /v2/tokensに送ると、アクセストークンとリフレッシュトークンが返る。

仕様を読んだAI コーチ

あなたの仕様も、 どのセクションも知っています。

どの文書からでも聞けます。AI コーチはセクション、要件、用語集をプロジェクト全体で覚えているので、指摘はあなたの仕様の中から出てきます。よそから借りてきた文章作法ではありません。

  • プロジェクト内のどのファイルにも付いてきます
  • 中身が空のままのセクションを教えます
AI コーチ
仕様、全セクション、全文書を読みます
あなた
§1の要件のうち、実装メモがまだ無いのはどれですか
コーチ
冪等性です。§1でexactly-onceを約束していますが、キーをどこに保存していつ失効させるかは、どのセクションにも書かれていません。§3のデータモデルが置き場所として自然です。
↳ §1「要件」より
残りは、静かに片づけておきます

いつでも レビューに出せる。

レビュアーが当然あると思っていることは、プルリクエストを開く前に片づいています。

📤

どこへでも書き出す

Markdown、PDF、Wordをワンクリックで。手元のMarkdownの読み込みもできます。社内の設計文書も、技術書典に出す本の原稿も、同じ1本から。

🧵

文書をまたいだ整合性

用語も参照も追いかけているので、§4のAPIは§1の約束と食い違いません。

👥

用語集と参照

どの用語がどこで定義されているかを、本1冊ぶん通して突き合わせます。9章の意味が、2章で決めたままでいられます。

🏛️

白紙から始めなくていい

新しい本はジャンルの骨組みから始まり、ビートボードが各節をカードとして並べます。カードは、その節になるファイルそのものを持っています。さらにSlima MCPがあるので、すでに使っているアシスタントがこの本を直接読み書きできます。

📄

そのまま渡せる体裁

見出しの粒度、通し番号、レビュアーが探すタイトルブロックまで揃います。

🕓

バージョン管理

どの版にも戻せます。コードで信頼しているのと同じ考え方です。

“在用 Slima 之前,我用 Notion 寫長篇小說,被自己的架構連到昏頭;用了之後可以直覺的找到相關素材紀錄,專注寫作模式和每日追蹤字數的功能,也讓我可以更流暢的寫完當天想要抵達的進度。”
羅罧 Rozhen
奇幻科幻小說作者

文書を書く。 書いたあとも正しいままにする。

無料ではじめて、最初の文書を開いてください。AI コーチは7日間無料で試せます。