From d6bd022920a5ed6f03956120bd0a45e02322db34 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 3 Sep 2026 19:03:40 +0800 Subject: [PATCH] =?UTF-8?q?docs(delegate):=20=E6=B8=85=E5=96=AE=E6=AA=94?= =?UTF-8?q?=E9=A0=AD=E5=AF=AB=E6=98=8E=E5=93=AA=E4=B8=89=E5=80=8B=E4=BA=8B?= =?UTF-8?q?=E4=BB=B6=E5=90=8D=E4=B8=80=E5=AE=9A=E8=A6=81=E5=B8=B6=E5=8F=83?= =?UTF-8?q?=E6=95=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 檔頭把七個事件名列成同一種形狀，但待辦簿的登錄那一步要求其中三個一定要帶參數。照檔頭的寫法填一列，登錄會回欄位不合法，那支技能於是靜靜沒有內建項——少了什麼要看種入回報那幾行才發現。 分成帶參數與不帶參數兩組列出來，並寫明為什麼那三個非帶不可：它們問的是「哪一個工作包合併了」而不是「有工作包合併了」，少了參數就指不到特定的一件事。 只改註解，一列資料都沒動。 --- tools/delegate-spec.tsv | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/tools/delegate-spec.tsv b/tools/delegate-spec.tsv index cc1322b..f44b440 100644 --- a/tools/delegate-spec.tsv +++ b/tools/delegate-spec.tsv @@ -18,8 +18,14 @@ # 當成可交的一路跑完。不交填不交的理由，否則下次分不出「判過決定不交」與 # 「還沒判」。全交寫 - # trigger 第一次什麼時候到期：at:{ISO 時間}，立刻要做寫 at:now；或 after:{事件名}。 -# 事件名只認固定詞彙：worklog-written、wp-merged、stage-entered、 -# analyze-completed、hook-error、session-start、session-end。不交寫 - +# 事件名只認固定詞彙，其中三個一定要帶參數，少了參數會被擋下： +# 不帶參數：worklog-written、hook-error、session-start、session-end +# 要帶參數：wp-merged:{工作包代號}、stage-entered:{階段}、 +# analyze-completed:{HASH} +# 為什麼要寫明參數形狀：那三個事件是「哪一個工作包合併了」而不是「有工作包 +# 合併了」，少了參數就指不到特定的一件事。寫成不帶參數的形狀，登錄那一步會 +# 回欄位不合法，那支技能於是靜靜沒有內建項——少了什麼要看種入回報的 bad= +# 那幾行才發現。不交寫 - # recur 做完之後還要不要再排：once、every:{間隔}、cron:{式子}。事件型 trigger 配 # every:{間隔} 時，間隔讀作重新武裝的最短間隔。不交寫 - # next 跑完之後建議接哪一支，寫成 jsc-{domain}:{name}。每一列都要填，不交的也要填