Telegram 訊息加了格式,怎麼就送不出去了?
通知內容都整理好了,卻卡在最後一步,送到 Telegram 時收到 400。明明只是一段文字,加個標題、放個版本號,怎麼連送出去都成了問題。
我做每日推播的小工具時,就修過這種錯誤。當時開啟了 Telegram 舊版 Markdown 格式,讓文字可以顯示粗體等排版,內容裡的特殊字元卻讓整則訊息被拒收。後來的修正包含兩件事,改用 MarkdownV2,並在送出前把內容轉成它接受的寫法。
光換模式還不夠,文字也得跟著處理。
通知內容都整理好了,卻卡在最後一步,送到 Telegram 時收到 400。明明只是一段文字,加個標題、放個版本號,怎麼連送出去都成了問題。
我做每日推播的小工具時,就修過這種錯誤。當時開啟了 Telegram 舊版 Markdown 格式,讓文字可以顯示粗體等排版,內容裡的特殊字元卻讓整則訊息被拒收。後來的修正包含兩件事,改用 MarkdownV2,並在送出前把內容轉成它接受的寫法。
光換模式還不夠,文字也得跟著處理。
你有沒有遇過,程式明明顯示測試通過,自己打開來用,卻連最常做的操作都沒辦法完成?例如做了一個能匯出報表的小工具,檢查時沒有報錯,按下按鈕也出現成功訊息,下載後才發現檔案是空的。這時再看那一排通過的結果,很難不懷疑,剛才到底測了什麼。
我在做一套讓 AI 分工的工具時,也遇過類似的落差。角色設定檔產生了,檔案比對也通過,實際打開使用它的工具,卻找不到那些角色。那次通過的是「產生的檔案和預期一致」,並沒有驗到「工具真的讀得懂這些檔案」。兩件事只差一步,對使用結果的影響卻差很多。
所以看到測試通過,我會接著確認它涵蓋到哪裡。檢查計算結果、檔案內容,和從平常的入口完成一件事,各自能找出不同的問題。做自己的小工具,不必一開始準備完整的測試制度,但至少要挑一條主要流程,確認從開始操作到拿到結果都走得通。
做一個小工具時,資料該存在哪裡?存成檔案、放進試算表,或是使用資料庫,看起來都有辦法。但看到各種資料庫和雲端服務的介紹,又容易猶豫,是不是一開始就該準備得完整一點。我覺得可以先看看資料會怎麼使用,有些需求用檔案或試算表就夠了;即使需要資料庫,也不一定要另外架設一套服務。
我之前設計過一個 Telegram 記帳 bot 的原型,當時選的是 Google Sheets。預計讓使用者從聊天視窗記錄支出,由 bot 把帳目存進試算表,需要整理時再直接打開來看。這個想法很直覺,既然平常就會用表格記帳,讓程式幫忙填進去,似乎也不用為了看幾筆資料,另外做一個管理介面。
選儲存方式時,我會先看資料要怎麼使用。同樣是一張帳目表,單純記下每天花多少錢,和要處理多人分帳、個別還款,需要照顧的事情就差很多。能直接打開表格整理,是選 Google Sheets 的理由,但也要一起考慮程式會怎麼讀取、修改這些資料。
你有沒有做完一個小工具,準備公開時,就順手請 AI 幫忙把文件也補齊?現在用 AI 整理使用說明很方便,原本懶得從空白頁寫起的安裝步驟、操作範例,都能先有個草稿。既然都請它寫了,再補一份貢獻指南、行為準則,好像也不費什麼力氣,專案看起來還更完整。
我之前準備公開一套 AI 協作框架時,也整理出了一整套文件。它用 Markdown 和 YAML 這類文字檔,描述不同 AI 角色該做什麼,以及工作要怎麼交接,讓我不用每次重新交代同一套分工。原本想分享的是這個做法,整理到後來,專案裡卻已經有貢獻流程、社群規範和一大份內部架構說明。
只是文件生出來之後,裡面的流程還是得有人照著做、隨著專案更新。當時我仍打算以一人維護的方式經營專案,並沒有要照那套完整制度運作,後來便把其中幾份文件從對外版本移除,保留自己查閱需要的內容。我開始想的是,第一次看到這個專案的人,到底缺哪一份說明;如果他連怎麼開始用都不知道,我先寫完分支命名規則,好像也幫不上忙。
最近替自己的樂譜練習 App LilyScore 準備發版,功能做完、測試也跑過,最後卻卡在一個很普通的問題:這版到底更新了什麼?
過程中加過播放器功能、修過樂譜庫,還順手調了幾個小地方。每個當下我都知道自己在做什麼,隔了幾天再回頭看,腦袋卻只剩下「好像改了播放器」、「還有一個 bug」。接著又開始翻 commit、issue 和對話紀錄,把剛做完的事情重新整理一次。
LilyScore 第一次走完整個上架流程時,我才發現每一版都會遇到同一件事。商店要一份讓練習的人看得懂的更新說明,GitHub Release 又要保留完整紀錄;兩份都靠發版前臨時回想,很像考前一天才開始整理筆記。而且還是自己出的題目。
後來我沒有再多維護一份版本說明文件,而是把平常留下的修改紀錄,直接拿來當發版時的原料。
任務跑得久,不代表適合丟到背景
最近我在做一套能讓 AI agent 留在背景工作、完成後再把結果送回來的系統。最先拿來測試的,是一場多角色討論:先由一個角色找資料,其他角色從不同角度提出意見,最後再整理成結論。整個流程大約要跑 5 到 10 分鐘,中間也不需要我逐句回覆,看起來很適合丟到背景,終於可以假裝自己有員工了。
做到一半,我卻開始卡在一些和答案聰不聰明無關的問題。資料不足時,它要直接停下來,還是自己換個題目?其中一個角色失敗後,前面完成的步驟要不要重跑?我關掉對話之後,它跑完或卡住,又要用什麼方式告訴我?
本文所說的背景 AI agent,指的是工作開始後不再佔住目前的對話;我可以先去做別的事,等它完成、失敗或需要幫忙時再回來處理。那麼,一個任務預計要跑 10 分鐘,直接丟到背景就好了嗎?我實際做完才發現,執行時間只回答了我要等多久,還沒有回答它能不能在沒有人看著時繼續工作。
LilyScore 在我的手機上能正常開啟、能讀 PDF、能播伴奏時,我以為最難的部分已經過了。接下來大概就是把 App 打包、拖進 Google Play Console,等審核而已。
真的開始上架後,我才發現,能跑的 App 跟能上架的 App 中間,還隔著 application ID、簽章金鑰、商店資料、內容申報、測試軌與發布權限。這些設定散在本機、Play Console、Google Cloud 和 GitHub,每一項單獨看都不難,第一次卻會在同一段時間一起出現。
這篇把 LilyScore 從 Flutter 專案走到 Google Play 正式版的順序完整記下來。前半段是第一次上架一定會碰到的工作,後半段才是 GitHub Actions 自動發版;如果只想手動上傳,做到測試軌與正式版就可以停。
用 Android 手機或平板看 PDF 樂譜時,同一份譜可能要搭配原調、降半音等不同調性的伴奏,另外還有慢速示範,你會怎麼整理?我以前只能把它們丟在音樂資料夾。今天想換一個調練,就先離開 PDF、打開播放器,再從一串檔名裡找版本;有時還得播放幾秒,才知道自己有沒有選對。
所以我做了 LilyScore,先把同一份 PDF 樂譜和不同版本的伴奏收在一起,打開譜就能直接切換。不過找到伴奏只是開始,想練中間八小節,要切回播放器重抓進度;老師剛提醒的指法,又得另外找地方記。從紙本換成平板之後,譜是變輕了,練習流程卻還散在好幾個地方,於是後來又補進循環播放、註記與錄音。
現在 LilyScore 樂譜練習已經在 Google Play 正式上架。我平常打開一份譜,會先選今天要用的伴奏,再開始練習那幾個一直彈不順的小節。
多開之前,先寫下它要獨立完成的工作
一個 AI agent 做不好時,多開幾個真的會比較好嗎?
我最近在做一套會把工作分給不同 AI agent 的系統,剛好有一次機會實際驗證。Agent 寄信、排程或寫入資料後,有時會直接回報完成,卻沒有讀回結果,也沒有執行測試。我於是設計了一道「硬驗證閘」,準備在它交付前檢查一次;只要系統找不到驗證紀錄,就把回覆退回去,要求 agent 補做驗證。
規格裡已經考慮了誤判、重試上限與功能開關,我甚至刻意不檢查答案對不對,只確認 agent 有沒有留下驗證的痕跡。寫完時,我已經準備把它做進系統。不過在實作前,我另外找了一個 agent,請它停止補完設計,改為想辦法把它打穿。它最後找出九個問題,其中三個足以讓整套機制無法成立。這次讓我發現,第二個 agent 有沒有用,要看它能不能拿到一項獨立、可以驗收的工作。如果它只是來「一起想」或「一起做」,增加的通常是重複判斷、交接與合併。
整理一輪 skill 後學到的事
AI agent 的 skill 很好用。網路上可以找到各式各樣的 skill,每次看到一個可能用得上的,我總會迫不及待裝起來試試看。我原本以為,skill 裝得越多,AI agent 能做的事也會越多。
有一次,我只請它改兩段文章,它卻先整理需求、列計畫、分派工作,再安排一輪審核。模型沒有突然變笨,幾個 skill 卻讓原本簡單的工作多出許多步驟。我沒有精確量過前後差了多少 token,但計畫、分工與中間輸出都需要脈絡,工作也明顯變得笨重。類似情況發生幾次後,我重新整理自己裝過的 skill,最後刪掉了幾個。我開始在意的也不再是裝了多少,而是它該在什麼時候介入。