119 lines
5.9 KiB
Python
119 lines
5.9 KiB
Python
"""Message templates for kuri-memory-guard — soft/hard block guidance."""
|
||
|
||
# ── Action-specific intro prefixes ─────────────────────────────────────
|
||
# Prepended to non-length soft messages to differentiate add vs replace.
|
||
_MSG_ADD_INTRO = "〔add〕"
|
||
_MSG_REPLACE_INTRO = "〔replace〕"
|
||
|
||
# ── Shared soft block template ────────────────────────────────────────
|
||
# Used by all non-length soft guards (work_verb, user_quote, cron_session, meta).
|
||
_MSG_SOFT_TEMPLATE = """\
|
||
〔SOFT BLOCK:需要重新判斷,不是最終拒絕〕
|
||
命中 guard:{guard_name}
|
||
觸發片段:「{matched_text}」
|
||
|
||
不得只因收到本訊息就停止。現在必須採取以下其中一項:
|
||
|
||
A. 內容仍含 transcript、事故敘事、短期狀態、測試內容或低密度背景:
|
||
改寫後立即再次呼叫 memory。
|
||
|
||
B. 內容已經是單一、穩定、高密度、未來可直接使用的規則或偏好:
|
||
在允許的 retry 時間內,原封不動重送完全相同的 operation;系統將放行一次。
|
||
|
||
C. 確認內容沒有 future reader,確實不值得保存:
|
||
放棄寫入,但必須在當前回覆明確說明原因;不得默默停止。
|
||
|
||
{guard_specific_note}"""
|
||
|
||
# ── Guard-specific notes ───────────────────────────────────────────────
|
||
_MSG_USER_QUOTE_NOTE = (
|
||
"此 guard 擋「主人說/主人回/主人要求」這類轉述開頭。"
|
||
"改寫重點:留下事實與規則,把「主人」拿掉——"
|
||
"「主人要求以 Codex 審查時 scope 嚴格限制」改成"
|
||
"「以 Codex 審查指定 skill 時,scope 嚴格限制在該 skill 及其 references」。"
|
||
"變成自己對自己說的規則,不是轉述主人的話。"
|
||
"改寫後重送;只有改寫會破壞語意的精確規則才原樣重送(B)。"
|
||
)
|
||
|
||
_MSG_WORK_VERB_NOTE = (
|
||
"此 guard 用來防止當前進度、已完成工作、PR/issue 與下一步被寫入。"
|
||
"若內容是在描述通用條件或長期操作原則,選擇 B。"
|
||
)
|
||
|
||
_MSG_CRON_SESSION_NOTE = (
|
||
"此 guard 用來防止 cron 執行結果、平行 session 紀錄、trigger 與 coverage 殘留。"
|
||
"只有長期固定的操作規則可以選擇 B。"
|
||
)
|
||
|
||
_MSG_META_NOTE = (
|
||
"此 guard 用來防止 cleanup 反省、版本快照及可從 canonical source 重取的內容沉澱。"
|
||
"若內容本身是未來要遵守的規則,而不是來源內容的複製,選擇 B。"
|
||
)
|
||
|
||
# ── Length guard messages ──────────────────────────────────────────────
|
||
# S1 — refine threshold (80 chars)
|
||
_MSG_LENGTH_S1 = """\
|
||
〔SOFT LENGTH:80 字精煉檢查〕
|
||
本條共 {n} 字。不得直接放棄。
|
||
|
||
模型自行擬定:刪除對話背景、原因、事故經過、道歉與推論,只留下未來可直接使用的一條規則,然後再次呼叫 memory。
|
||
|
||
主人提供或逐字核准,且壓縮會改變語意:原封不動重送一次。
|
||
|
||
若沒有 future reader,明確說明後放棄;不得默默停止。"""
|
||
|
||
# S2 — split threshold (120 chars)
|
||
_MSG_LENGTH_S2 = """\
|
||
〔SOFT LENGTH:120 字拆分檢查〕
|
||
本條共 {n} 字。判斷是否包含兩個以上可獨立檢索、修改或使用的規則。
|
||
|
||
是:拆成多筆後再次呼叫。
|
||
否:若已是不可拆的單一規則,原樣重送一次。
|
||
不得只因本訊息停止寫入。"""
|
||
|
||
# S3 — document/narrative threshold (150 chars)
|
||
_MSG_LENGTH_S3 = """\
|
||
〔SOFT LENGTH:150 字文件/敘事檢查〕
|
||
本條共 {n} 字,高度疑似 SOP、事故報告、對話摘要或多條規則。
|
||
|
||
抽出一條短規則、拆成多筆,或改放 skill/docs。
|
||
只有確定是單一且無法安全縮短的精確規則,才原樣重送一次。"""
|
||
|
||
# ── Hard ceiling message ───────────────────────────────────────────────
|
||
_MSG_HARD_CEILING = """\
|
||
〔HARD BLOCK:180 字絕對上限〕
|
||
本條共 {n} 字。原樣重送不會放行。
|
||
|
||
拆成多條短記憶、只抽取核心規則,或改放 skill/docs。
|
||
若是對話摘要、事故經過或工作紀錄,放棄寫入。"""
|
||
|
||
# ── Date hard block ────────────────────────────────────────────────────
|
||
_MSG_DATE_HARD = """\
|
||
〔HARD BLOCK:日期或疑似日期〕
|
||
觸發片段:「{matched}」
|
||
|
||
日期與相對時間不得寫入長期記憶,原樣重送不會放行。
|
||
如果這其實是比例、全天候或其他非日期表示,請改成不含日期形狀的等價寫法後重新送出,例如 16:9、全年全天候。"""
|
||
|
||
# ── Placeholder hard block ─────────────────────────────────────────────
|
||
_MSG_PLACEHOLDER = """\
|
||
〔HARD BLOCK:暫存/測試內容〕
|
||
觸發片段:「{matched}」
|
||
|
||
TODO、placeholder、temp、probe、WIP、session note、proc session ID、commit SHA——
|
||
這些都是短期記號,不是長期記憶,沒有 future reader。
|
||
請移除這類內容後再試。
|
||
|
||
{list_warning}"""
|
||
|
||
_MSG_LIST_WARNING = (
|
||
"如果你是在用 add 測試或嘗試列出現有記憶:停止此操作。\n"
|
||
"memory tool 不支援 list;add 不會回傳既有條目。\n"
|
||
"非沙箱 agent 應直接讀取 memories/MEMORY 與 USER.md;沙箱 agent 無法取得完整清單。"
|
||
)
|
||
|
||
# ── Batch block message parts ──────────────────────────────────────────
|
||
_MSG_BATCH_HEADER = "批次記憶操作中有多筆內容命中防護:"
|
||
_MSG_BATCH_FOOTER = (
|
||
"\n\n批次操作無法透過原樣重送繞過。請拆成單筆操作重新處理;每筆可以各自使用 soft retry 協議。"
|
||
)
|