這份
README.md是要編輯、提交的來源;README.html只是教材產生的靜態預覽,不會取代 Markdown,也不應拿來放假 hash、假 URL 或假驗收結果。Solution 只完成三項核心 TASK,不代填學生自己的 Git 證據。
Secret safety: 不要把 token、密碼、API key、cookie、
.env內容、個資或其他憑證寫進 README、commit、截圖或 GitHub。需要示範時只使用遮罩後的假值;不要提交真實秘密,也不要放可直接貼上的假 repo URL。
作品介紹
這是一份給初次認識我的訪客閱讀的前端作品集,集中展示活動頁、品牌頁與聯絡入口。
DONE-01 的可觀察證據: README 說明作品用途,第一筆 commit 只包含作品骨架與定位,git status --short 顯示乾淨。範圍應為 README.md、README.html、index.html、style.css;以 git show --stat --oneline HEAD 核對,並確認 git status --short 無輸出。
主要功能
- 可跳轉的作品集導覽
- 手機與桌機皆可閱讀的作品卡片
- 清楚可見的聯絡入口
如何開啟
下載整個資料夾後,以瀏覽器開啟 index.html。
DONE-02 的可觀察證據: 陌生人能依 README 開啟作品,第二筆 commit 只處理功能與開啟方式,且 git status --short 顯示乾淨。依上述文件實際開啟作品,以 git show --stat --oneline HEAD、git log --oneline -2 與 git status --short 核對實際變更範圍只包含 README.md。
排錯與版本證據
DONE-03 的可觀察結果: 排錯紀錄可重現,git log 顯示三筆範圍清楚且可說明的 commit,git status --short 顯示乾淨。
可重現的排錯紀錄
以下是排錯紀錄的寫法與重跑順序;交件時要以自己實際操作的輸出驗收,不把這段文字當成已完成的個人證據。
- 症狀: README 修改後,
git status --short顯示工作目錄仍有未提交變更,或 GitHub 頁面尚未反映最新內容。 - 重現: 在個人練習資料夾執行
pwd、git status --short,再以git diff -- README.md查看未提交差異;確認問題發生在本機工作樹,而不是先猜測遠端狀態。 - 定位: 先確認目前位於正確 repo,再用
git diff -- README.md對照本次排錯紀錄,並用git log --oneline -3檢查三筆 commit 是否各有單一責任。 - 修正: 只將本次排錯紀錄加入
README.md,執行git add README.md,建立第三筆「記錄 Git 排錯流程」commit;不要把 token、密碼、個資或.env一起加入。 - 重跑: 執行
git status --short、git log --oneline -3與git rev-parse HEAD;前者應無輸出,後兩者應呈現三筆可說明的 history 與實際最新本機 hash。
三筆 commit 的責任
| 順序 | commit 責任 | 核對方式 |
|---|---|---|
| 第一筆 | 建立作品集骨架與定位:說明用途/目標讀者,範圍為 README.md、README.html、index.html、style.css | git show --stat --oneline <第一筆 hash>;提交後 git status --short 無輸出 |
| 第二筆 | 補上主要功能與本機開啟方式,範圍只為 README.md | git show --stat --oneline <第二筆 hash>,並依 README 開啟 index.html |
| 第三筆 | 記錄 Git 排錯流程,範圍只為 README.md | git show --stat --oneline <第三筆 hash> 與 git log --oneline -3 |
最新本機 hash: 執行 git rev-parse HEAD 後記錄實際輸出;Solution 不提供示範 hash。若提供 GitHub URL,驗收者必須查詢遠端最新 hash,並確認它與本機 git rev-parse HEAD 完全一致;未提供 URL 時,不要填入假 repo URL。
最終驗收
- 三筆 commit 的責任與實際檔案範圍都能由
git show --stat說明。 git log --oneline -3顯示三筆範圍清楚且可說明的 commit。git status --short顯示乾淨、無輸出。README.md是來源,README.html只作靜態預覽,不能替代上述 Git 證據。