Skip to content
所有文章 ‹ Part 08 of 08 · AI 時代,文件怎麼活下來:大道至簡
工程 · 1 min read

總結:把這些帶回你的團隊

「AI 時代,文件怎麼活下來」系列總結:每篇一句話、串起整個系列的黃金圈,以及六個帶回團隊討論的問題。

系列到這裡結束。這一篇整理你可以帶回團隊的東西:每篇一句話、串起它們的想法,以及可以直接開始討論的問題。

七篇,七句話

  1. 寫給誰:只寫讀者查不到的:AI agent 也是讀者。只寫讀者不容易查到的東西。
  2. 文件怎麼過期的:寫得輕鬆的文件照樣會過期。每份文件都要設計成容易改。
  3. 先找痛點再選工具:文件過期有機器、流程、人三種原因,AI 只解得了機器那一種。
  4. 嚴格規則只給機器能檢查的:工具檢查得了的才當嚴格規則,其他都是習慣。
  5. 好名字就是不用寫的文件:命名和小符號,本身就是文件。
  6. 記住去哪找,不是記內容:記住去哪裡找,不用記住內容。
  7. 讓文件活著:三個提醒,加上單向流動的變更。

黃金圈

七篇放在一起,就是一個黃金圈。

WHAT HOW WHY
從中心往外讀:先為什麼,再怎麼做,最後做什麼。
  • WHY:文件只有被對的人讀到、用到,才有價值。
  • HOW:大道至簡:規則少、連結直接、要記的少。
  • WHAT:一套解決真正痛點、全隊認同並落地的文件做法。

帶回你團隊的問題

我沒有給答案,因為每個團隊的痛點不同。這些問題可以直接拿去討論:

  1. 一份文件寫給所有讀者,還是每種讀者各一份?(第 01 篇)
  2. 每份文件必須有哪些欄位?(第 04 篇)
  3. 文件標題和 ID 怎麼命名?(第 05 篇)
  4. 用 tag 清單、只標文件類型,還是不用 tag?(第 06 篇)
  5. 一份錯的文件,多快必須修好?(第 03 篇)
  6. 程式碼變更的提醒,必須帶哪些資訊?(第 07 篇)

建議的第一步:一個 owner、一個產品資料夾、一個月。然後一起檢討什麼有用。

你不需要「最好」的工具。 你需要的是一套適合自己、夠有彈性、能跟著需求一起改的工具與流程。 前提是先知道我們真正的痛點,才不會陷入 AI 的資訊焦慮,迷失方向。

參考來源


延伸閱讀: 回到系列總覽:AI 時代,文件怎麼活下來,或從第 01 篇重新讀一遍。

↑↓ 移動 ↵ 開啟 esc 關閉