~/教學/EVOLVE.md

文章 / Claude Code

Task Observer:讓 Claude Code 記下你每次的糾正,整理成 skill 改動,你同意才改(免費)

Task Observer 是免費的 Claude Code skill(CC BY 4.0):你糾正 Claude 時它寫一筆觀察,約一週找你複查,你同意才改 skill。附安裝、啟動區塊、複查 prompt 和注意事項。

Claude Code 一直犯同一個錯?講過的事,開新對話又忘了。Task Observer 是一個免費的 Claude Code skill:你每次糾正 Claude,它就寫下一筆觀察,大約一週找你複查一次,你同意的改動才會進你的 skill。這篇是 Reels 裡 EVOLVE 那支影片的完整版:它到底做什麼(老實說它不是會自己進化的 AI)、怎麼安裝、怎麼真的啟動、一筆觀察長什麼樣、複查怎麼同意或拒絕,以及要注意的地方。

01先搞懂:為什麼 Claude 一直犯同一個錯,Task Observer 又做了什麼

你一定遇過:跟 Claude Code 說了「不要再用 var」,這個對話裡它乖乖照做,開了新對話又用回 var。原因很單純:新對話不會記得上一個對話裡的糾正,除非那句話被寫進它每次都會讀的地方,例如 CLAUDE.md、skill 或專案記憶。

Task Observer 就是負責「寫下來」的那個 skill。它是 Eoghan Henn(rebelytics)做的免費 skill,授權是 CC BY 4.0。啟動之後它在旁邊看你工作:你每次糾正 Claude、表達偏好、或發現某個 skill 沒涵蓋的狀況,它就寫一筆「觀察」成一個小檔案。累積一陣子,它會找你一起複查,把觀察整理成 skill 的改動,你同意了才算數。

Task Observer 的 GitHub README:「This meta-skill has logged over 1,900 observations across my 84 skills」,加粗
作者 README 上的數字:他自己用它記了 1,900 多筆觀察、84 個 skill。這是作者自己的數字,不是我測的。

照著這篇做完,你會得到這些:

  1. 一個裝好、而且真的會在每個新對話自動啟動的 Task Observer(很多人只做到「裝好」,卡在沒啟動)。
  2. 每次糾正都留下一個檔案:出了什麼錯、建議怎麼改、可以通用的原則。
  3. 大約一週一次的複查:它把觀察整理成 skill 改動,一筆一筆問你同意還是拒絕。
  4. 重複在做的工作會被標成「新 skill 候選」,不用從空白頁開始寫 skill。
  5. 幾段可以直接貼給 Claude 的 prompt:幫你貼啟動區塊、對話結束時查有沒有新觀察、馬上跑一次複查。

02第 1 步:一行指令安裝

README 的 Quick install:第 1 點是 npx skills add 安裝指令,第 2 點寫 Installing alone is not enough
README 的 Quick install:第 1 點是安裝,第 2 點是啟動。第 2 點最常被跳過。

最快的裝法是終端機一行指令。它用的是 Vercel 的 skills 命令列工具(不是 Anthropic 官方的),所以電腦要先有 Node.js。

  1. 沒有 Node.js 的話,先到 nodejs.org 裝好。
  2. 終端機切到你的專案資料夾,貼下面這行:只裝在這個專案。
  3. 想讓所有專案都能用,就在最後加 -g。
  4. 用 Claude App(網頁、桌面、手機、Cowork)的人:到 GitHub 的 Releases 下載 task-observer.skill,在 Settings → Customize 上傳。
  5. 想手動裝:把 SKILL.md、references/、scripts/ 一起放進 .claude/skills/task-observer/,資料夾結構不要拆開。
安裝(終端機,只裝這個專案)
npx skills add rebelytics/one-skill-to-rule-them-all --skill task-observer
安裝(終端機,所有專案都能用)
npx skills add rebelytics/one-skill-to-rule-them-all --skill task-observer -g

03第 2 步:啟動:把啟動區塊貼進 CLAUDE.md(或裝 hook)

