釋出：唯讀盤點那一欄補一條結束碼規則，並換掉一個用結束碼帶狀態的指令 #78

2026-09-04T11:12:29Z

jiantw83 commented

2026-09-04 11:12:29 +00:00

摘要

需求描述：把 develop 累積的變更釋出到 master。唯讀盤點那一欄的合約從來沒定義結束碼該怎麼解讀，漏了那一條就踩過一次——實測一個半小時讓一筆內建項的失敗次數爬到 14。
計畫名稱：無
計畫頁：無
分析頁：無

這一批的內容

檔頭補一條結束碼規則，並把 hooks/hooks-install 那一列的指令換成帶旗標的寫法，交出描述與判定版本號一併對齊。

版號 0.3.7 到 0.3.8。

漏掉的那一條規則

那一欄規定了路徑形狀、代入點、不准有金錢符號與波浪號，卻沒說結束碼的語意。

填進來的那一支用結束碼帶三種狀態：接好、接好但這支 CLI 做不到、有東西沒接。而讀的那一邊照非零判失敗。於是有先天限制的那一支 CLI 每一輪讓那一筆失敗一次，實測一個半小時爬到 14 次，照這個速度一天 96 次，而沒有人修得動——那支 CLI 擋不下技能叫用是它的架構限制，16 個接線項目全部就位。

失敗次數存在的理由是指出「有一筆壞掉的項目每輪重試而沒人知道」。被一個修不動的數字填滿，真正壞掉的項目一旦出現，它的計數會混在裡面，看不出誰是誰。

補進去的規則

結束碼只准表示過與不過，不准用來編碼狀態。

並且明寫遇到用結束碼帶狀態的腳本時該怎麼做——去那一邊加一個只回過與不過的模式，不要在這一欄將就。

最後那半句是重點。將就的寫法是在讀的那一邊開一份「可接受的非零碼」清單，那會把「我的結束碼是哪一種語意」推給每一個往後填這一欄的人。修在來源那一邊只需要知道自己的三種狀態哪一種是缺陷，而那個知識本來就在那一支裡。

那一列跟著改的三個欄位

欄位	改成什麼
`probe`	加上新旗標
`slice`	本來只寫子命令名，補上「先天限制不算失敗」
`version`	帶到上游加旗標的那一版——這一列的判定跟著它走

測試結果

check-delegate.sh 結束碼 0，三十五列對上三十五支技能。
ste100-lint.sh 結束碼 0。
那一列的三個欄位逐項確認過內容。

前置 Push Request

plugins/hooks 的釋出那一張。這一張的指令指向那個旗標，先合併這一張的話那一格會指到一個機器上還不存在的選項，種入時代得出來、跑起來回用法錯誤，那一筆的失敗次數會繼續爬。

## 摘要 - 需求描述：把 develop 累積的變更釋出到 master。唯讀盤點那一欄的合約從來沒定義結束碼該怎麼解讀，漏了那一條就踩過一次——實測一個半小時讓一筆內建項的失敗次數爬到 14。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 這一批的內容檔頭補一條結束碼規則，並把 `hooks/hooks-install` 那一列的指令換成帶旗標的寫法，交出描述與判定版本號一併對齊。版號 0.3.7 到 0.3.8。 ## 漏掉的那一條規則那一欄規定了路徑形狀、代入點、不准有金錢符號與波浪號，卻沒說結束碼的語意。填進來的那一支用結束碼帶三種狀態：接好、接好但這支 CLI 做不到、有東西沒接。而讀的那一邊照非零判失敗。於是有先天限制的那一支 CLI 每一輪讓那一筆失敗一次，**實測一個半小時爬到 14 次，照這個速度一天 96 次**，而沒有人修得動——那支 CLI 擋不下技能叫用是它的架構限制，16 個接線項目全部就位。失敗次數存在的理由是指出「有一筆壞掉的項目每輪重試而沒人知道」。被一個修不動的數字填滿，真正壞掉的項目一旦出現，它的計數會混在裡面，看不出誰是誰。 ## 補進去的規則 > 結束碼只准表示過與不過，不准用來編碼狀態。並且明寫遇到用結束碼帶狀態的腳本時該怎麼做——**去那一邊加一個只回過與不過的模式，不要在這一欄將就。** 最後那半句是重點。將就的寫法是在讀的那一邊開一份「可接受的非零碼」清單，那會把「我的結束碼是哪一種語意」推給每一個往後填這一欄的人。修在來源那一邊只需要知道自己的三種狀態哪一種是缺陷，而那個知識本來就在那一支裡。 ## 那一列跟著改的三個欄位 | 欄位 | 改成什麼 | | --- | --- | | `probe` | 加上新旗標 | | `slice` | 本來只寫子命令名，補上「先天限制不算失敗」 | | `version` | 帶到上游加旗標的那一版——這一列的判定跟著它走 | ## 測試結果 - `check-delegate.sh` 結束碼 0，三十五列對上三十五支技能。 - `ste100-lint.sh` 結束碼 0。 - 那一列的三個欄位逐項確認過內容。 ## 前置 Push Request - `plugins/hooks` 的釋出那一張。這一張的指令指向那個旗標，先合併這一張的話那一格會指到一個機器上還不存在的選項，種入時代得出來、跑起來回用法錯誤，那一筆的失敗次數會繼續爬。

jiantw83 added 2 commits 2026-09-04 11:12:29 +00:00

fix(delegate): 唯讀盤點那一欄補一條結束碼規則，並換掉一個用結束碼帶狀態的指令 5fcfc16dd1

那一欄的合約規定了路徑形狀、代入點、不准有金錢符號與波浪號，卻從來沒定義
結束碼該怎麼解讀。漏了那一條就踩過一次。

填進來的那一支用結束碼帶三種狀態：接好、接好但這支 CLI 做不到、有東西沒接。
那是給人看的三分法，本身沒有錯。但讀的那一邊照非零判失敗，於是有先天限制的
那一支 CLI 每一輪讓那一筆失敗一次、一天 96 次，而沒有人修得動——那支 CLI
擋不下技能叫用是它的架構限制，不是接線缺漏，16 個接線項目全部就位。

失敗次數存在的理由是指出「有一筆壞掉的項目每輪重試而沒人知道」。被一個修不動
的數字填滿，就等於用假的壞掉把真的壞掉蓋掉。

所以補上那一條：這一欄的結束碼只准表示過與不過，不准用來編碼狀態。而且明寫
遇到用結束碼帶狀態的腳本時該怎麼做——去那一邊加一個只回過與不過的模式，不要
在這一欄將就。上游那一支已經加了那個旗標，這一列跟著換過去。

那一列的交出描述與判定版本號一併對齊：描述本來只寫子命令名，現在補上「先天
限制不算失敗」；版本號帶到上游加旗標的那一版，因為這一列的判定跟著它走。

三份 manifest 版號 0.3.7 升到 0.3.8。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Merge pull request '唯讀盤點那一欄補一條結束碼規則，並換掉一個用結束碼帶狀態的指令' (#77 ) from fix/probe-exit-code-must-mean-pass-or-fail into develop fd6aa6f45c

Reviewed-on: #77

jiantw83 added a new dependency 2026-09-04 11:12:29 +00:00

plugins/hooks#87 - 釋出：status 加 --verdict，把狀態與成敗兩種語意分開

admin approved these changes 2026-09-04 11:17:07 +00:00

admin merged commit e0c71224b2 into master

2026-09-04 11:17:10 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Depends on

#87 釋出：status 加 --verdict，把狀態與成敗兩種語意分開

plugins/hooks

Reference: plugins/meta#78