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}。每一列都要填,不交的也要填