這步最重要。README 寫得很直接:「Installing alone is not enough」,只裝不啟動,它常常不會自己跑起來。原因是 Claude 靠 skill 的描述判斷要不要用它,而一個「在旁邊看」的 skill 很少被主動叫到。所以要在 CLAUDE.md 放一段固定的啟動區塊,讓每個新對話一開始就先載入它。

  1. 打開已安裝的 task-observer 資料夾裡的 references/environments.md(GitHub 上也看得到),找到「The activation block」這一段。
  2. 整段照抄,從第一行 (task-observer activation block — template of v3.9.0) 開始,不要自己改寫或縮短。
  3. 貼進 CLAUDE.md:只用在這個專案就貼專案根目錄的 CLAUDE.md;用 -g 裝在所有專案的話,貼使用者層級的 ~/.claude/CLAUDE.md。
  4. 把方括號換掉:[ABSOLUTE PATH] 是存觀察的固定資料夾(不要放在 git worktree 或暫存資料夾,刪掉就跟著不見);<skill directory> 是 task-observer 安裝的資料夾;[PROJECTS ROOT] 是你放專案的資料夾。
  5. 區塊裡有一行 [UPSTREAM CHECK: …]:刪掉它,複查就完全不連網。

區塊大概一百行,手動填容易漏。我的做法是請 Claude 照抄、填好,先給我看再存:

請 Claude 幫你貼啟動區塊([]換成你的)
幫我啟動 task-observer skill:
1. 打開已安裝的 task-observer 裡的 references/environments.md,找到「The activation block」,整段照抄,不要改寫、不要摘要。
2. 照同一個檔案「Anchoring the workspace」的說明,幫我選一個固定的工作區路徑填進 [ABSOLUTE PATH],不要放在 git worktree 或暫存資料夾裡。<skill directory> 填 task-observer 的安裝位置,[PROJECTS ROOT] 填 [我放專案的資料夾],[RUN OUTPUT PATHS] 填 none,[UPSTREAM CHECK: …] 那一行刪掉。
3. 要寫進 [這個專案的 CLAUDE.md/~/.claude/CLAUDE.md]。
寫入之前,先給我看完整的區塊和檔案路徑,等我說可以再存。

另一個選擇是 hook。CLAUDE.md 的指令 Claude 還是有可能跳過;environments.md 的「A session-start hook」那一段附了一個 Claude Code 的 SessionStart hook 腳本,每個對話開始時把「先載入 task-observer」和目前有幾筆未處理的觀察塞進對話。作者說這是唯一「強制」的做法。用 Windows 的話,同一段提醒要用 Git Bash 的完整路徑註冊 hook。

最後確認它真的有啟動:

  1. 存好 CLAUDE.md 之後開一個新對話。剛剛安裝的那個對話證明不了什麼。
  2. 新對話照常工作,不要提到 task-observer,否則是你手動叫它,不算。
  3. 工作幾次之後,看工作區裡有沒有出現 skill-observations/observation-log/ 資料夾。沒有,就是沒啟動。
  4. 有的話,打開 skill-observations/checkpoints.log,最後一行「session-start scan」的日期就是它最後一次啟動的那天。

04第 3 步:一筆觀察長什麼樣,每週複查怎麼同意或拒絕

references/observation-log.md 的 Layout:skill-observations/ 底下的 observation-log/、archive/、reviews/、checkpoints.log
官方的資料夾結構:observation-log/ 裡一筆觀察一個檔案(0001-short-slug.md、0002-…)。

它寫的東西都在你的工作區裡,全是一般的 Markdown 和文字檔,打開就看得懂:

  1. skill-observations/observation-log/:一筆觀察一個檔案,檔名是 NNNN-slug.md,例如 0001-stop-using-var.md。處理完的會移到 archive/。
  2. skill-observations/cross-cutting-principles.md:不只跟一個 skill 有關的通用原則。
  3. skill-observations/checkpoints.log、last-review-date.txt:它自己記帳用的,上次啟動、上次複查是哪天。
  4. skill-observations/reviews/:每次複查留一份紀錄。
  5. skill-updates/:複查後改好的 skill 暫存在這裡,還沒安裝。
SKILL.md 第 521 到 529 行:Issue、Suggested improvement、Principle 三個欄位的範本
SKILL.md 裡的觀察範本:每筆都是 Issue(出了什麼錯)→ Suggested improvement(建議怎麼改)→ Principle(通用原則)。

