⌂ 總覽
Agent Skill 一日工作坊 · 下午場

認識 git,你的存檔點

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

6 頁概念 · 4 頁動手 零指令 · AI 幫你存 git=存檔 · GitHub=備份 · 不背指令 · 機密別存進去

第一個概念

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

git 就是你工作檔案的存檔系統。做到一個段落存一版,之後永遠回得去。

像遊戲存檔機:每個 commit 凍結一個版本,隨時讀檔重來
像遊戲存檔機 · 每個 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 做
執行 git add .git commit -m "...",存檔完成。
你說
幫我同步到 GitHub
AI 做
執行 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 做
git init → 建 .gitignore 擋掉機密 → git addcommit → 在 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 公開之後,別人可以複製一份去改,再把改動「請你合併回來」。這就是開源世界協作的方式。

協作這樣跑
① fork別人把你的 repo 複製一份到他自己帳號
② 改在他那份上優化、修問題、加功能
③ 開 PR送出 Pull Request:「我改了這些,要不要合併」
④ review你看過沒問題,一鍵合併回你的 repo
合併前要注意
PR 說明沒寫清楚
要寫清楚「改了什麼、為什麼」,你才好判斷
沒先看就合
合併前確認沒把 .env、API key 之類機密 commit 進來
一個 PR 改一堆
一個 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 全包。