Skip to content

timhuang1204/work-observer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

Work Observer

一個長期運行的 Claude Code agent,背景紀錄你的工作事件,並在 14 天後自動產出 「哪些日常工作可以被 sub-agent 取代」的分析報告。

動機

Andrej Karpathy 在 2025 年〈Software Is Changing (Again)〉演講中指出一個關鍵:

LLM 自動化的是「你能驗證的事」。如果你的領域可驗證,你可以建自己的 RL 環境去 fine-tune;這個槓桿即使大廠忽略你的領域也仍然有效。

換言之,「可驗證 × 高頻 × 低判斷力含量」 是 agent 自動化的甜蜜區。

但要找出自己工作中哪些事符合這三個條件,光靠回想不夠—— 人類對自己時間的估計通常極不準確。需要的是真實的工作軌跡資料。

Work Observer 解決的就是「資料從哪來」的問題:

  • Phase 1(Day 1–14):一個專門的 Claude Code session 默默把所有事件結構化紀錄, 包含你的口述、你的 git/file 操作、以及你其他 Claude Code session 的工作軌跡
  • Phase 2(Day 15+):自動分析重複模式,產出 sub-agent 候選清單, 每個候選都附驗證方式與預估節省時數

換句話說,這個 prompt 本身不做你的工作; 它是用來產生其他能做你工作的 agent 的那個 agent。

與 Obsidian / PKM 的差別

兩者結構相似——都是本地 markdown、依賴累積、相信模式會浮現。 但方向是相反的:

維度 Obsidian / PKM Work Observer
終點 未來的你思考更好 未來的 agent 取代部分的你
基本單位 概念/想法(atomic note) 事件(timestamped event)
連結方式 雙向鏈結、湧現式 時間軸 + entity 計數,結構化
完成感 永不完成(evergreen) 有明確 Phase 2 milestone
主要消費者 你的眼睛(graph 瀏覽) 程式(pattern extraction)
哲學立場 把外部知識內化進你 把你的工作模式外化給 agent
失敗模式 收集焦慮、graph 漂亮但沒人讀 紀錄不全 → 分析失準

PKM 賭「人類大腦會在連結中產生洞見」; Work Observer 賭「重複模式可以被外包」。

兩者可共存——Observer 工作目錄可以放在 Obsidian vault 內, mobile 端也能用 Obsidian app 補紀錄。但建議不要在 daily log 寫 [[雙向鏈結]],這會干擾 Phase 2 的 pattern extraction; entity 連結交給 entities/ 下的檔案處理就夠了。

用法

前置準備

確保 <knowledge_base_path>(你打算讓 Observer 觀察的主要專案目錄)下至少有以下其一:

  • CLAUDE.md
  • MEMORY.mdmemory/ 目錄
  • TODO.md

這三份檔案會被當作 baseline 來源;不齊全也可以,缺的部分由你手動補。

啟動

mkdir -p ~/work-observer && cd ~/work-observer
claude

進到 Claude Code 後:

  1. 編輯 PROMPT.md## 配置 section 的欄位
  2. 整段貼入 session
  3. Agent 會自動掃描 <knowledge_base_path> 完成 baseline 採集
  4. 依提示補充程式碼/文件無法涵蓋的部分(人物、會議等)
  5. 之後每天有事開這個 session 講一句即可

第 15 天自動產出 Phase 2 報告於 patterns/analysis-{date}.md

進階:包成 Claude Code agent 定義檔

放到 ~/.claude/agents/work-observer.md 並加上 frontmatter:

---
name: work-observer
description: 長期工作觀察者;背景紀錄工作事件、Phase 2 產生 sub-agent 候選分析
---

之後 claude --agent work-observer/agent work-observer 直接切換, 不用每次重貼 prompt。

設計原則

  1. 不刪除既有紀錄:所有修正用 ~~strikethrough~~ 加新內容,保留原始軌跡
  2. 手動條目永不被覆蓋:使用者手動補的內容不受 baseline 同步影響
  3. 驗證導向:Phase 2 的 sub-agent 候選必須具備可驗證性,否則不收進候選
  4. 資料純度優於格式美觀:daily log 是給程式讀的,不寫 PKM 鏈結、不過度格式化
  5. 不替使用者決策:分析報告是「給你看的選項」,不是「你應該做的事」

Prompt

完整 prompt 主體請見 PROMPT.md

License

MIT License — 詳見 LICENSE

Contributing

歡迎透過 issue / PR 提出:

  • 新的預設類別建議
  • baseline 來源檔案的擴充模式(除了 CLAUDE/MEMORY/TODO 之外)
  • session 萃取的更佳啟發式
  • Phase 2 分析的新維度

About

長期運行的 Claude Code agent,背景紀錄 14 天工作軌跡,自動產出 sub-agent 候選分析。A long-running Claude Code agent that records your work for 14 days, then proposes which parts could be delegated to sub-agents.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors