清單檔頭寫明哪三個事件名一定要帶參數，避免技能靜靜沒有內建項 #71

2026-09-03T11:04:00Z

jiantw83 commented

2026-09-03 11:04:00 +00:00

摘要

需求描述：委派清單的檔頭把七個事件名列成同一種形狀，但待辦簿的登錄那一步要求其中三個一定要帶參數。照檔頭的寫法填一列會被擋下，而擋下的方式是那支技能靜靜沒有內建項。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`tools/delegate-spec.tsv`	檔頭的事件名說明分成「帶參數」與「不帶參數」兩組，並寫明為什麼那三個非帶不可。只改註解，一列資料都沒動
三份 manifest	版號 0.3.3 升到 0.3.4

設計重點

這是一個無聲失敗的陷阱，趁還沒有人踩到先補掉。 登錄那一步對三個事件名要求參數（工作包代號、階段、分析頁雜湊），照檔頭寫成不帶參數的形狀就會回欄位不合法。那支技能於是沒有內建項，而少了什麼要看種入回報的統計那幾行才發現。
寫明理由，不只寫格式。 那三個事件問的是「哪一個工作包合併了」而不是「有工作包合併了」，少了參數就指不到特定的一件事。只列形狀不寫理由，下一個人還是會覺得參數可以省。

測試結果

check-delegate.sh 回結束碼 0，35 列對 35 支技能，資料一列都沒動。
lint-scripts.sh、check-behaviors.sh、ste100-lint.sh 都回結束碼 0。

前置 Push Request

無

## 摘要 - 需求描述：委派清單的檔頭把七個事件名列成同一種形狀，但待辦簿的登錄那一步要求其中三個一定要帶參數。照檔頭的寫法填一列會被擋下，而擋下的方式是那支技能靜靜沒有內建項。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `tools/delegate-spec.tsv` | 檔頭的事件名說明分成「帶參數」與「不帶參數」兩組，並寫明為什麼那三個非帶不可。只改註解，一列資料都沒動 | | 三份 manifest | 版號 0.3.3 升到 0.3.4 | ## 設計重點 - **這是一個無聲失敗的陷阱，趁還沒有人踩到先補掉。** 登錄那一步對三個事件名要求參數（工作包代號、階段、分析頁雜湊），照檔頭寫成不帶參數的形狀就會回欄位不合法。那支技能於是沒有內建項，而少了什麼要看種入回報的統計那幾行才發現。 - **寫明理由，不只寫格式。** 那三個事件問的是「哪一個工作包合併了」而不是「有工作包合併了」，少了參數就指不到特定的一件事。只列形狀不寫理由，下一個人還是會覺得參數可以省。 ## 測試結果 - `check-delegate.sh` 回結束碼 0，35 列對 35 支技能，資料一列都沒動。 - `lint-scripts.sh`、`check-behaviors.sh`、`ste100-lint.sh` 都回結束碼 0。 ## 前置 Push Request - 無

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

docs(delegate): 清單檔頭寫明哪三個事件名一定要帶參數 d6bd022920

檔頭把七個事件名列成同一種形狀，但待辦簿的登錄那一步要求其中三個一定要帶參數。照檔頭的寫法填一列，登錄會回欄位不合法，那支技能於是靜靜沒有內建項——少了什麼要看種入回報那幾行才發現。

分成帶參數與不帶參數兩組列出來，並寫明為什麼那三個非帶不可：它們問的是「哪一個工作包合併了」而不是「有工作包合併了」，少了參數就指不到特定的一件事。

只改註解，一列資料都沒動。

chore(plugin): 三份 manifest 升版至 0.3.4 cb8123faa0

清單檔頭的修正要靠版號才傳得到機器端。

三份 manifest 由 sync-skill-manifest.sh 同步，只動版本欄位。

admin approved these changes 2026-09-04 01:03:16 +00:00

admin merged commit 54e77a8da9 into develop

2026-09-04 01:03:20 +00:00

admin deleted branch docs/event-name-parameter-shape-in-delegate-spec

2026-09-04 01:03:22 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/meta#71