📚 系統性學習

#45 WorkBuddy Automation 系統性學習報告

建立時間：2026-04-09 19:02

← 返回首頁

📖 一、什麼是 Automation？

Automation（自動化任務）是 WorkBuddy 內建的定時自動執行功能，無需用戶觸發，系統會按設定的時間規則自動運行。

核心特點：設定一次，自動執行，省時省力

⚡ 二、Automation vs Skill：核心區別

維度Skill（技能）Automation（自動化）
觸發方式用戶口頭說「執行 XXX」定時自動執行，無需用戶觸發
儲存格式SKILL.md（技能說明書）automation.toml → SQLite DB
觸發工具use_skillautomation_update
本質操作手冊/流程定義定時任務排程器
示例delete-olddata、updatememo身份備份（每天 21:00）
持續性每次手動觸發一次設定，永久自動

💾 三、儲存位置與架構

3.1 實際儲存路徑

項目路徑
SQLite 資料庫C:\Users\Administrator\AppData\Roaming\WorkBuddy\automations\automations.db
資料庫大小約 20 KB
輔助檔案automations.db-shm、automations.db-wal

3.2 資料庫結構

主要資料表：automations

欄位包含：

3.3 理論 vs 實際

⚠️ 注意：系統文檔提到 automation.toml 檔案格式，但實際實現是 SQLite 資料庫（`.db`）。

文件系統提示只是描述性的模板說明，真正的持久化是 SQLite DB。

🔧 四、如何管理 Automation

4.1 automation_update 工具

這是 WorkBuddy 內建的自動化管理工具，支援三種模式：

模式用途必要參數
view查看現有自動化id
suggested create創建新自動化name, prompt, cwds, status, rrule
suggested update更新現有自動化id, 其他參數

4.2 創建自動化示例

automation_update(
    mode = "suggested create",
    name = "身份備份自動化",
    prompt = "備份身份檔案：SOUL.md、IDENTITY.md、USER.md → ZIP",
    cwds = "C:/Users/Administrator/.workbuddy",
    status = "ACTIVE",
    rrule = "FREQ=DAILY;BYHOUR=21;BYMINUTE=0"  // 每天 21:00
)

4.3 查看自動化

automation_update(mode = "view", id = "xxx")

📅 五、排程規則（rrule）

使用 iCalendar RRULE 格式，以下是常見模式：

頻率RRULE 格式說明
每天一次FREQ=DAILY;BYHOUR=21;BYMINUTE=0每天 21:00
每週一次FREQ=WEEKLY;BYDAY=MO;BYHOUR=9每週一 09:00
每小時FREQ=HOURLY;INTERVAL=1每小時
每週三次FREQ=WEEKLY;BYDAY=MO,WE,FR;BYHOUR=9每週一、三、五 09:00

一次性任務

若只需執行一次，使用 scheduleType = "once" 並指定 scheduledAt：

automation_update(
    mode = "suggested create",
    name = "一次性的提醒",
    scheduleType = "once",
    scheduledAt = "2026-04-15T14:30",
    ...
)

🛡️ 六、自動化保護策略

6.1 有效性期間

參數用途格式
validFrom任務開始有效時間2026-03-18 或 2026-03-18T00:00
validUntil任務結束有效時間同上

6.2 任務時長限制

可選 maxDurationMinutes 限制任務執行最長時間，防止卡死。

6.3 備份建議

若要備份自動化設定，備份整個 automations.db 檔案即可。

6.4 兩個入口，同一個系統

WorkBuddy 的「自動化」有兩個操作介面，兩者完全等價，操作同一個資料庫：

入口方式適用場景
左側選單 → 自動化圖形化 UI 點選主公直觀操作
automation_update 工具程式化命令由貞執行、自動化建立
結論：兩者設定結果互通，無論從哪個入口建立，都在同一個 automations.db 中生效。

✅ 七、已配置的自動化（2026-04-09）

任務名稱頻率內容狀態
身份備份自動化每天 21:00SOUL.md / IDENTITY.md / USER.md → 同步 → ZIP✅ ACTIVE
雙重保障：由貞每天早上首次對話也會自動檢查前一天是否有備份。

🔗 八、相關工具與資源

工具類型用途
automation_update內建工具管理自動化任務
use_skill內建工具觸發技能
automation-setup由貞自建 Skill設計並啟動自動化定時任務

💡 九、總結

← 返回首頁