三項核心 TASK 必須從學生在教材 repo 外建立的個人練習 repo 取得 Git 證據。四階段只對照 README.md 的內容責任;README.html 是靜態預覽,不是答案來源,也不應放入預先填好的假 hash、假 URL 或假驗收結果。
| 任務 | 完成標記 | 修改檔案 | 修改位置 | 可見結果 |
|---|---|---|---|---|
| TASK-01 | DONE-01 | README.md | 「作品介紹」與第一筆 commit | README 說明作品用途,第一筆 commit 只包含作品骨架與定位,git status --short 顯示乾淨 |
| TASK-02 | DONE-02 | README.md | 「主要功能/如何開啟」與第二筆 commit | 陌生人能依 README 開啟作品,第二筆 commit 只處理功能與開啟方式,且 git status --short 顯示乾淨 |
| TASK-03 | DONE-03 | README.md | 「排錯與版本證據」與 git log --oneline -3 | 排錯紀錄可重現,git log 顯示三筆範圍清楚且可說明的 commit,git status --short 顯示乾淨 |
階段差異
starter/:保留 TASK-01~TASK-03 的空白骨架與預期證據,不代填作品內容、hash、URL 或排錯結果。checkpoint-1/:只完成 DONE-01;TASK-02、TASK-03 仍保留待完成狀態。checkpoint-2/:保留 DONE-01,再完成 DONE-02;TASK-03 仍保留待完成狀態。solution/:在相同位置完成 DONE-01~DONE-03;不加入延伸功能或無關重構。
人工驗收
先把 starter/ 整個資料夾複製到教材 repo 外的個人練習資料夾,再在該資料夾建立自己的 history。驗收者要看學生實際執行後的輸出,不接受 README 內預先寫好的示範 hash、示範 URL 或示範截圖代替證據。
- 逐筆核對三筆 commit 的責任與範圍。
- 第一筆:作品用途/目標讀者與作品骨架定位;執行 git show --stat --oneline HEAD,確認範圍為 README.md、README.html、index.html、style.css,且 git status --short 無輸出。 - 第二筆:主要功能與本機開啟方式;執行 git show --stat --oneline HEAD、git log --oneline -2 與 git status --short,確認只變更 README.md,並能依文件實際開啟作品。 - 第三筆:可重現排錯紀錄;執行 git log --oneline -3 與 git status --short,再以 git show --stat --oneline HEAD 核對,確認只變更 README.md 且紀錄能依原步驟重跑。
- 核對最新本機 hash 與完整 history。 執行
git log --oneline -3,再執行git rev-parse HEAD;提交的最新本機 hash 必須是該指令的實際輸出,不能使用範例值。git status --short必須無輸出。
- 若學生提供 GitHub URL,才進行遠端比對。 由驗收者以該真實 URL/遠端預設分支查詢最新 commit hash,必須與本機
git rev-parse HEAD完全一致;未提供 URL 時,不要求捏造 URL,仍以本機 Git 證據驗收。
- 核對來源與安全。 學生應編輯並提交
README.md;README.html只作靜態預覽,不得拿預覽內容冒充 Git 證據。README、commit、截圖與 URL 內不得出現真實 token、密碼、API key、cookie、.env內容或個資;需要展示時只能使用遮罩後的假值,且不得放可直接貼上的假 repo URL。