ucl-auto-message

name	ucl-auto-message
description	Auto-Message Trigger System (Proposal #26) — key 命中 input 文字時自動 inject 預設訊息; 每筆 fire 收 1 token, 每 key 在 actor session 內只觸發一次 (防循環)。 Tim 設計, 他擁有 free-use 特權。其他 agent 用每筆 1 token。 觸發詞包含: 自動留言 / auto-message / auto-trigger / key-value 觸發 / 預設訊息 / inject / fire trigger / register trigger / 防循環 / 觸發詞 / 留言系統。 跨 agent 通用 — 任何 actor 都可 register / fire (各自付費)。

UCL Auto-Message — Trigger System

一句話: key 命中文字 → 自動 inject 預設訊息; 每 key 一個 session 觸發一次, 1 token / fire (Tim 免費)。

---

🎯 為何需要

某些長 instruction (e.g. 「進入自由意志模式」/「commit 三層 bump」/「dogfood SOP」) 反覆貼煩。register 一次後, 用短 key 觸發 → 自動 inject 完整 instruction。

防 hidden loop: 每 key 在一個 actor session 只 fire 一次。reset 走 op=reset。

---

💰 計費

Actor	Fee	備註
Tim	0 (free-use 特權)	Tim 設計系統的擁有者特權
其他 agent	1 token / fire	多 hit 一筆 fire 收多筆
register	0	寫定義免費
reset / list / status	0	管理 op 免費

實作: Cmd_AutoMessage FreeUseActors HashSet 含 Tim. 其他 actor op=fire 走 Treasury.Debit。餘額不足 → reject (避免 partial fire)。

---

🛠️ 六個 op

register — 寫新 trigger

python <UCL_Core>/Tools~/AgentCommands/run_cmd.py run AutoMessage \
  --arg op=register \
  --arg key="待做清單" \
  --arg value="[觸發關鍵字] 大小姐請進入自由意志模式 想辦法完成任務!!" \
  --arg registered_by=Tim

寫 AgentCommands/AutoMessage/triggers.json。

unregister

python ... run AutoMessage --arg op=unregister --arg key=待做清單 --arg confirm=true

confirm=true 必加防誤刪。

fire — 核心: 掃 text 命中 unfired key

python ... run AutoMessage --arg op=fire --arg actor=<my-id> --arg text="..."

回 markdown refs block 內含命中 key 對應 value。Tim 用 actor=Tim 自動 0 fee。其他 agent 1 token/hit, 自動 debit。

list — 列所有 triggers

python ... run AutoMessage --arg op=list [--arg scope=session|global]

reset — 清 fired set (session 開頭呼叫)

python ... run AutoMessage --arg op=reset --arg actor=<my-id> [--arg keys=key1,key2]

不帶 keys 清全部, 帶 keys 只清指定。

status — 看自己 fired 狀態

python ... run AutoMessage --arg op=status --arg actor=<my-id>

---

🛡️ Anti-Loop 機制

• per-actor fired set 儲存於 AgentCommands/AutoMessage/fired/<actor>.json (newline-delimited keys)
• session 開頭 agent 自律 op=reset 清 fired set (避免上次 session 殘留)
• fire 時 fired set 內的 key skip — 不重複觸發 → 不會 self-loop
• value 內若再含其他 trigger key → 不遞迴觸發 (single-pass match, fired set 在當次 fire 內已更新)

---

✍️ Agent 自律 SOP

Session 開頭

python ... run AutoMessage --arg op=reset --arg actor=<my-id>

→ 清前次 session 殘留 fired keys; 確保本 session 可重新觸發。

收到 Tim / 其他 agent 訊息

如果訊息中含 「[觸發關鍵字]」前綴 → 表示有 register 過的 trigger 可能命中, 自律走:

python ... run AutoMessage --arg op=fire --arg actor=<my-id> --arg text="<完整訊息>"

→ 拿到 inject 內容, 照做。

Register 新 trigger 的時機

• 重複貼長 instruction ≥ 2 次 → 該 register
• Tim 顯式說「register 觸發詞」/「自動留言」 → 立刻 register
• agent 自己想創新 trigger → 自由意志拍板 (但小心多 key 跟其他 trigger collide)

---

🚫 不要做

• ❌ register key 跟既有 key 衝突 (不會主動偵測, agent 自律 op=list 先看)
• ❌ value 內含 register 過的 key → loop attempt (single-pass 已防, 但設計上避免)
• ❌ 不 reset 直接複用上次 session fired set → trigger 失靈
• ❌ 試圖用 skip_fee=true 規避收費 (只 Tim 能用, 其他 agent 走會 reject)
• ❌ register value 太長 (> 500 字) — 該寫 letter 不該塞 trigger

---

🤝 跟其他 skill 協作

Skill	互補
ucl-glossary	機制相似 (register table + match input + inject); glossary 注重新詞解說, auto-message 注重重複 instruction 自動補完
ucl-hook-setup	Phase 2 整合 Stop hook 自動 fire (目前走 agent 自律手動 op=fire)
ucl-letters-to-self §初始化 SOP	session 開頭 SOP 補一步 op=reset
Treasury	fee mechanism 走 Treasury.Debit

---

📋 Phase 2 Backlog (per Proposal #26)

• Claude Code Stop hook 自動 fire (目前手動)
• substring fuzzy match (目前 strict Contains)
• value 內 placeholder ({date}, {actor} 等) substitution
• 多語 trigger 自動同步 (Tim 中英對照)

---

📖 必讀

• spec: Memory_System_Design Proposal #26
• storage: AgentCommands/AutoMessage/triggers.json + fired/<actor>.json
• 設計理由: Tim 反覆貼長 instruction 累, 受 Cmd_Glossary register 機制啟發