這份
README.md是要編輯、提交的來源;README.html只是教材產生的靜態預覽,不會取代 Markdown,也不應拿來放假 hash、假 URL 或假驗收結果。此階段只完成 DONE-01。
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 log --oneline -1
git show --stat --oneline HEAD
git status --short
驗收時,git status --short 必須無輸出;不要在文件中預先填入 hash 或假輸出。
主要功能
- 尚未列出真實功能
如何開啟
尚未說明本機開啟方式。
待完成證據: 依 README 實際開啟作品,再建立第二筆「補上功能與本機開啟方式」commit;執行 git show --stat --oneline HEAD、git log --oneline -2 與 git status --short,該筆預期只變更 README.md 且 status 顯示乾淨。
待完成結果: 陌生人能依 README 開啟作品,第二筆 commit 只處理功能與開啟方式,且 git status --short 顯示乾淨。
排錯與版本證據
尚未記錄。
待完成證據: 以實際操作留下「症狀 → 重現 → 定位 → 修正 → 重跑」紀錄,建立第三筆「記錄 Git 排錯流程」commit,再執行 git log --oneline -3 與 git status --short;三筆 commit 要能說明範圍,且 status 顯示乾淨。
待完成結果: 排錯紀錄可重現,git log 顯示三筆範圍清楚且可說明的 commit,git status --short 顯示乾淨。
交付前檢查
README.md是來源,README.html只作靜態預覽。- 此階段只完成 DONE-01;TASK-02、TASK-03 不可先代填。
- 最終驗收仍需
git status --short無輸出與git rev-parse HEAD的實際最新本機 hash。 - 若提供 GitHub URL,驗收者必須核對遠端最新 hash 與本機 hash 一致;沒有 URL 就不要填假 URL。