交接時,對方到底拿到什麼。

把 /agencies 承諾的六項交接內容,用 hao-code 自己的作品集 repo 走一遍。每一項都指向真實的檔案與指令,而不是好聽的樣板文字。

01範例說明

這份範例,用 hao-code 自己的 repo 做。

本頁是 hao-code 拿自己的作品集 repo 做的交付文件範本:內容取自這個 repo 的 README、.env.example、package.json 與實際指令輸出。它不是真實客戶的專案文件,也不含任何密鑰;密鑰一律透過安全管道另行交付。

範例交付

hao-code 作品集與概念作品網站

程式庫

github.com/HowHaoChih/web-studio

交付基準

main 分支的公開 commit 歷史

02六項交接內容

一項一項看,對方拿到了什麼。

左側是約定的六項交接清單,選一項就看它的實際內容、來源檔案與還沒涵蓋的界線。

交接清單

01可追蹤的 commit 與分支

Git 版本紀錄

交接清單承諾:以可追蹤的 commit 與分支整理本次交付內容。

對方拿到的是這個 repo 真實的 Git 歷史,而不是一個無法追查的壓縮檔。每一版交付都有對應的 commit 與分支,出了問題可以逐筆比對改了什麼、哪一版放進了哪個決定。

交接時,對方會拿到什麼?

  • 可追蹤的 commit 歷史,訊息沿用 feat / fix / chore 前綴
  • 交付以合併進 main 的 commit 清單為準;中繼分支只用於過程,合併後不保留
  • origin 遠端:https://github.com/HowHaoChih/web-studio.git
  • 驗收時可比對 main 上的 commit 清單與實際檔案

實際指令

git log --oneline --graph --decorate -15

來源

  • git log --oneline -12
  • git remote -v
  • git branch --show-current

界線這是 hao-code 自己的作品集 repo,不是客戶的私有程式庫。正式合作會改用對方擁有權限的遠端,並先約定是否保留完整歷史、分支命名與 commit 訊息格式。

交付要能被接手,才算完成。

如果你要接手或外包一個專案,這些就是交出去時該拿到的東西。把你的情況告訴我們,一起確認範圍與交接標準。

開始討論專案

先提供這些,討論會快很多

  • 網站或系統要解決什麼問題,給誰用
  • 預計要有哪些內容或功能,現有素材到哪個程度
  • 一到兩個參考網站,以及你喜歡或不喜歡的地方
  • 希望上線的時間,以及預算大概的區間