整套流程跑一遍：從零建一個真的能跑的天氣小工具

把 Stage 0 全部串起來：終端機、IDE、AI 對話、Git、套件管理，第一次完整走一遍，確認你真的會用。我們要用 AI 協作，建一個「每日天氣提醒小工具」：輸入城市名稱，呼叫天氣 API，印出今天的天氣概況。這不是 Hello World，而是一個真的有用的小工具，完成後你會有一個可以跑的 Python 程式、一個有 commit 歷史的 Git repo、一份 requirements.txt。

這個模組要做什麼

這個專案會用到：終端機指令、虛擬環境、pip 安裝套件、AI 對話寫程式、Git commit。完成後你會有：一個可以跑的 Python 程式、一個有 commit 歷史的 Git repo、一份 requirements.txt。

建立專案結構

# 進入你的練習資料夾
cd ~/Desktop/vibe-projects

# 建立新專案資料夾並進入
mkdir weather-tool
cd weather-tool

# 初始化 Git
git init

# 建立虛擬環境並啟動（Mac / Linux）
python3 -m venv .venv
source .venv/bin/activate

# 建立 .gitignore（一次寫入三行）
echo ".venv/" > .gitignore
echo ".env" >> .gitignore
echo "__pycache__/" >> .gitignore

# 第一次 commit
git add .gitignore
git commit -m "初始化專案，加入 .gitignore"

安裝套件與設定環境

# 確認虛擬環境已啟動（看到 .venv 字樣）
pip install requests

# 把套件清單記錄下來
pip freeze > requirements.txt

# 建立 .env 檔案（用 IDE 開啟後寫入）
WEATHER_API_KEY=你的API金鑰

# 安裝讀取 .env 的套件，再更新清單
pip install python-dotenv
pip freeze > requirements.txt

第一個可以跑的專案：用 AI 寫程式

現在打開 Cursor，把專案資料夾開啟，在 AI 對話框用四要素提示詞請 AI 寫程式：

請用 Python 寫一個天氣查詢小工具，功能如下：
- 從 .env 讀取 WEATHER_API_KEY
- 讓使用者輸入城市名稱（英文）
- 呼叫 OpenWeatherMap API（免費版）查詢當前天氣
- 印出：城市名稱、溫度（攝氏）、天氣描述、濕度
- 如果城市找不到或 API 出錯，顯示友善的錯誤訊息
- 使用 requests 和 python-dotenv
- 每行加上繁體中文註解

AI 產出後，先讓它自我審查：

這段程式碼有沒有安全疑慮？邊界情況有沒有都處理到？

確認沒問題後，把程式碼存成 weather.py，在終端機執行：

python3 weather.py

推上 GitHub

# 確認 .env 有在 .gitignore 裡（非常重要）
cat .gitignore

# 查看目前狀態，確認 .env 不在追蹤清單裡
git status

# 加入所有變動並 commit
git add .
git commit -m "新增天氣查詢功能，使用 OpenWeatherMap API"

# 在 GitHub 建立新 repo 後，連接並推上去
git remote add origin https://github.com/你的帳號/weather-tool.git
git branch -M main
git push -u origin main

Stage 0 驗收清單

做完這個模組，用下面的清單確認 Stage 0 的所有能力都到位了，全部打勾才算完成。

• 能在終端機用 pwd、ls、cd、mkdir 導航與建立資料夾
• Cursor（或其他 IDE）安裝完成，全域 Rules 至少三條已設定
• 能用四要素提示詞跟 AI 說清楚需求，並讓 AI 自我審查
• 每次做完功能就 commit，知道如何用 git checkout 回到舊版本
• .gitignore 設定完成，.env 和 .venv 不會被 commit
• 能建立虛擬環境、安裝套件、產出 requirements.txt
• 天氣小工具能正常執行，並已推上 GitHub Private repo