🚀 圭話行銷 ATMarketingAI 實戰講師 × 企業 AI 內訓

快 31 萬顆星的 Claude Code 設定包 ECC:裝之前先看這 5 件事

商業案例·AI 應用 #Claude Code#AI 工作流#開源專案#資安
快 31 萬顆星的 Claude Code 設定包 ECC:裝之前先看這 5 件事

那個「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 萬
fork4.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 Appgithub.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 是會自動執行的東西,這是整包裡面最需要小心的部分。
它可能在你每次存檔、每次送出提問的時候跑一段指令,而你不一定知道它跑了什麼。

裝完先做這三件事:

  1. 看一下它設定了哪些 hooks:每一個在什麼時候跑、做什麼事
  2. 看不懂的先關掉:用一陣子熟悉了,再一個一個打開
  3. 密碼、金鑰不要貼進對話:這跟 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。

常見問題

ECC 是什麼,跟 Claude Code 有什麼關係?

ECC 原名 Everything Claude Code,是一個人維護的開源設定包,把 agent(分工的小助手)、skill(工作說明書)、hooks(自動執行的指令)和 rules(固定規矩)整理成一包,讓你一次裝進 AI 工具。它不只支援 Claude Code,Codex、Cursor、Gemini CLI 這些也能用。

網路上的教學為什麼都裝不起來?

因為專案改名也長大了。年初大家介紹它的時候約 2 萬顆星,現在 30.8 萬顆,光 skill 就有 328 個,檔案位置和指令都換過。照現在 README 的方式裝才會對:在 Claude Code 裡輸入 /plugin marketplace add 加上專案網址,再 /plugin install ecc@ecc。

從別人分享的壓縮檔或鏡像裝會有什麼問題?

README 自己就警告,第三方轉載和非官方鏡像不是專案在維護、也沒經過審查,可能夾帶惡意程式。這類設定包會拿到你專案的讀寫權限,等於把一台能動手的機器放進電腦,所以來源要認官方那五個。

hooks 為什麼要特別小心?

hooks 是到了某個時間點就自動跑的指令,例如每次開工、每次存檔前。它可能在你不知道的時候執行一段東西。裝完先看它設定了哪些 hooks、每個什麼時候跑、做什麼事,看不懂的先關掉,用熟了再一個一個打開。

不會寫程式的人裝了有用嗎?

整包不太需要。skill 其實就是一份工作說明書:這件事怎麼做、要注意什麼、做完怎麼檢查。寫貼文、整理會議紀錄、做月報都可以寫成一份。文章裡有可以直接複製的六段範本,先挑一件你每週重複做的事寫下來就好。

328 個 skill 要全部裝嗎?

不用,README 自己的建議就是先裝比較小的設定組,安裝時可以選 minimal 或 core,用得到再加。我自己的 Claude Code 有 150 幾個 skill,真正每天在跑的大概十幾個,剩下的多是當初覺得以後可能用到。數量多不代表好用。