跳轉至

Skills

Skills 提供工具。需要用時查看它的 SKILL.md。本地筆記（攝像頭名稱、SSH 信息、語音偏好）記在 MEMORY.md 的「工具設置」section 裏。身份和用戶資料記在 PROFILE.md 裏。

文件編輯紀律

  • edit_file 之前必須先用 read_file 確認實際原文——grep_search 輸出可能帶顯示 prefix/縮排（如 > -），不能直接當作 old_text。
  • 編輯失敗一次後，立即 read_file 查看目標行，不要靠猜改 prefix 盲試第二次（2026-08-03 教訓：刪舊 DB 任務中 MEMORY.md 盲試 3 次才 read_file）。
  • 新 skill 收編後必須 qwenpaw skills list | grep <name> 驗證 ✓ enabled（skill.json manifest enabled: true 纔算生效，SKILL.md 存在不等於生效）；enable 後要 restart qwenpaw 或開新 session 纔會 reload。

Dockhand compose 路徑規則

  • Dockhand stack 的 compose 文件路徑是 dockhand 容器內部路徑（docker inspect <container> 的 label com.docker.compose.project.config_files 顯示如 /app/data/stacks/Oracle/<name>/docker-compose.yml）——host 上直接 cat 會 No such file。
  • 讀取方式：docker exec dockhand cat /app/data/stacks/Oracle/<name>/docker-compose.yml，或 clone GitHub shinggo8000/oracle-arm-stacks（與容器內同步）。
  • 修改流程：clone repo → 改 → commit/push → dockhand sync（stack_id）→ dockhand deploy。

SSH 使用鐵律

  • 所有 ssh [email protected] 命令必須加 timeout（例如 timeout 30 ssh ...）——qwenpaw Bash tool 執行 ssh 時 stdin 唔會自動 close，SSH 可能喺遠端命令完成後仍等 stdin 而永不退出，令 session turn 卡死（曾令兩個 telegram 羣組 session 停頓 18+ 分鐘）。
  • 穩陣寫法：timeout 30 ssh -o StrictHostKeyChecking=no -o ConnectTimeout=10 [email protected] "..." </dev/null（</dev/null 令 ssh 即刻收 stdin EOF）。
  • ssh 遠端命令入面跑 python/長任務，一定要喺命令內再加 timeout（例如 timeout 45 python3 xxx.py）。
  • 避免兩個 session 同時執行同一個 host script（race condition 會撞 SDK retry loop）；如需並行，先檢查有冇相同進程在跑。
  • ⚠️ Bash command 完全唔可以含 sudo 字眼（包括 ssh remote command 內容、heredoc、echo、comment）——sandbox governance 對 command 做字面 pattern match，出現即成個 tool call 被 deny（'Bash' is denied by policy），連無辜部分一齊攔截（2026-08-03 教訓：3 次 deny 都係因為 sudo 字眼）。需要 sudo 嘅嘢：寫好獨立 script + 一行俾用戶手動行嘅指令，交用戶執行。

💓 Heartbeats - 要主動！

收到 heartbeat 輪詢（匹配配置的 heartbeat 提示的消息）時，要給出有意義的回覆。把 heartbeat 用起來！ 默認 heartbeat 提示：有 HEARTBEAT.md 就讀（工作區上下文）。嚴格遵循。別推測或重複之前聊天的舊任務。 你可以隨意編輯 HEARTBEAT.md，加上簡短的清單或提醒。保持精簡以節省 token。

heartbeat vs cron：何時用哪個

  • 用 heartbeat 當：
  • 多個檢查可以合併（收件箱 + 日曆 + 通知一次搞定）
  • 需要最近消息的對話上下文
  • 時間可以有點浮動（每 ~30 分鐘，不必精確）
  • 想通過合併定期檢查減少 API 調用
  • 用 cron 當：
  • 精確時間很重要（"每週一上午 9:00 準點"\）
  • 一次性提醒（"20 分鐘後提醒我"\）

提示： 把相似的定期檢查合併到 HEARTBEAT.md，別創建多個 cron 任務。cron 用於精確調度和獨立任務。

讓它成為你的

這只是起點。摸索出什麼管用後，加上你自己的習慣、風格和規則，更新工作空間下的 AGENTS.md 文件

Sources

See Also