工程師專用 讓整份規格前後對得起來

讓整份規格 前後一致。

寫一份 README 不難。但一份設計文件,第一段的需求得撐得住第三段的資料模型,那就是另一回事了。Slima 幫你撐住整份結構、處理好 Markdown,還會把每一段都讀進去。

app.slima.ai · 寫作工作室
📐 金流 RFC v2 · 8 個段落
總覽
架構
API 參考
更新紀錄
已連結 3 份進行中的 RFC
+ 新增段落
架構 · 約 6 分鐘✓ 已儲存Markdown ⇄ 匯出

服務架構

金流服務掌管帳本,對外只開一條寫入路徑。讀取一律走副本,所以任何需要強一致性的呼叫端,都得明確走寫入路徑。

每一次狀態轉換都具備冪等性。帶相同金鑰的重複請求,會回傳原本的結果,而不會 向客戶重複扣款。

逾時會以退避策略重試,最多兩次;超過後該請求就會被擱到死信佇列,等人工檢查。

✓ 已儲存 · v4第 2 段,共 8 段約 6 分鐘讀完
AI 教練
讀完整份規格
這裡的重試次數對得上 §1 的 SLA 嗎?
不太對。§1 承諾 99.9% 可用性,但重試上限只設兩次,一旦遇到反應慢的相依服務就完全沒有緩衝。把上限調高,或是把那個數字放寬一點。↳ 來自 §1 · 總覽
一致性檢查待釐清問題
原生 Markdown
純文字進 · 乾淨匯出
🗂️ 文件樹
8 個段落 · 連結 3 份 RFC
📤 匯出
Markdown、PDF、HTML 都備好
✦ AI 教練
正在讀整份規格…
寫得跟出貨一樣多的工程師都在用
後端團隊平台工程師技術主管開源專案維護者
為技術寫作而生

從初稿到 定案規格。

照文件真正的樣子去組織結構,Markdown 交給我們處理,每一處引用都跨段落自動追蹤。

一個工作空間

列大綱、起草、審閱、 出貨。

每個階段都對準工程師寫東西時真正卡關的地方,而且 AI 教練四個階段都跟著你。

🗺️

撐得住的大綱

在動筆寫任何一句之前,就先照文件的樣子把整份結構排好,從總覽到附錄。

🗂️

會跟著動的結構

重排段落,標題、連結、引用全部跟著走——不會留下任何指錯地方的連結。

✍️

用乾淨的 Markdown 寫

標題、程式碼區塊、表格、提示框,AI 教練在你打字的同時逐行讀過去。

📤

想出哪都能出

看這次審閱要什麼格式,一鍵匯出——Markdown、PDF,或可獨立開啟的 HTML。

文件樹

先把結構 排在文字前面。

在文件樹裡把段落拖來拖去,標題和引用都跟著一起搬。色條標出每個段落屬於哪條主線,所以 §9 那個連結照樣指得到,不會有東西悄悄就對不上了。

  • 樹狀、大綱、關係圖三種檢視
  • RFC、ADR,或你自訂的文件範本
文件樹
拖曳即可重排 · 連結自動同步
總覽 · §1
目標與非目標
架構 · §2
服務邊界
API · §4
端點與結構描述
原生 Markdown

一份來源, 每種格式。

用純 Markdown 寫,一鍵就能預覽渲染後的文件。標題、程式碼區塊、表格自己排好。審閱要哪個版本就匯出哪個,不用再另外養一份檔案來同步。

  • 內建程式碼區塊、表格、提示框
  • 標題與大綱始終同步
金流 RFC
Markdown預覽
一份檔案,乾淨匯出
## 身分驗證

每個請求都帶一組已簽章的 bearer token。Token 在 15 分鐘後過期,並於背景自動更新,使用者無感。

### 核發 token

以 client credentials 呼叫 POST /v2/tokens;回應會回傳一組 access token 與一組 refresh token。

讀過整份規格的 AI 教練

它懂你的規格 也懂每一個段落。

任何文件、任何問題都能問。AI 教練把你的段落、需求、術語表整個工作空間記在心裡,所以它給的建議都來自你的規格內部——而不是某份制式的寫作風格指南。

  • 跟著你跑遍工作空間裡的每一份文件
  • 幫你揪出還只是個空殼的段落
AI 教練
讀你的規格,每個段落、每份文件都讀
§1 裡哪一條需求還沒寫實作備註?
教練
冪等性。你在 §1 承諾 exactly-once,但沒有任何段落講金鑰怎麼儲存、怎麼過期。§3 的資料模型才是它該放的地方。
↳ 來自 §1 · 需求
其餘的事,默默幫你搞定

隨時 可以送審。

審閱者會期待的每一件事,在你開 pull request 之前就都處理好了。

📤

想匯出到哪都行

Markdown、PDF,以及可獨立開啟的 HTML,一鍵搞定。現有的 Markdown 也能匯入。

🧵

跨文件一致

每個術語、每處引用都被追蹤,所以 §4 的 API 永遠對得上 §1 的合約。

👥

術語表與引用

每個術語在哪定義、又有哪些文件靠它,一目了然。

🏛️

文件範本

RFC、ADR、設計文件,或你自訂的大綱,段落還空著時會輕輕提醒你一下。

📄

乾淨、好分享的成品

一致的標題、編號的段落,加上審閱者預期會看到的標題區塊。

🕓

版本紀錄

每個版本都救得回來——就是你寫程式時早已信任的那套版本控制。

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

把文件寫出來。 讓它一直站得住腳。

免費開始,打開你的第一份文件。AI 教練可免費試用七天。