Denny Huang

• SITCON 學生計算機年會 共同發起人
• COSCUP 開源人年會 長期志工
• HITCON 台灣駭客年會 長期志工
• GDG Cloud Taipei Organizer
• 曾任雷亞遊戲（Rayark Inc.）資料分析團隊主管
• About me

工具不重要

• 把想法寫清楚
• 讓隊友和 Agent 看得懂
• 看懂改了什麼
• 留下可追蹤的紀錄

所有入口

• Google Docs 共編文件
• GitHub 組織：https://github.com/SITCON-Camp-2026
• 公開成果頁：https://sitcon-camp-2026.github.io/prep-course/
• 卡住時：找隊輔或助教

小隊 repo 命名規則

第 1 小隊：team1-prep-course
第 2 小隊：team2-prep-course
...
第 9 小隊：team9-prep-course

請確認：

• 不是 prep-course
• 不是別隊的 repo

為什麼從 Google Docs 開始？

• 把想法寫下來
• 讓別人看得懂
• 一起修改
• 保留修改紀錄

Markdown？

## GitHub 帳號

## 顯示名稱

- AI
- 前端
- 開放資料

為什麼需要 Markdown？

Google Docs：開啟 Markdown

操作路徑：

工具
→ 偏好設定
→ 啟用 Markdown
→ 確認

Profile 草稿

請在 Google Docs 完成：

## GitHub 帳號

## 顯示名稱

## 一句話介紹

## 興趣主題

## 技術陣營

公開名片，不寫個資

技術陣營戰爭

Profile 草稿完成

請確認填好：

• GitHub 帳號
• 顯示名稱
• 一句話介紹
• 興趣主題 1–3 個
• 作業系統 / 瀏覽器 / 編輯器陣營

Google Docs 版本紀錄

操作路徑：

檔案
→ 版本記錄
→ 查看版本記錄

會看到：

• 是誰
• 在什麼時候
• 改了什麼
• 可以回到舊版本

從版本紀錄到 commit

VS Code

• Explorer：看檔案
• Editor：改檔案
• Agent：請 AI 協助
• Source Control：看版本紀錄和差異（diff）
• Terminal：跑指令

在 VS Code 登入 GitHub

操作路徑：

VS Code 左下角 Accounts
→ Sign in with GitHub
→ 瀏覽器授權
→ 回到 VS Code

GitHub ≠ Git

設定 Git 使用者名稱與 email

打開 VS Code Terminal：

git config --global user.name "你的 GitHub 帳號或顯示名稱"
git config --global user.email "你的 GitHub noreply email 或 GitHub 使用的 email"

範例：

git config --global user.name "octocat"
git config --global user.email "[email protected]"

檢查 Git 設定

git config --global user.name
git config --global user.email

應該看到：

第一行：你的 Git 使用者名稱
第二行：你的 Git email

找到小隊 repo

操作路徑：

https://github.com/SITCON-Camp-2026
→ Repositories
→ teamX-prep-course

確認畫面上是：

SITCON-Camp-2026 / teamX-prep-course

Clone 小隊 repo

操作路徑：

GitHub repo 頁面
→ Code
→ HTTPS
→ Copy URL
→ VS Code
→ Source Control
→ Clone Repository
→ 貼上 URL
→ 選資料夾
→ Select as Repository Destination

repo 檔案結構

README.md
AGENTS.md
package.json
notes/
profiles/
tasks/
data/
schemas/
src/

建立個人草稿檔

操作路徑：

Explorer
→ notes/
→ New File
→ <你的 GitHub 帳號>.md

內容：

貼上 Google Docs 的 profile 草稿

與 Agent 協作

• 讀檔案
• 依照規則轉換資料
• 修改檔案
• 說明它改了什麼

Agent 不是魔法

Agent 需要知道規則

notes/<github>.md
schemas/profile.schema.json
data/faction-options.json
AGENTS.md

下 prompt 前該有的準備：

輸入 / 規則 / 選項 / 協作指示

JSON 是什麼？

自然語言：
我平常用 Linux、Firefox，編輯器喜歡 Vim。

{
  "os": "linux",
  "browser": "firefox",
  "editor": "vim"
}

JSON 的三個基本概念

{
  "displayName": "小火龍",
  "github": "octocat"
}

• 物件 object：{ }
• 欄位 key：displayName
• 值 value：小火龍

為什麼會常看到 JSON？

• 設定檔
• API 回傳資料
• 前端資料
• Agent 產生內容
• 專案資料交換

JSON 結構嚴謹

常見錯誤：

• 少逗號
• 少引號
• 欄位名稱打錯
• 大小寫不一致
• 多了註解

固定字串避免混亂

"editor": "vscode"

不要變成：

VS Code
vscode
VSCode
Visual Studio Code

schema - 寫給工具看的規則

• required：哪些欄位一定要有
• enum：只能使用哪些固定選項
• validation：檢查格式是否正確

給 Agent 的任務

可複製 prompt：

請閱讀 notes/<我的 GitHub 帳號>.md，
根據 schemas/profile.schema.json
和 data/faction-options.json，
產生 profiles/<我的 GitHub 帳號>.json。

請不要加入我沒有提供的個資。
完成後請告訴我改了哪些檔案。

Agent 產生 JSON 之後

請檢查：

• 有沒有產生 profiles/<github>.json
• JSON 有沒有紅線
• faction 是否使用小寫代號
• 有沒有多出你沒提供的個資

本機預覽

打開 VS Code Terminal：

pnpm run dev

關鍵輸出：

Local: http://localhost:5173/

用瀏覽器打開這個網址。

本機預覽檢查

請確認：

• 看得到自己的卡片
• GitHub 頭貼有出現
• 顯示名稱正確
• 技術陣營正確
• 統計數字有更新

Agent 會犯錯

可能發生：

• 猜錯陣營
• 改錯 GitHub 帳號
• 過度改寫 tagline
• 新增你沒提供的資訊
• 格式正確但內容錯誤

看 diff 是人類應盡責任

操作路徑：

Source Control
→ 點選變更的檔案
→ 查看修改差異 diff

檢查：

• GitHub 帳號正確嗎？
• 顯示名稱正確嗎？
• 技術陣營正確嗎？
• 有沒有多出個資？

commit

操作路徑：

Source Control
→ Stage Changes
→ 讓 AI 自動產生 commit message
→ Commit

push 前先同步

隊友可能已經先 push 新版本。

建議操作路徑：

Source Control
→ Sync Changes

或使用 Terminal：

git pull --rebase
git push

如果 push 失敗

常見原因：

remote contains work that you do not have locally

意思是：

GitHub 上已經有隊友的新 commit
你的本機需要先同步

這時候可以請 Agent 協助

給 Agent 的任務：

請協助我判讀目前 git 狀態。
先不要刪除或覆蓋任何檔案。
請告訴我下一步應該 pull、rebase、resolve conflict，還是 push。

push：把 commit 送回 GitHub

操作路徑：

Source Control
→ Sync Changes / Push

或使用 Terminal：

git push

公開成果頁

應該看到：

• GitHub 頭貼
• 顯示名稱
• 一句話介紹
• 興趣
• 技術陣營
• 全營隊統計

其實完成了

想法
→ Markdown 草稿
→ Agent 轉換
→ JSON 資料
→ schema 檢查
→ 本機預覽
→ diff 審查
→ commit 紀錄
→ push 到 GitHub
→ 公開成果

Q & A