前陣子，我做了一個可以用 AI 來自動化建立產品使用手冊的工具。因此，想趁這次鐵人賽，把這個「從 0 打造出 AI 自動化工具的經驗」分享給大家。

至於為什麼有這個需求，還請聽我娓娓道來...

總是過期的使用手冊

不知道大家有沒有遇過一種狀況：

公司的產品收到一個新需求，要加一個新功能。經過一段時間努力開發，並且測試沒問題之後，客戶表示需要這個功能的相關說明文件 (e.g. 使用手冊)。

儘管這個產品之前有寫過使用手冊，但是肯定還不會有這次新開發的功能，因此，需要找了解這個新功能的人 (或是直接找開發這個功能的人) 來幫忙撰寫。於是，只好再花時間去截圖、標註說明，並撰寫使用步驟。

甚至，有時候的版本更新牽涉到多個功能的截圖 (e.g. NavBar 多一個按鈕、Logo 更新)，導致需要更新的截圖數量大幅增加。

如果是比較不忙的時候，或是公司人力充足，花點時間處理一下倒也還好。但是，在功能快速迭代的時候，還要花時間、力氣去做這種瑣事就會讓人心累，最終導致使用手冊總是過時、不完整。

就跟測試一樣。

不出意外地 ，意外就發生了，我在公司也面臨著這樣的問題。

不只功能迭代快、種類多，而且還有多個語言，甚至有些場域還需要客製化調整部分功能。光是開發和維護就足夠煩惱了，實在沒有多少時間可以維護使用手冊。就算可以找別人來寫使用手冊，仍然需要先花點時間教一下新功能，他們才能幫忙寫。如果功能稍微複雜一點，甚至有可能一個不小心就漏了一些細節。

想要解決這個問題，就必須要有一個可以「加快撰寫使用手冊的速度」的工具，甚至是，一個可以「自動化撰寫使用手冊」的工具。

AI 自動化，應該可以的吧？

既然遇到問題了，就必須要想點辦法。畢竟，現在 AI 這麼厲害，總會有辦法解決的吧！

因此，我的終極目標是：提供足夠的資訊給 AI Agent 後，由 AI 建立出使用手冊。

雖然講是這樣講，但真的要動手做的時候，才發現其實也沒有那麼簡單，一個個的問題如同雨後春筍般地冒了出來...

到底什麼才算是「足夠的資訊」？
AI Agent 會怎麼建立手冊？
手冊的品質穩定嗎？

更重要的是：

如何才能建立出「高品質」的使用手冊？

規劃

在接下來的 29 天，我會分享我是怎麼一步一步地做出這個工具，並逐一解決前面想到的那些問題與疑惑。

沒意外的話，這個系列的前半部分，會比較偏向於經驗分享，包含：工具設計思路、技術決策等，後面才會開始有實作、程式碼範例說明。

如果各位有遇到類似的需求，之後可以自行拿去改成自己的版本，也可以參考我的思路，自己做出自己的 AI 自動化工具。

那麼，各位明天見！