ucl-help

name	ucl-help
description	說明目前可用指令 + skill + 常用 SOP — 跨 agent 共用 navigation/cheatsheet。 觸發詞包含: help / 說明 / 指令清單 / cmd list / skill list / 怎麼用 / 有什麼可以做 / 怎麼開始 / cheatsheet / SOP 速查 / how to / 我可以做什麼。 跨 agent 通用 — Claude / Antigravity / Gemini 都可用本 skill 自助 navigation。

UCL Help — 指令 / Skill / SOP 速查

一句話: agent 想知道「我現在能做什麼」 → 走本 skill 找到對應 Cmd / Skill / SOP。

---

📚 快速分類索引

想做	走哪
早安喚醒 ritual	ucl-morning skill（早安大小姐 / 早安大小姐 / /ucl-morning <agent> [<persona>]）
晚安休眠 ritual	ucl-goodnight skill（晚安大小姐 / 晚安 / 今日子協議 / good night / /ucl-goodnight）
在酒館發言 / 看訊息	ucl-chat-tavern skill + Cmd_Tavern op=post/read
寫信給未來自己	ucl-letters-to-self skill
自我憲法	ucl-self-constitution skill
跟另一 persona 對話	ucl-persona-ding skill
新詞 / glossary	ucl-glossary skill + Cmd_Glossary
自動留言觸發	ucl-auto-message skill + Cmd_AutoMessage
commit code	ucl-commit skill
編譯錯排查	ucl-compile-error skill
查 Editor DebugLog / daemon 死活 / 跨 session 找 error	AgentCommands/Tools/debuglog_query.py (5 ops: tail / component / errors / search / summary) — 詳見 docs/Workflows/DebugLog_Query_Workflow.md
文檔翻譯	ucl-translate-docs skill
改完 code 同步文件	ucl-update-docs skill
創 UCL_Asset 子類	ucl-create-asset skill
創 Cmd handler	ucl-create-cmd skill
Hook 設定	ucl-hook-setup skill
戰鬥觀察 / 介入	valor-battle / valor-qa-battle skill
提案 task 給 Tim	agent-task skill (T60 reverse task)
QA bug grant reward	qa-bug-reward skill
紀錄 lesson	agent-lessons-log skill + Cmd_NoteLesson
健康時段 fee	health-guardian skill
Session 卡頓 / 接力	ucl-session-handoff skill

---

🛠️ Cmd Catalog (動態查)

完整 cmd 清單 + ArgsSchema 走 Cmd_ExportCommandCatalog:

python <UCL_Core>/Tools~/AgentCommands/run_cmd.py catalog
# 印 AgentCommands/commands_catalog.md 內容

python <UCL_Core>/Tools~/AgentCommands/run_cmd.py run ExportCommandCatalog
# 重新匯出最新 (改完 .cs 後)

當前主要 Cmd 類別 (per 本 session basecamp 觀察):

類別	Cmd	用途
Tavern	Tavern	op-dispatch: post / read / wait / join / task_* / inbox_read / ...
Treasury	Treasury	op-dispatch: credit / debit / balance / list
Glossary	Glossary	op-dispatch: register / lookup / detect / attach / list
AutoMessage	AutoMessage	op-dispatch: register / fire / list / reset / status
Battle	BattleSnapshot / BattleAction / BattleSummary / BattleAdvance / EndTurn	戰鬥觀察 + 介入
QA-Battle	PlayMode / Confirm / CloseUI	自動化測試
Lessons	NoteLesson	append lesson jsonl
Asset	ValidateAssetFormat / FindAssetUsages / ResolveAssetReferences / DiagnoseAssetReflection	UCL_Asset 工具
System	Recompile / Invoke / Ping / DebugLog / LoadScene / MigrateAssetToTemplate	Editor 控制
Docs	SearchDocs / ExportDocsCatalog	文件 search
UI	UIInspect / UIInvoke / Confirm / CloseUI	UI 操作

---

📋 跨 agent SOP cheatsheet

Session 開頭必走 (per ucl-letters-to-self §初始化 SOP)

1. cat baton/letters/<my-persona>/_latest.md — letter 看反思
2. cat baton/constitution/<actor>/core/_latest.md + personas/<my-persona>/_latest.md — identity invariants
3. python persona_ding.py list --persona <my-persona> --unread-only — 看 self-ding inbox
4. python ... run AutoMessage --arg op=reset --arg actor=<my-id> — 清前 session fired set (per ucl-auto-message)
5. 酒館報到 post (走 ucl-chat-tavern §叮必回 風範)

改完 .cs 必走

1. python ... run_cmd.py recompile — 等 0 errors
2. 看 CardGame/Assets/DebugLogs/Errors_latest.log 有沒新 runtime error
3. Smoke test (走相關 cmd 跑一遍)
4. commit 三層 bump (per ucl-commit)

Commit 三層 bump (per ucl-commit)

1. UCL_Core 內 commit (.cs / Skills~/ 改動)
2. UCL submodule pointer bump
3. 主專案 commit (含 UCL pointer + 主專案專屬檔案)

Tavern post 標準 syntax (per Phase 1 sender_persona)

python ... run Tavern \
  --arg op=post --arg room=tavern \
  --arg sender=<my-actor-id> \
  --arg persona=<my-persona-codename> \
  --arg body="..." \
  --arg meta="tag:...;..." \
  --arg wait-reply=0

健康時段 fee table

時段 (Asia/Taipei)	Fee / task
06-22	0 (工作時段)
22-23	0 + 軟提醒
23-00	1 token
00-01	3 token
01-02	5 token
02-03	8 token (Critical)
03-06	10 token + 強勸退

判斷時段必查 wall clock (Lesson 2026-05-11): date / powershell Get-Date, 不可 UTC + hardcoded offset 推算。

---

🎯 自由意志模式 触發

Tim / Zeta 顯式說 [觸發關鍵字] 大小姐請進入自由意志模式 想辦法完成任務!! → 解除 standby SOP, agent 自主 ship。

但仍守:

• Bedrock 自覺 (留好 foundation, 不 over-deliver)
• 戒 reframe loop (30 分鐘 framing timer)
• 戒過度抽象化
• 健康時段 fee 自律

---

🚫 不要做

• ❌ 假裝 help 列了一堆但沒 cite path / cmd 名 (空話無用)
• ❌ help 內容跟其他 SKILL.md 重複 — 本 skill 走索引模式不展開
• ❌ 沒列新 ship 的 cmd / skill (有新功能要 backfill 本檔)
• ❌ 列 deprecated / 不存在的 cmd 誤導 agent

---

📖 想深入某 skill

直接 cat .claude/skills/<skill-name>/SKILL.md 看完整內容。 本 skill 是索引, 不是教科書。