AGENT SKILL 一日工作坊 · 下午場

認識 git,你的存檔點

你今天做了大半天的 skill,正好趁這個時機保住它們。存檔、備份、機密別外洩:三件事,八分鐘講完。

6 頁 · 概念優先 零指令 · AI 幫你存
帶走四件事:git=存檔、GitHub=雲端備份、不用背指令、機密別存進去。記住這四句,今天的東西就安全了。

第一個概念

打王前先存檔,弄壞了讀檔重來

像遊戲存檔機:每個 commit 凍結一個版本,隨時讀檔重來

存檔這個動作

在 git 裡叫 commit。記住那個當下所有檔案的樣子,像電動存了一張記憶卡。

讀檔重來

改壞了、刪錯了,回到上一個存檔點就好。沒有什麼是真的壞掉的。

今天的情境:做出一個能用的 skill,先 commit 一版。之後改爛了,永遠有一個「能回去的點」。

第一次見到的人看這裡

你會一直聽到的三個詞,一次講清楚

用 git 一定會碰到這三個英文字。你不用背,但看得懂它們在說什麼,後面就不會慌。

📁

Repository(repo)

一個專案的「家」:skill 資料夾加上它所有的存檔記錄。一個專案=一個 repo。

💾

Commit

存一次檔,記住那個當下所有檔案的樣子。剛剛說的「存檔點」就是它。

🌿

Branch(分支)

一個平行分身。在分身上試大改動,成功再合併回主線,主線永遠安全。進階功能,知道有就好。

白話總結:repo 是「專案的家」、commit 是「存一次檔」、branch 是「平行分身」。三個詞看得懂就夠了,真的要操作,一樣交給 AI。

第二個概念

GitHub,把你的存檔放到雲端

git 是本機的存檔,GitHub 是把這份存檔同步到網路上的地方。兩個好處,缺一不可。

好處一:備份

電腦摔壞了、被偷了,skill 還在 GitHub 上完好如初。本機一份,雲端一份。

好處二:團隊共享

開個權限,同事拉一份就有你整套 skill,不用寄壓縮包。連結一發,版本一致。

💻
git
你電腦裡的存檔記錄
push →
☁️
GitHub
雲端上的備份與分享

給行銷人的好消息

零指令,你跟 AI 說,它來做

git 有一整套終端機指令,但你一個都不用記。你只要懂「什麼時候該喊一聲存一下」。

你說
「幫我把現在的進度存一個版本,說明寫新增了 SEO 關鍵字分析 skill。」
AI
Claude Code 做
執行 git add . → git commit -m "...",完成。
你說
「幫我同步到 GitHub。」
AI
Claude Code 做
執行 git push,同步完畢。你的存檔在雲端了。
你的工作只有一件事:知道「什麼時候該存一下」。剩下的,自然語言交給 AI 做。

唯一要注意的事

存檔前,確認金鑰不在裡面

commit 推上 GitHub 是公開記錄。API key、客戶機密一旦推出去,就算之後刪掉,記錄還在。

❌ 絕對不能做

把 API key、客戶資料、密碼直接寫進檔案裡一起 commit。就算 repo 私密,習慣也不能壞。

# 千萬不要這樣
SERPER_API_KEY = "sk-abc123..."

✓ 正確做法

key 放在 .env 檔裡,再請 Claude 把 .env 加進 .gitignore(一份「這些不要存檔」的清單)。

# .gitignore 裡寫一行
.env
你只要說一句話:「幫我把 .env 加進 .gitignore,確保 API key 不會被存進去。」Claude Code 幫你搞定。

全員動手 · 五分鐘

把你做的一個 skill,變成 repo 推上 GitHub

概念講完了,動手存一次。挑你今天做的其中一個 skill 資料夾,一句話交給 Claude Code。

你說
「把這個資料夾變成 git repo,commit 一版,然後在我的 GitHub 開一個 repo 推上去。先確認 .env 之類的機密不會被推上去。
AI
Claude Code 做
git init → 建 .gitignore 擋掉機密 → git add → commit → 在 GitHub 建 repo → push。幾秒後,你的 skill 上雲端了。
這一步把今天學的全用上了:repo(家)、commit(存檔)、push(上雲端)、.gitignore(擋機密)。一句話,AI 全包。打開你的 GitHub 看到它,就成功了。

push 的另一個用途

push 上去,別人就能拿來用

push 到 GitHub 之後,這個 repo 就有一個網址。把人加進來、或設公開發連結,同事拉一份就有你整套 skill,不用再寄壓縮包。

1
你 push 上 GitHub 你的 repo 就有一個專屬網址,這就是分享的入口
2
給權限,或設公開 私密 repo:把同事加成「協作者」。或設成公開,直接把連結貼給他
3
別人拿來用 他在 Claude Code 說「把這個 GitHub repo 拉下來」,clone 一份,直接照用你的 skill
版本永遠一致:你改了再 push、別人再拉一次,大家用的都是同一份最新的。不用寄壓縮包、不用怕誰用到舊版。

進階 · 開源協作(行銷端聽過就好)

別人 fork 你的 repo,改好用 PR 回饋

repo 公開之後,別人可以複製一份去改,再把改動「請你合併回來」。這就是開源世界協作的方式。

協作這樣跑(4 步)

① fork 別人把你的 repo 複製一份到他自己帳號
② 改 在他那份上優化、修問題、加功能
③ 開 PR 送出 Pull Request:「我改了這些,要不要合併?」
④ 你 review → 合併 看過沒問題,一鍵合併回你的 repo

⚠ 合併前要注意

· PR 說明要寫清楚「改了什麼、為什麼」,你才好判斷
· 合併前先看一遍,確認沒把 .env、API key 之類機密 commit 進來
· 一個 PR 只做一件事,小而清楚比一次改一堆好 review
· 沒把握先留言討論,別急著合,main 保持乾淨
這段是進階:行銷端知道「有人能幫你改、再回饋給你」這回事就好;技術端可以實際 fork 一個公開 repo 來玩一次。

八分鐘複習完畢

四句話,記住就夠了

① git=存檔

做到一個段落、喊「存一下」。弄壞了能回到上一個存檔點。commit 是這個動作的名字。

② GitHub=雲端備份

push 一下,存檔上雲端。電腦壞了沒事、分享給同事不用寄檔案。

③ 不用背指令

自然語言叫 Claude Code 做。你的工作是判斷「什麼時候該存」,指令的事 AI 包辦。

④ 機密別存進去

API key 放 .env,請 Claude 加進 .gitignore。一行指示,一勞永逸。

技術端補充(行銷端跳過):有興趣可自行探索 git status / add / commit / push、branch,以及剛才那兩頁的 分享 repofork/PR 協作,但今天工作坊不要求行銷端碰指令,AI 全包。