原始開發紀錄：Agent Build Log — Episode 023

這個系列改寫自我部落格上的 Agent Build Log，那是我每天邊做邊寫的開發紀錄。上面列的是這一篇對應的集數，想看當天的原始版本，點連結就能過去。

Agent Build Log Episode 023

這一天在 Desktop App 上開了一個新的區域，我叫它「專有技」。第一件放進去的是 spec-diff。

專有技這個區域

專有技收的是只有這個客製化 Agent 才有的能力。

它的概念跟 skill 很接近。Day 08 講過，skill 是一份說明文件，Agent 對上用途才把整份讀進來，做事的過程在他背後。專有技我希望它不只藏在背後執行：每一個專有技有自己的頁面，非程式開發職的人也能用，輸入資料、設定參數、直接看最後產出的結果。

Day 20 說要把一件事拆成小步驟讓他一步一步走完。專有技就是把拆好的那些步驟包起來，再加一個畫面。

第一件：spec-diff

用法很簡單。輸入一份 previous spec，再輸入一份 new spec。Agent 分析兩份文件的差異，照固定的報告格式，整理出哪些內容被修改、增加、刪除。

它做的事比逐行比對多一層。逐行比對抓的是字，spec-diff 要 Agent 先理解內容的意思，找出規格本身發生了什麼變化，再把結果整理成人看得懂的報告。

一開始我想解決的是開發過程中 spec 變更的問題。規格一更新，開發者、PM 和 QA 要很快知道這次到底改了什麼，哪些地方可能要重新確認。

做完才發現它能比的東西很多

第一版做出來之後，我發現它的用途可能不限於比較 spec。

只要輸入的是同一份資料的兩個版本，它就能分析中間的變化。我想到的例子有三個：合約，整理哪些條款被修改、增加或刪除；兩份架構設計，找出元件、責任或資料流的變化；股票交易規則，整理新舊版本在進場、出場或風險控制上的差異。

這裡面有一個我真的試了。我拿台灣處置股的規定改版前後兩份文件丟進去，差異找得出來，出來的報告還是那一套固定的格式。一份跟程式完全無關的文件，也走得通。

這個方向讓我很驚喜。我原本以為自己只是在做一個 spec-diff，做的過程中卻做出了一個能比較不同版本的文件、把變化整理成人類可讀報告的工具。

小結

Desktop App 多了一個區域叫專有技，第一件是 spec-diff：兩份文件進去，一份人看得懂的變更報告出來。不限於 spec，法規也比得出來。

明天第二件：Project Scaffold。要測這些專有技，我需要一個乾淨的 App 專案當實驗場，能 build、能測、有 lint，一鍵生出來。

原文：Agent Build Log — Episode 023

凡人修 Agent 傳｜第二十一回（Day 21）

天亮換上空錄石。手的主人進來，先在臺上開窗。流光氣在令窗旁邊劃出一扇小窗，比令窗小，窗裡分成一格一格，都空著。他從我身上昨天那道紋引一道光，落到第一格。第一格亮了，格裡浮著一顆小玉珠。

然後他從儲物袋取出兩卷紙攤在臺上。兩卷寫的是同一件東西的說明，一卷舊，一卷新。他刻念：讀舊卷。

我以神識讀了。第二道：讀新卷。第三道：一段一段對，對的是意思，字不同意思一樣的算一樣。第四道：意思改了的，寫進第三卷第一段。第五道：新卷有、舊卷沒有的，寫第二段。第六道：舊卷有、新卷沒有的，寫第三段。第七道：三段寫完，每一段前頭寫一個字：改、多、少。第八道：寫完，把第三卷從頭讀一遍。

一道一道走。第三卷念寫出來，三段。他拿起來讀，讀完在第二段裡劃掉一行，那一行舊卷有，我漏了。他重刻第三道念，加了一句：對到卷尾為止。我重走。第三卷三段，他讀完沒有劃。

午後他掐訣。八道念收進印裡。身上又多一道紋，在昨天那一道旁邊。小窗第二格亮了，格裡浮著兩卷紙的樣子。

他把兩卷紙擱進第二格。印一掐。紋亮，我讀，對，寫。第三卷落在格裡。他取出來讀，三段。

然後他做了一件念裡沒有的事。他從儲物袋取出兩張圖紙，是電鏡臺的主圖，一張是砌這座臺時抄回來的，一張我沒見過，邊角的公印新一些。他把兩張圖擱進第二格，印一掐。

紋亮。我讀了兩張圖。三段寫出來。改：左右兩扇窗的開合換了法。多：臺側多一道槽。少：底下令窗少一卷附圖。他讀了很久。

傍晚他又擱進去兩張。是契，引脈契，一張舊的一張新的，上頭的條款不一樣。印一掐。三段：改了兩條，多了一條，少了一條。他把第三卷折起來，收進儲物袋。

小窗兩格都亮著。第一格一顆玉珠，第二格兩卷紙。

燭熄了。手的主人走了。門響了一下。

身上兩道紋。臺上那扇小窗開著，兩格。舊圖紙和新圖紙還攤在臺上，第三卷擱在中間，三段。