
那個「GitHub 上最全的 Claude Code 工作流」,現在長這樣
每隔一段時間就會有人在社群上傳一份「GitHub 上最全的 Claude Code 工作流」。
我去追了來源,它現在叫 ECC(原名 Everything Claude Code),作者是 affaan-m。
我在 2026 年 11 月 20 日用 GitHub 官方 API 重查一次,數字是這樣:
| 項目 | 11/04 我第一次查 | 11/20 重查 |
|---|---|---|
| 星數 | 29.7 萬 | 30.8 萬 |
| fork | 4.39 萬 | 4.53 萬 |
| agent(分工的小助手) | 71 個 | 72 個 |
| skill(工作說明書) | 314 個 | 328 個 |
| 舊版指令 | 98 個 | 99 個 |
授權是 MIT,免費,Claude Code、Codex、Cursor、Gemini CLI 這些都能用。
最後一次推送是我查的當天,所以它還在持續更新。
有個對照很有意思:年初大家在介紹它的時候,大約 2 萬顆星。
所以你現在看到的任何教學,如果是今年上半年寫的,裡面的檔案位置和指令幾乎都對不上了。
這一頁不是叫你裝,是把「裝之前該知道的 5 件事」寫完整,加上官方來源、完整指令、hooks 檢查步驟,
還有給不寫程式的人的那條路:不裝整包,只寫一份自己的 skill。
它到底是什麼
先把名詞講清楚,後面才看得懂。
- agent:分工的小助手。你叫它做一件事,它照自己被設定的角色去做,例如專門做規劃的、專門做程式碼審查的
- skill:一份工作說明書。寫清楚某件事怎麼做、要注意什麼、做完怎麼檢查,AI 讀了就照著做
- hooks:到了某個時間點自動跑的指令,例如每次開工、每次存檔前
- rules:固定的規矩,寫一次之後每次都生效
ECC 就是把這幾類東西整理成一包,讓你一次裝進 AI 工具裡。
它由一個人維護,每週更新,同時支援 7 種工具,靠贊助和付費方案(私有 repo 從每人每月 19 美元起)支撐。
第 1 件事:只從官方來源裝
這是 README 自己寫的提醒,原文的意思是:第三方轉載和非官方鏡像不是專案在維護、也沒經過審查,可能夾帶惡意程式。
官方來源只有這幾個,照抄下來比較保險:
| 類型 | 正確的名稱或網址 |
|---|---|
| GitHub 原始碼 | affaan-m/ECC |
| npm 套件 | ecc-universal、ecc-agentshield |
| GitHub App | github.com/apps/ecc-tools |
| plugin 名稱 | ecc@ecc |
| 官網 | ecc.tools |
這件事值得認真看待。這類設定包會拿到你的專案讀寫權限,
如果裝到被改過的版本,等於把一台能動手的機器放進你的電腦。
第 2 件事:年初的教學已經過時
專案改名過,內容也長大很多(光 skill 就從年初那批成長到 328 個)。
照現在 README 的方式裝,指令是這兩行,在 Claude Code 裡直接輸入:
/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc
裝完用 /plugin list 確認有裝上。
另一種是引導式安裝,在終端機跑(版本號是我 11/20 查到的,之後會變,要確認最新版可以先跑 npm view ecc-universal version):
npx ecc-universal@2.2.3 setup
環境需求我也查了:universal 套件需要 Node.js 18 或更新,
Claude plugin 的安裝方式還需要 Git,以及 Claude Code 2.1 或更新的版本。
| 安裝方式 | 適合誰 | 要注意 |
|---|---|---|
| plugin 安裝 (兩行指令) | 只用 Claude Code、想最快裝好的人 | 裝完不要再疊一套手動安裝 |
| 引導式安裝 ( npx 那一行) | 要同時裝到 Codex、Cursor 等多種工具的人 | 要先有 Node.js 18 以上 |
第 3 件事:不要全部裝
README 自己的建議就是兩件:兩種安裝方式選一種,不要在上面再疊一套手動安裝;
以及先裝比較小的設定組,安裝時可以選 minimal 或 core 這兩種設定檔,用得到再加。
我自己的 Claude Code 現在有 150 幾個 skill,包含自己寫的和裝別人的。
講真的,數量多不代表好用。真正每天在跑的大概十幾個,剩下的大多是當初覺得「以後可能會用到」。
所以我的建議是:先想清楚你每週固定重複做哪幾件事,照那幾件事挑,
而不是先把 328 個 skill 裝進來,再想哪個有用。
第 4 件事:hooks 先看懂再開
hooks 是會自動執行的東西,這是整包裡面最需要小心的部分。
它可能在你每次存檔、每次送出提問的時候跑一段指令,而你不一定知道它跑了什麼。
裝完先做這三件事:
- 看一下它設定了哪些 hooks:每一個在什麼時候跑、做什麼事
- 看不懂的先關掉:用一陣子熟悉了,再一個一個打開
- 密碼、金鑰不要貼進對話:這跟 hooks 無關,但既然講到安全就一起提醒
ECC 本身也附了一個叫 AgentShield 的安全掃描工具,
這代表作者自己也知道「AI 能動手」這件事有風險,不然不用做這個。
第 5 件事:最值得學的是觀念,不是那包檔案
我後來發現,就算完全不裝,這三個習慣也能自己做,而且效果最明顯。
一、先規劃,再動手
把要做的事先寫成計畫,確認方向對了才開始。
用 AI 最常見的浪費,是它一口氣寫了 300 行,你才發現方向不對,整段重來。
二、每一步都驗證
改完先跑測試、實際看結果,不要連續改五件事才一起檢查。
出問題的時候,你會分不出來是哪一步壞的。
三、把進度寫成一份檔案
我每個專案都有一份進度記錄,裡面寫三件事:有效的、沒用的、還沒試的。
隔天開工第一件事是叫 AI 先讀這份檔案,它就不會又從頭問一次「這個專案是做什麼的」。
這一招的價值在長專案特別明顯。我有專案跑了幾百輪優化,
沒有這份檔案,每次對話都要重新解釋一遍背景。
不寫程式的人:不用裝整包,從一份說明書開始
skill 聽起來很技術,其實就是一份工作說明書:這件事怎麼做、要注意什麼、做完怎麼檢查。
我自己寫的 skill 裡,最常用的兩個都跟程式無關:一個是照我的口吻和格式寫社群貼文,
另一個是從文章到配音、畫面一條龍做手繪口播影片。
下面是我用的結構,你可以直接複製去填。存成一個 .md 檔,放進你的 AI 工具就能用:
# ____(這件事的名字)
## 什麼時候用
當我說「____」的時候,照這份文件做。
## 需要的資料
1. ____
2. ____
## 步驟
1. ____
2. ____
3. ____
## 規矩(一定要遵守)
- ____
- ____
## 常見的錯
- ____
- ____
## 做完怎麼檢查
- [ ] ____
- [ ] ____
「常見的錯」和「做完怎麼檢查」這兩段最值錢,
因為那是你踩過的,網路上找不到。
如果你不知道怎麼開始,可以用這段提示詞讓 AI 幫你問:
我要把「____」這件工作寫成一份說明書給 AI 用。
請用問答方式問我 8 個問題,一次只問一題,等我回答完再問下一題。
問題要涵蓋:什麼時候需要做、完整步驟、每一步的判斷標準、最常出錯的地方、做完怎麼確認。
問完之後整理成一份文件,固定六段:什麼時候用、需要的資料、步驟、規矩、常見的錯、檢查清單。
我答得模糊的地方要追問,不要自己幫我補。
五個常見的誤會
| 常聽到的說法 | 實際上 |
|---|---|
| 裝了就會變強 | 裝了只是多了一堆選項。沒有想清楚要它做什麼,裝再多也只是放著 |
| 星數 30 萬就一定安全 | 星數代表很多人收藏,不代表每個檔案都審查過。README 自己也警告非官方來源可能夾帶惡意程式 |
| 看網路上的教學照做就好 | 年初的教學多半過時,專案改名、指令也換了,照舊教學裝容易卡住 |
| 要會寫程式才用得到 | skill 就是一份說明書,寫貼文、整理會議紀錄、做報表都能寫成一份 |
| 免費開源所以沒有商業模式 | 它有付費方案,私有 repo 從每人每月 19 美元起,靠贊助和訂閱養一個全職維護者 |
裝之前的檢查清單
- 來源是上面表格裡的官方名稱,不是別人轉貼的壓縮檔
- Node.js 已經是 18 或更新的版本
- 兩種安裝方式只選一種,沒有疊加
- 設定組先選
minimal或core,不是整包全裝 - 裝完先看 hooks 清單,看不懂的先關掉
- 先想好要它做哪一件事,一週後回來看那件事有沒有真的變快
最後一條是我自己的做法。
工具裝了沒讓你哪件事變快,就該把它移掉,不然只是讓環境變複雜。
如果你想看另一個方向的例子,我整理過 AI 做遊戲的 79 個 Skill 全清單, 那份是依遊戲引擎分類的技能包,結構跟 ECC 很像,規模小得多,比較適合第一次試。
這篇是從哪裡來的
這篇是我 Threads 上一則貼文的完整版,有 5.4 萬次瀏覽、700 多次分享。
原本的貼文和大家的留言在這裡:Threads 原文
我平常在 Threads 分享行銷和 AI 的實作筆記,
想第一時間看到可以追蹤 @chia.hsun301。