每個觀察檔案上面是一段 YAML 標頭:標題、狀態(status: open 代表還沒處理)、跟哪個 skill 有關、要不要建議做新 skill(proposes_skill)、日期。下面是三段內文:Issue、Suggested improvement、Principle。作者說 Principle 是最重要的一欄,因為它是能套用到下次的那句話。

複查怎麼開始:每個對話開頭它會檢查,如果上次複查是 7 天以前(或從來沒複查過),而且有未處理的觀察,它會用一句話問你要不要現在複查。你可以說好,也可以說先做事,它不會擋住你的工作。

README 段落:The observer doesn't modify your installed skills. In an interactive review you approve each change…
README 寫明:它不改你已安裝的 skill;互動複查時每個改動都要你同意,改好的版本要你安裝才生效。

複查時它會把未處理的觀察對照你的 skill,提出具體改動。你同意的,它把改好的 skill 放到 skill-updates/ 暫存;你拒絕的,那筆觀察標成 declined。全部看完,你再自己把暫存的版本裝回去,新規則才真的生效。不想等它問,也可以直接叫它跑:

馬上跑一次複查
用 task-observer 現在跑一次複查:
- 列出 observation-log 裡所有 status 是 open 的觀察,照 skill 分組;
- 每一筆用一句話說:出了什麼錯、建議怎麼改;
- 一筆一筆問我:同意、拒絕,還是下次再看;
- 同意的改動只放進 skill-updates/ 的暫存副本,不要動我已安裝的 skill;
- 最後告訴我暫存的版本要怎麼安裝。

作者自己的習慣是每個對話快結束時問一句「Any observations logged?」,有時它會因此多找到漏記的。我把它改成這樣用:

對話結束前查有沒有新觀察
這次對話有記下任何觀察嗎?列出觀察的編號和標題。如果一筆都沒有,就把我這次的每一次糾正列出來,各用一句話說明為什麼不算觀察。
看看有哪些「新 skill 候選」([]換成你的)
看一下 observation-log 裡 proposes_skill 不是空的觀察,列出建議的新 skill:名稱、要做什麼、根據哪幾筆觀察。先不要建立任何 skill。我最常重複做的事是 [例如:每週整理客戶回饋成報告],順便看看有沒有相關的觀察。

05要注意

  1. 一定要啟動:只裝不貼啟動區塊(或不裝 hook),它常常不會自己跑。幾次對話後還沒有 skill-observations/observation-log/,就是沒啟動。
  2. 它不會自己改已安裝的 skill。平常只記錄;只有在複查、你明確叫它改某個 skill、或某個 skill 正在產生錯誤結果時才會動手,而且改好的版本先放 skill-updates/,要你自己安裝。
  3. 有成本:啟動區塊讓每個對話一開始都載入整份 SKILL.md(約 750 行)再跑啟動檢查,會多用一些 token。作者也老實說,skill 很少的小型設定,用 Claude 內建的記憶可能就夠了。
  4. 檔案放哪裡:觀察存在你在啟動區塊指定的工作區。Claude Code 裡建議用固定的位置,例如 ~/.claude/projects/<專案 id>/,或所有專案共用的 ~/.claude/skill-observations/。不要放在 git worktree 裡,worktree 一刪觀察就跟著不見。
  5. 我的建議(非官方):如果你把工作區設在專案資料夾裡,又不想把觀察 commit 上去,就把 skill-observations/ 和 skill-updates/ 加進 .gitignore。觀察裡可能寫到專案細節;想用 git 保存的話,官方文件也有寫怎麼做。
  6. 授權是 CC BY 4.0:可以免費使用、修改、甚至商用,但要標明出處:附上原始 repo 連結,寫出作者 Eoghan Henn / rebelytics.com。這是創用 CC 授權,不是一般的軟體開源授權;「開源」是作者自己的說法。
  7. 在 Claude 網頁版或手機 App 裡沒有檔案系統,它改成在對話最後給你一份交接文件(handoff doc),要你自己帶去另一個對話更新 skill。
  8. 作者 README 的「1,900 多筆觀察、84 個 skill」是他自己的數字。這個專案沒有付費方案,也沒有贊助按鈕。
  9. 以上是 2026 年 11 月 5 日照 v3.9.0 的官方檔案整理,版本更新很快,以 GitHub 為準。
  10. 這篇是在主頁連結輸入關鍵字 EVOLVE 找到的,不會私訊。

資料來源

延伸閱讀