今天遇到的問題

「不知道程式全部在做什麼，就不能開始嗎？」我會把第一個修改縮小到可以逐行看懂：建立一個印出專案名稱的小程式，再改一行文字。

一個核心概念：計畫、修改、執行、核對

計畫說明預期改動；diff 顯示實際變動；執行結果證明程式能跑。三者要對得起來，不能只看 AI 的完成訊息。

實作：建立第一個 Python 小程式

先在 PowerShell 建立工作台自己的環境：

py -3.12 -m venv .venv

Claude Code prompt：

建立 hello.py，只用 Python 標準庫。
執行後印出「台股研究工作台：準備中」。
先說明檔案內容，再建立檔案。
用 .venv\Scripts\python.exe 執行，回報退出碼與實際輸出。
不要安裝其他套件。

自己再執行：

.\.venv\Scripts\python.exe .\hello.py
$LASTEXITCODE

接著要求只把「準備中」改成「第一個程式可以執行」，保留其他內容。開啟 hello.py，找到那一行改動。

要練習 Plan Mode，可在 Claude Code 的權限模式選單切換；依安裝版本畫面操作，先請它只說修改計畫，再切回可編輯模式實作。常見工作流程

一個失敗案例

執行 python 卻用了其他專案的版本。先查 Get-Command python，並改用這個專案的 .venv\Scripts\python.exe；不要看到 ModuleNotFoundError 就把套件裝到全域。

當日驗收

• [ ] 能指出修改前後那一行文字。
• [ ] 自己執行後得到預期輸出與退出碼 0。
• [ ] 知道這不代表股票研究功能已完成。

實測後補：

• 環境：WSL2（6.6.87.2-microsoft-standard-WSL2）Linux bash、Claude Code 2.1.268。非教材預期的 Windows PowerShell 環境。
• 前置狀態：Day 05 的 docs/report-requirements.md；工作台位置實為 Desktop/Claude-project/ironman/stock-research-workbench/（非 TEST-LOG 先前記載的 ~/Documents/ironman/...，內容一致，僅路徑敘述有誤，本次一併修正）。
• 今天的問題：建立第一個可執行的小程式，走完計畫、修改、執行、核對。
• 實際 prompt：教材 Day 06 提供的完整 prompt（建立 hello.py，只用標準庫，執行後印出「台股研究工作台：準備中」，用 venv 執行並回報退出碼）。
• 執行指令（不含 token）：
  • python3.12 -m venv .venv：首次失敗，ensurepip is not available（WSL 未裝 python3.12-venv 套件）。
  • 未執行 apt install python3.12-venv——安裝系統套件需要 sudo，屬於會改動系統環境的動作，比照 Day 03 慣例留給作者本人決定，不擅自代裝。
  • 改用 python3.12 -m venv .venv --without-pip：成功（exit 0）。因為本次任務只需標準庫，不裝 pip 套件不影響需求。
  • .venv/bin/python3.12 hello.py：輸出「台股研究工作台：準備中」，exit 0。
  • 將該行改為「台股研究工作台：第一個程式可以執行」，其餘內容不動。
  • 再次執行 .venv/bin/python3.12 hello.py：輸出「台股研究工作台：第一個程式可以執行」，exit 0。
• 觀察結果與退出碼：兩次執行皆 exit 0，輸出與預期文字完全相符。
• 產物位置：stock-research-workbench/hello.py、stock-research-workbench/.venv/（--without-pip 建立，僅含標準庫直譯器，無 pip）。
• 與教學預期的差異：
  1. 教材指令是 PowerShell（py -3.12 -m venv .venv、.venv\Scripts\python.exe），本次在 WSL bash 執行，對應為 python3.12 -m venv .venv、.venv/bin/python3.12；純 Windows PowerShell 讀者請照教材原文指令。
  2. WSL 內建 python3.12 缺 ensurepip（缺 python3.12-venv 套件），一般 Windows 原生 Python 安裝通常不會遇到這個問題；WSL 讀者若遇到同樣錯誤，可用 --without-pip 繞過，前提是這一步任務不需要任何第三方套件。
• 失敗原因與修正：venv 首次建立失敗於 ensurepip 缺失；修正為加 --without-pip 參數，未動用 sudo、未改動系統套件狀態。
• API 請求數／等待時間：不適用（本日無外部 API 呼叫）。
• 本日總時間：約 5 分鐘。
• 文章要調整的段落：「實作：建立第一個 Python 小程式」可補一句 WSL／Linux 讀者對應指令表，以及「若 venv 建立失敗顯示 ensurepip is not available，可加 --without-pip（本步驟不需要 pip）」。
• 尚未驗證：純 Windows PowerShell 原生環境下 py -3.12 -m venv .venv 的實際行為（本機 Windows 側沒有裝 Python 3.12，僅 WSL 側裝了 3.12.3，見 Day 03 紀錄）。

下一天預告

明天把這次修改留下版本，學會查看差異與回復自己的改動。