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

認識 git,你的存檔點

像打遊戲一樣存檔你的 SKILL

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

第一個概念

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

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

像遊戲存檔機:每個 commit 凍結一個版本,隨時讀檔重來
像遊戲存檔機 · 每個 commit 凍結一個版本
存檔這個動作
在 git 裡叫 commit。記住那個當下所有檔案的樣子,像電動存了一張記憶卡。
讀檔重來
改壞了、刪錯了,回到上一個存檔點就好。沒有什麼是真的壞掉的。
今天的情境
做出一個能用的 skill,先 commit 一版。之後改爛了,永遠有一個「能回去的點」。

第一次見到的人看這裡

三個核心詞:Repo、Commit 與 Branch

不用背。回到遊戲存檔的比喻,一張記憶卡就講完三個核心概念。

Repository(repo) 專案的家 · 一個專案=一張專屬記憶卡 MEMORY CARD (.git/) 主線 (main) 01 建立專案 02 抓取字幕 03 整理摘要 04 封裝 Skill 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 做。

MODULE 02 · 終極安全防線

存檔前必備防護:確認金鑰不在裡面

app.py · 危險直接寫死金鑰
# app.py 錯誤示範
import openai
OPENAI_API_KEY = "sk-proj-998877665544332211..."
client = openai.OpenAI(api_key=OPENAI_API_KEY)
# 金鑰直接寫在純文字檔案內!
⚠️
CRITICAL LEAKAGE DETECTED
金鑰已暴露在 Git 追蹤範圍內
git status · leakage_scan.log
> $ git status
Changes to be committed:
modified: app.py (包含未加密 API KEY)
> $ git push origin main ➔ 立即公開!
嚴重後果: GitHub 上的公開爬蟲會在 3 分鐘內抓取您的金鑰,並在 1 小時內盜刷數百美金額度!
安全咒語

危險警報:直接把 Key 寫在代碼裡並 Push,等於把公司信用卡公開發在網路上!

● SECURITY: VULNERABLE

全員動手 · 五分鐘

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

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

你說
把這個資料夾變成 git repo,commit 一版,然後在我的 GitHub 開一個 repo 推上去。先確認 .env 之類的機密不會被推上去。
AI 做
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
別人拿來用
他在 AI 說「把這個 GitHub repo 拉下來」,clone 一份,直接照用你的 skill。

版本永遠一致:你改了再 push、別人再拉一次,大家用的都是同一份最新的。不用寄壓縮包、不用怕誰用到舊版。

八分鐘複習完畢

四句話,記住就夠了

✓git=存檔。做到一個段落、喊「存一下」。弄壞了能回到上一個存檔點,commit 是這個動作的名字。
✓GitHub=雲端備份。push 一下,存檔上雲端。電腦壞了沒事、分享給同事不用寄檔案。
✓不用背指令。自然語言叫 AI 做。你的工作是判斷「什麼時候該存」,指令的事 AI 包辦。
✓機密別存進去。API key 放 .env,請 AI 加進 .gitignore。一行指示,一勞永逸。
行有餘力再看 · 今天不要求
有興趣可自行探索 git status / add / commit / push、branch,以及上一頁的分享 repo 用法。今天工作坊不要求你碰指令,AI 全包。想更進階:fork 與 PR 的開源協作流程,會後可以來問我。