  jiantw83andClaude Opus 5
|
e53bb23f8e
|
feat(assistant): 存取庫掃描接上 {repo} 代入點
新增 tools/scan-repos.sh：掃出工作目錄底下的存取庫，交出 {repo} 要代的
那份清單，順便對出每一個存取庫的 REPO_{HASH} 盤點頁頁名（雜湊規則與
盤點頁那一支相同，實測值一致）。
掃描起點刻意沒有預設值。給一個預設就等於猜，而猜錯的後果不是掃不到，
是在猜錯的那些目錄底下跑指令——往上一層是家目錄、再往上是整台機器，
而那一輪沒有人看得到它跑到哪裡去了。沒設就回 3 並說要設哪一個變數。
深度預設一層、上限三層；點開頭的目錄、符號連結、路徑帶空白或殼層特殊
字元的三種一律不交出去，但逐個印出來——那是真的存在卻沒被盤點到的
存取庫，只印一個總數會讀成整批都掃過了。
run-due.sh 改成兩個代入點都代：{cli} 取偵測到的 CLI 代號、{repo} 取
掃到的存取庫，兩個都帶的那一筆目標數是乘積。待辦簿那一筆的 repo 欄
有值時只代那一個，值可以是路徑也可以是 {owner}/{repo}；對不出來就
印 held=，不退回全部存取庫——那一筆指名了一個目標。代入之後再驗一次
禁止字元，因為代進去的值是這一輪現場算出來的。
schedule.sh 把 JSC_ASSIST_SCAN_ROOT 與 JSC_ASSIST_SCAN_EXCLUDE 快照進
排程條目。少了掃描起點，帶 {repo} 的內建項每一輪都代不出目標，而那一輪
只印一行 held=，看起來像這一批還沒接上、不像一個變數沒進條目。
同時補兩個只有真的執行才發現得了的缺陷：
一、cron 一行的長度上限只在寫入那一刻由 crontab 自己擋，--dry-run 那一路
根本不碰它，所以預演每一次都過。實測踩過一次：整條 PATH 快照進條目那一批
預演全綠、安裝回結束碼 4。改成建好條目就量，兩個模式都印 entry_len= 與
上限，達到上限當場拒絕並指出長度是從哪幾個快照變數來的。
二、run-due.sh 截錯誤訊息用的 cut -c 數的是位元組不是字元，中文字剛好被
截在中間就在報告上留下一個替代字元。改成截完再過一次 iconv -c 丟掉那個
不完整的序列。這一種不會有人來報：亂碼不影響結束碼。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-09-07 10:36:26 +08:00 |
|
|
jiantw83andClaude Opus 5
|
98dd0761fa
|
docs(assistant): 被權限擋下的指令，回報要帶完整指令列
實測踩到一輪：它報「寫入監控頁失敗——系統的核准機制擋下這個寫入指令，重試
一次仍被擋下，不是 Gitea 回傳的錯誤碼」，然後照規則中止、釋放鎖、不寫心跳。
中止的行為完全正確，寫不成頁就不該假裝跑完。
但那一輪沒說是哪一支工具、哪一條指令。事後把明顯的嫌疑一個一個排除——那一支
腳本實測在無人值守下放行、暫存檔路徑落在檔案規則的範圍內、條目也帶著寫入
確認旗標——真正被擋的那一條始終沒找到。那一輪到現在還是原因不明。
問題在於「擋下」不是工具回的錯誤：沒有結束碼、沒有 stderr、工具自己的日誌上
也沒有痕跡。指令字面是唯一的證據，也是唯一能拿去對允許清單的東西，而清單
比對的是還沒展開的指令字面。所以少了那一行，事後就只能猜。
兩處都加：寫監控頁那一步的失敗分流加一條，界線那一段再加一條通則，涵蓋整輪
任何一次被擋。要求含環境變數前綴——那算指令字面的一部分，今天量過。
三份 manifest 版號從 0.2.9 升到 0.3.1。原本寫 0.2.10，同步 manifest 那一支
把它正規化掉了——那一支不收兩位數的修訂號。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-09-07 10:13:31 +08:00 |
|
|
jiantw83andClaude Opus 5
|
633f56e7ea
|
docs(assistant): 收尾回報要讀 cli_missing 那一行
巡檢步驟五的記錄清單補上那個欄位，並寫明它是唯一看得出「少跑一支」的地方
——每一支偵測到的目標都跑過、都通過，那一輪也照樣回報都跑過了。
回報要求也寫進去：點名少了哪幾支、講明乾淨通過不等於完整通過、指出重跑排程
安裝才會重新拍快照。
三份 manifest 版號 0.2.8 升到 0.2.9。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-09-07 09:40:00 +08:00 |
|
|
jiantw83andClaude Opus 5
|
4562da2bea
|
docs(assistant): 執行那一步要把同一輪的到期清單路徑餵進去
巡檢步驟五改成帶 --rows，值取步驟一印的那個新欄位，並寫明那不是選用的、
也沒有預設值。步驟一的記錄清單跟著補上那個欄位，並註明它是空的時候代表判到期
那一步沒有產出清單，步驟五就沒有東西可動，要照實說而不是退回任何預設。
會把「為什麼不能有預設」寫進本文，是因為這個缺陷的形狀值得留下來：預設值指向
的位置在單機手動跑過一次之後就會有檔案，而那個檔案讀起來跟新的一模一樣。
三份 manifest 版號 0.2.7 升到 0.2.8。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-09-07 08:59:43 +08:00 |
|
|
jiantw83andClaude Opus 5
|
a050404a77
|
docs(assistant): 組頁那一步改成叫 rebuild，不再由呼叫端自己接
技能本文原本把三塊的接法描述給呼叫端，現在改成叫那一個子命令，並把「為什麼
不留給呼叫端接」寫進去——一個只有一種對的形狀的步驟，不該放在提示裡。
舊格式頁的處置本來在本文裡寫了一遍，現在由腳本自己認並印出來，所以那一段
刪掉，免得兩份文件對同一件事各講一次而漂移。
三份 manifest 版號 0.2.6 升到 0.2.7。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-09-04 17:42:54 +08:00 |
|
|
jiantw83andClaude Opus 5
|
7d40c9dded
|
feat(assistant): 巡檢那一輪接上執行到期內建項
檢核腳本沒人叫等於不存在，所以同一批把它接進巡檢的步驟五，擺在寫心跳之前
——跑過的結果要進得了這一輪的紀錄。任何一個結束碼都不中止那一輪：一支指令
失敗是發現，不是壞掉的一輪。
界線那一段補了一條，把兩件事分開：不對發現動手，跟跑自己排定的工作，不是
同一件事。待人處理那幾列是關於別人機器狀態的發現，跑那幾列等於一輪自己決定
別人的工作該怎麼做；到期的內建項是助理自己被交付的工作，來源是要走 PR 審查
的委派清單。並且寫明：哪天那一欄出現會寫入的指令，要重新吵這一段，不是悄悄
把它放寬。
收尾回報多一個區塊，因為那是待辦簿自己的工作唯一被交代的地方，並要求把
「跳過那幾筆的歷史沒有被動過」講明。
三份 manifest 版號 0.2.2 升到 0.2.3。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-09-04 13:58:16 +08:00 |
|
|
jiantw83andClaude Opus 5
|
85a0ce9e10
|
fix(assistant): 人在現場那一路的根目錄解析帶上文件記載的預設值
技能本文寫著那一行「涵蓋了文件記載的 ~/.jsc 退讓」，實際上沒有。JSC_HOME
沒設時 $JSC_HOME/current 展開成 /current，不是退讓到任何地方——殼並不知道
那個變數的文件預設值是什麼。解析式現在自己帶預設，退讓才真的發生。
這台機器從頭到尾沒設過那個變數，所以每一次人在現場叫用都停在第 0 步，而且
守衛開的藥方指向不相干的地方：它說根目錄不見了、叫人跑部署，但根目錄好好
的，壞的是解析式自己。排程那一路不受影響，條目自己帶著變數值。
目錄檢查留著，理由改寫進本文：解析式交出一條看起來合理卻不存在的路徑，
不是只有變數沒設一種成因——變數指到已經刪掉的目錄、精簡環境裡連家目錄都
沒設、連結農場根本還沒部署，三種都一樣過得了前三道關。
行為清單那一份早就寫對了，是技能本文漂走。這一次把兩份對齊，並把事故記述
改成過去式，免得下一輪有人照著它重寫回錯的形狀。
實測表第四列不動：那是量到的結果，而且新寫法一樣帶變數、無人值守一樣被擋，
另外加一段講明預設值改的是解析出哪條路徑，不是誰可以跑它。
三份 manifest 版號 0.2.0 升到 0.2.1。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-09-04 11:53:10 +08:00 |
|
|
jiantw83andClaude Opus 5
|
28f453176e
|
feat(seed): 種入內建項時改讀委派清單的唯讀盤點指令欄
委派清單補上第十二欄 probe 之後，這一支不再把所有非 invoke 的列一律推成
只提醒：填了指令的四列改成把那一行指令代好代入點寫進動作欄，寫著
pending 的七列照舊只提醒但另外印出來，讓「入口還沒接上」跟「本來就只提醒」
在回報上分得開。
三個判斷刻意寫死：
一、way 含 invoke 的列連看都不看 probe。填了指令會讓整支技能的交出變成
只跑一支腳本，那支技能該寫的頁一頁都不會寫，而且看起來完全正常。
二、probe 代不進去一律退回只提醒並照樣種入。不種入在 apply 那一路等於
移除，於是上游一格填錯就會刪掉一筆帶著 last_run 與 fail_count 的內建項。
金錢符號與波浪號擋在種入這一刻，那兩種寫法在無人值守那一輪解不出來、
也進不了允許清單，會被靜靜擋掉。
三、{cli} 與 {repo} 留在值裡不展開。種入的當下還不知道要代什麼，展開成
多筆會讓同一個 spec_key 有好幾個檔案，一致化整個垮掉。展開由執行那一步
負責，而動作欄裡出現大括號就是還沒代好，一律不得原樣拿去執行。
清單只有十一欄時整份先數一次欄位數，全部照舊推成只提醒、只印一行說明，
行為與加這一欄之前一模一樣。第十三欄以後另接一個收尾變數，免得上游哪天
加一欄就把多出來的值黏進 probe，代入點檢查全過得了關、最後執行的卻是
一行誰都沒寫過的指令。
相依下限刻意不動。清單那一欄晚一步到也照常跑得完，把下限拉到有那一欄的
版本等於逼兩個存放庫排合併順序，而排順序正是這一段程式碼要免掉的事。
三份 manifest 的版號從 0.1.9 升到 0.2.0。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-09-04 10:16:13 +08:00 |
|
|
jiantw83
|
a168c5904c
|
feat(seed): 依委派清單種入與重建助理的內建定期檢查項
待辦簿做好了但是空的，也沒有東西會去填它。內建的定期檢查項該排哪些、什麼時候排、多久一次，這些資料就在委派清單裡——每一支非不交的技能都有時間點與週期兩欄。這一輪把清單接成待辦簿的資料來源。
反查靠新增的一個欄位，它非有不可。清單移除一支之後要刪掉對應那筆，但待辦簿的識別碼是建立時間加標題的雜湊，跟技能名無關。拿標題當鍵等於把措辭變成介面，改一個字舊那筆就再也認不出來，於是每次重建都刪不掉舊的又加一筆新的，同一個檢查每輪做兩次。拿動作當鍵，提醒類那十一筆全是同一個字、一支都分不出來，而觸發類那幾筆會撞上使用者自己交辦、動作剛好是同一支技能的那一筆——撞上就是把使用者交辦的事當成內建項刪掉。所以另立一欄記那一筆對應哪一支技能。
因為要加欄位，寫入端只能改存放那一支——它是唯一寫得出待辦檔的入口，這一輪沒有自己寫檔。連帶補上移除那個操作：規格要求不留孤兒，而原本六個操作一個都刪不掉。它對使用者交辦的那幾筆一律擋下、除非人親自帶強制旗標，而種入這一支一次都不帶。擋在單一寫入者這裡最省，那條規定寫在呼叫端的話，呼叫端每多一個就要各自再實作一次。
交出方式與動作是兩套詞彙，對映是這一輪的重點。含觸發就取技能名，其餘一律取提醒。觸發的定義就是呼叫既有技能、內容照那支技能自己的流程走，所以填技能名等於照判定結果做。巡檢與提醒那兩種沒有獨立入口——沒有任何腳本或技能名代表得了某一支技能的唯讀切片——這時候填技能名，助理下一輪就會把整支技能一路跑完，那正是切片交要防的事。所以填提醒：照時程提醒、指出入口，不動手。實測十六筆裡五筆是技能名、十一筆是提醒。
條件式交的三支一律不種入，但逐支吵出來。條件本身是散文，清單裡沒有機器讀得懂的條件欄位，所以條件成立了沒有現在只有人答得出來。種進去的代價有現成例子：其中一支的條件明寫要等它自家路徑不再帶版本號，而那個條件現在不成立，種進去助理每輪都會叫它、每輪停在第一支自家腳本，沒有錯誤、沒有輸出、心跳照寫，看起來完全正常。一個會無聲卡死的項目比一個缺掉的項目難查得多。不種入的代價是看不出為什麼少了它，用逐支印一行保留原因補掉。人確認過某一支條件成立就一支一支帶旗標放行，不給全部放行的旗標，那等於用一個決定蓋掉三個不同的條件。
種入與重建是同一段程式，啟動時每次都跑。不記跑過沒有，也沒有第一次旗標，要不要動手完全由現況決定。分成兩段的話，兩段各自回答該有哪幾筆這同一個問題，等其中一段改了判準就會一邊加一邊刪同一筆，每輪反覆。啟動時跑實際套用、查現況時跑唯讀預覽，巡檢那一輪兩個都不跑——無人值守那一輪移除一筆會把那一筆的執行紀錄與失敗次數一起弄丟，而清單同步到一半就會刪錯，破壞性清理留給人。
清單讀不到的三種情況一筆都不移除。讀不到時，清單上沒有與這台機器沒裝那個外掛分不出來，照字面跑會把所有內建項一次刪光，而且結束碼看起來完全成功。
清單上還在、還可交，只是時間點或週期換了值的那種情況，規格三條規則一條都沒講到。處置是預設只報差異不改：存放那一支刻意沒有編輯操作，改值只能移除再重登，那會換識別碼、把執行紀錄與失敗次數歸零，一個已經連續失敗五次的項目會看起來像全新的。人要換就帶旗標。
跨外掛相依宣告到清單所在的那個外掛，版本下限取現行的發行版——那是清單與它的欄位說明都已經在上面的版本。寫更低的下限會讓一台裝著舊版、清單還不存在或欄位不同的機器通過相依檢查，然後在讀清單那一步才失敗。清單路徑照今天剛改的規則走，由叫用時餵進來的根目錄組成，那一支自己不解。
三份 manifest 的版號一併從 0.1.8 升到 0.1.9，並在相依欄加上清單所在的那個外掛。這一次沒有把版號分成獨立一筆：相依宣告與版號是同一個決定的兩半，宣告了新相依卻不升版，安裝端不會知道要重新檢查相依。
|
2026-09-03 19:05:07 +08:00 |
|
|
jiantw83
|
711eecac2f
|
fix(assistant): 根目錄守門補上目錄存在檢查
人在現場那一條路解出根目錄之後，守門只看「非空、結束碼 0、是絕對路徑」三項，攔不住 JSC_HOME 沒設的情況。
實測：JSC_HOME 沒設時，readlink -f "$JSC_HOME/current" 印出 /current、結束碼 0。三項全部符合，直接通關，而 /current 並不存在。之後每一條由它組出來的字面路徑都指向不存在的地方，錯誤要到第一支腳本才浮出來，而且訊息看不出根因。
守門加上第四項：印出來的路徑必須是存在的目錄，用 [ -d ] 在同一個已核准的步驟裡查。檢查只掛在人在現場那一條，排程那一輪照舊一個指令都不跑——它的根目錄是安裝排程的人寫進條目的，錯了就由第一支腳本呼叫失敗來反映。
行為契約的關鍵步驟與完成條件兩列跟著改。
|
2026-09-03 10:31:05 +08:00 |
|
|
jiantw83
|
fb8b9baedd
|
fix(assistant): 巡檢改用字面絕對路徑，根目錄由排程條目帶進來
無人看管的排程輪次在第一支腳本就被權限層擋下。心跳因此寫不出來，助理斷了兩個多小時，沒有人發現。
2026-09-02 到 09-03 用非互動模式比照排程環境實測七種寫法，歸納出兩條判準。一、無人值守時只有允許清單上的完整字面指令跑得動，沒有「預設安全的唯讀指令」這回事，連 readlink 與 ls 都要有自己的規則。二、路徑中段的萬用字元不匹配，規則與指令都必須是完整字面，所以帶版本號的快取路徑放不進允許清單。「先解路徑再用」因此不成立：解路徑的指令自己就過不了，而路徑能寫成字面就不必解。
助理技能新增路徑守則與 Step 0。守則寫明權限層比對的是指令還沒展開的字面字串，帶未展開變數或波浪號的路徑一律要核准，並附上七列實測佐證表。Step 0 從「自己跑 readlink 解路徑」改成「從叫用文字的『工具根目錄=』取字面絕對路徑」，排程那一輪一個解析指令都不跑；人在現場叫用才用 readlink 解一次，那一次有人可以按同意。取不到根目錄就停下回報，收尾狀態取 aborted，不猜也不退回帶變數的路徑。全篇 46 處腳本呼叫改成字面絕對路徑。
排程工具在安裝時把解好的字面根目錄寫進條目的提示文字，並印成 patrol_root=。條目與允許規則共用同一個值，兩邊各算各的就會差開，而差開的那一輪是被靜靜擋掉。允許規則的提示改成完整字面路徑，不寫變數、波浪號與萬用字元。JSC_HOME 解不出絕對路徑時回結束碼 6，不讓相對路徑寫進條目。自訂巡檢指令沒帶那一段只警告、不中止。
行為契約四列與說明文件兩處敘述一併跟上。
|
2026-09-03 10:10:01 +08:00 |
|
|
jiantw83
|
311cdc611a
|
feat(wiki): 巡檢目錄頁改成一台機器一個大標題區塊
巡檢目錄頁的版面從 markdown 表格換成「大標題加條列」：一台機器一個大標題
區塊，標題就是那一台機器監控頁的實際頁名，欄位改成標題底下的一層條列。
範本、技能敘述、行為清單與說明文件一併跟上，目錄頁上不再留任何表格。
表格的欄位組合是整頁共用的，表頭跟著建頁那一台機器走，之後每一台只改自己
那一列。欄位一增減，只有跑到新版的機器寫得出新的格數，同一張表就混著兩種
格數，多出來的那一格對不到任何欄名，而目錄頁又沒有整頁改寫的路可以走——
整頁覆蓋等於刪掉別台機器的紀錄。條列一筆一個區塊，欄位各自獨立，加一條只
動到自己那一個區塊。
比對鍵從裸雜湊那一格改成大標題本身，標題寫成監控頁的實際頁名。頁名只由
主機名與登入帳號決定，換主機位址、換專用存取庫或換一種頁名編碼都動不到
它；含網址的那一條連結照樣留著給人點，但不當鍵。呼叫改成拿頁名當鍵，欄號
那個參數只在舊表格頁轉檔時用得到。範本原本用二階標題寫的說明區段全部搬進
引言，否則轉檔後會被當成一筆真紀錄讀進去。
範圍是助理的巡檢目錄頁與 assistant 技能的敘述。
|
2026-09-02 17:21:12 +08:00 |
|
|
jiantw83
|
3dac1475df
|
feat(狀態回報): 收尾寫一筆 skill-end 事件
現行紀錄只記「被叫用」，沒有成敗也沒有結束碼。跑完整輪的技能與開場就
中止的技能，在紀錄裡長得一模一樣。
start 由技能用量 hook 順手發，不必改技能文件。end 只能由技能自己在收尾
步驟寫——hook 接在技能工具呼叫上，而實際工作發生在之後的模型輪次，它在
原理上看不到成敗。有 start 沒有配對的 end，就是那一輪中止了。
status 五選一，每支技能各自寫明什麼情況選哪一個。找不到回報腳本就安靜
跳過，回報失敗一律不改變技能自己的結論。
|
2026-09-02 16:01:13 +08:00 |
|
|
jiantw83
|
9ea83da38b
|
feat(link): 連結一律寫成 [文字](絕對網址)，寫入前先驗證連得到
取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與
「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上
看起來像普通文字或死連結，巡不到也修不了。
連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API，
不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把
好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁
整批判死。
|
2026-09-02 14:27:18 +08:00 |
|
|
jiantw83
|
4bf99dde76
|
feat(wiki): 監控目錄頁改走專用存取庫，比對鍵改用裸 HASH
What：MONITOR_CONTENTS 改由 wiki-repo CONTENTS 解析並透過 wiki-contents.sh
upsert 寫入，MONITOR_{HASH} 仍走 wiki-repo MONITOR。目錄頁新增一欄裸 HASH 當
比對鍵，第一欄的絕對網址連結留給人看。主機名一律取短名。
Why：目錄頁集中之後兩頁不再同庫，[[...]] 只在同一個 wiki 內解析，連結必須改絕對
網址。比對鍵原本是含網址的儲存格，換主機、換存取庫或 URL 編碼有差就比對不到，
巡檢每 15 分鐘寫一次，重複列會累積得很快。
How：目錄頁解不出存取庫時不再中止巡檢——那一頁只是索引，內容頁寫成就照樣寫心跳。
內容頁寫不成仍然中止且不寫心跳，自咬環的前提沒有鬆動。
Who：jsc-assist
|
2026-09-02 11:01:51 +08:00 |
|
|
jiantw83
|
02bfc70f4e
|
fix(assistant): 讓執行路徑走錯與警示原因都看得見
兩支腳本開跑就檢查自己的執行路徑，監控頁的摘要表與最新一輪那一塊補上
「警示來源」。
兩件都是實測之後補的。用全新的 CLI 行程跑，代理人會把工具路徑解回外掛
快取那一份，不是指定的工作樹那一份。原本的對策只在技能說明書裡寫明禁
止，那是文件約束，擋不住真的走錯的那一輪。權限閘門只放行 current 那一
組確切路徑，走錯就被靜靜擋掉，那一輪不寫心跳，外面只看得到心跳過期。
另一頭，沙箱跑出來的摘要列是「警示、四項全過、待人處理 0」，讀的人看
不出警示哪來。查過不是缺陷：四項來源都讀得到，是讀到的內容有警示。摘
要表的用途本來就是一眼看出從哪一輪開始壞，少了原因那一欄就做不到。
巡檢與排程兩支腳本開跑時先比對自己是不是從 current 底下被叫起來的，不
是就往 stderr 印一行警告，點名實際路徑、應該用的路徑與理由。刻意只警告
不中止：從工作樹直接跑腳本是開發時的正當用法，中止會把那條路擋掉，真
正的失敗本來就發生在權限閘門那裡。摘要表從四欄加到五欄，最新一輪那一
塊也補一列，值取每一處設警示時收下來的短理由，多個用頓號串，沒有就寫
「無」。腳本裡每一處把判定改成警示的地方，一律改走同一支函式順手收下
理由，collect 的輸出多印一行 warn_sources。技能主文、行為清單與監控頁
範本跟著寫明這兩件事。
功能範圍是助理的一輪巡檢與系統排程安裝。
|
2026-09-01 18:54:05 +08:00 |
|
|
jiantw83
|
a8e387ad50
|
docs(assistant): 文件跟上新的工具路徑與監控頁寫法
技能主文、行為清單、專案說明與界線文件一起改，對齊這一輪的排程修正與
監控頁改版。
工具路徑與監控頁寫法都換了，文件沒跟上就是照舊做法跑：用快取基底目錄
組出來的路徑會被權限靜靜擋掉，那一輪停在沒有人能回答的權限詢問；照舊
的附加語意寫頁，又會把剛換好的三塊寫回一輪一節。
技能主文的工具路徑一律改走 current 那一組不帶版本的路徑，新增 Tool
paths 一節列出四支工具，並寫明權限閘門只放行那一組，放行技能不等於放
行技能裡的每一個呼叫。監控頁那幾步改寫成讀回舊頁、基本資料原樣留著、
最新一輪整塊換掉、本輪摘要列擺最上面並截到 24 列，舊格式的頁第一次重
組要在回報裡說明。frontmatter 的 description 重寫並補上單引號，句中有
冒號不加引號會讓解析走偏。界線四從「只附加」改成三塊寫入語意。專案說
明與行為清單同步條目的環境快照、allow 規則、暫存檔名與可驗證跡象。
功能範圍是助理技能的文件與行為合約，不動任何腳本行為。
|
2026-09-01 18:28:04 +08:00 |
|
|
jiantw83
|
2b7176a644
|
feat(patrol): 一輪巡檢落地，心跳改由巡檢跑完才寫
What：
- 新增 tools/patrol.sh，三個子命令：collect 收集、finish 收尾、abort 中止。這一輪的巡檢項目是四項純讀取：使用統計、版本落差與重啟閘門、階段鎖與工作包鎖、心跳自述。
- 心跳的寫入從排程移到巡檢收尾。排程只呼叫巡檢，不再直接寫心跳。
- 排程週期由心跳門檻推導，不再寫死。install heartbeat 這個工作代號改為拒絕。
Why：
- 排程直接寫心跳的話，心跳新鮮只證明排程活著。巡檢整個壞掉、每輪都失敗，心跳照樣新鮮，閘門照樣放行，而且沒有任何錯誤訊息——這是無聲失效，是最難發現的一種。
- 改成巡檢寫，心跳新鮮才等於上一輪真的跑完了。閘門判的才是工作訊號，不是行程存活訊號。
- 門檻是讀取端的設定，心跳檔裡不存它。所以週期與門檻各寫死一個數字一定會撞：門檻五分鐘、巡檢十五分鐘，心跳永遠是過期的。
How：
- 週期取「滿足漏掉一輪還算新鮮、漏掉兩輪才過期」的最大值，並且要能整除一小時。要拉長巡檢週期就調大門檻，週期自動跟著長，兩個數字不會各走各的。
- 心跳只看「這一輪有沒有把結果記下來」，不看四項的成敗。四項有失敗但監控頁寫成了就寫心跳，頁上判定標警示；頁寫不成就中止，一定不寫，讓心跳自己過期。頁每輪都寫失敗卻照樣寫心跳，等於把這次要修掉的缺陷原封不動搬過去。
- 整輪拿一把目錄鎖，搶不到就讓開，不排隊也不並行。並行兩輪會在同一頁附兩節，還會互相蓋掉用量快照。鎖逾時可被下一輪搶走，被搶走的那一輪收尾時對不上就不寫心跳——它沒跑到底，不該蓋章。
- 任一項失敗不影響其餘項目。失敗要在監控頁上看得出來是失敗，不是沒資料；來源是空的則明寫「那是零次，不是故障」。
- 版本盤點照抄腳本原字。抄到查詢失敗就寫查詢失敗，不改寫成相符、也不自己補查遠端版本——查不到是沒有證據，不是版本沒問題。
Who：
助理落地的第四塊。排程那一輪留下的問題在這裡解掉了。
|
2026-09-01 15:06:10 +08:00 |
|
|
jiantw83
|
7343def16e
|
feat(schedule): 助理的系統排程接線
What：
- 新增 tools/schedule.sh，三個子命令：install 安裝、remove 移除、status 查現況。兩筆工作分別是每分鐘的心跳與每十五分鐘的巡檢。
- 助理主體的 start 接上安裝、stop 接上移除，行為清單與 README 跟著更新。
Why：
- 心跳要有人定時寫，不然啟動之後過幾分鐘就自己過期，助理看起來像沒在跑。
- 排程這件事有標準的輸入與輸出，準則要求下放腳本，技能只描述何時呼叫。
How：
- 條目行尾帶固定標記，安裝先濾掉自己的舊條目再追加。絕不覆寫整份排程，別人的條目一行都不碰；寫完回讀驗證，出現兩筆或別人的行數對不上就報錯。
- 裝完檢查排程服務在不在跑。這台機器是 WSL，預設不啟動 cron，裝了條目卻一次都不會執行——不檢查就會宣稱一件沒發生的事。
- 條目一律帶 </dev/null。排程是非互動環境，任何等輸入的東西都會把整筆卡死。
- 輸出寫到 JSC_HOME 底下，不寫進任何專案目錄，免得多出未追蹤檔污染別人的變更盤點。
- 巡檢那一筆預設不裝，要明著指定才會裝。巡檢本體還沒實作，裝了只會每十五分鐘失敗一次；巡檢指令也不猜 CLI，判不出來就停下，猜錯的代價是每十五分鐘跑一支不存在的執行檔。
- stop 先移除排程再清心跳，順序不能反。反過來的話清完下一分鐘排程就補寫一次，stop 等於騙人。
Who：
助理落地的第三塊。這裡留下一個要在巡檢那一輪解掉的問題：心跳目前由排程直接寫，所以心跳新鮮只證明排程活著，不證明助理做了事。往後應該改由巡檢跑完那一輪去寫，心跳才等於工作訊號。限制已寫進技能內文與說明文件。
|
2026-09-01 14:34:12 +08:00 |
|
|
jiantw83
|
fbf3e5a605
|
feat(assistant): 助理主體收攏 start、status、stop 三個操作
What：
- 新增 assistant 技能，提供啟動、查現況、停止三個操作。
- 刪掉原本獨立的 status 技能，行為清單與 README 的技能目錄一起改。
- 三份 manifest 的版本一起提升，對 jsc-hooks 的下限提到含心跳腳本的那一版。
Why：
- 助理的生命週期是一件事，拆在兩支技能裡，靠描述自動觸發的 CLI 等於擲骰子挑一支。準則也明寫技能目標不得重複。
- 刪除的代價這時候最低：這個 domain 才剛落地，status 是它唯一一支技能，除了自己的文件沒有別的東西指向它。晚一步等各處都引用了再收攏，成本差很多。
How：
- 心跳的判定一律交給 jsc-hooks 的心跳腳本，三個操作都讀它的回報，不自己解析心跳檔。判定有兩份就會漂移，狀態與訊息就會對不上。
- 那支腳本的每一個結束碼都在技能裡有明確處置，包含「腳本自己沒跑起來」那一種——那時候既不能說助理在跑，也不能說助理停了。
- 時間戳壞掉一律當成不新鮮，絕不退回判成新鮮。
- 異常結束不需要額外的清理機制：心跳是時間戳，過了門檻自動失效。反過來說，stop 以外的任何路徑都不該寫心跳，否則就是留一個假心跳。
- stop 清心跳是它的職責，不算助理界線裡「不刪狀態檔」那一條。技能內文把這個例外寫明白，免得日後照界線把 stop 砍掉。
- stop 的收尾同時講兩件事：心跳清掉之後閘門會擋下技能呼叫，以及閘門目前還沒接線所以這一刻擋不到誰。前者是設計後果，停助理的人一定要知道；後者不講就是說一件還沒成真的事。
- 排程這一輪不做，start 只寫第一次心跳，並講明心跳不會自動更新。
Who：
助理落地的第二塊：心跳有了，接著要有人寫它、讀它、清它。
|
2026-09-01 14:19:24 +08:00 |
|