PRO Portfolio DEV
輸入 GitHub 使用者，輸出即時作品集。腳本負責擷取、建置、檢查和發佈；
你需要做它們做不到的事：挑選專案並寫出誠實且有力的文案。
路徑均相對於此技能的資料夾。請在一個暫存資料夾中工作，例如 portfolio/。
1 · 擷取（僅事實）
python3 scripts/fetch.py USER --out portfolio/repos.json（2 次公開 API 呼叫，無需 token）。
它會列出最熱門的倉庫。這些是你唯一可以使用的資料；絕不能虛構星星數、使用者或結果。
2 · 規劃（先詢問，然後寫入 portfolio/plan.json）
在一個訊息中詢問，並提供預設值讓使用者可以說「go」來接受：
- 對象與目標受眾： 姓名、角色、目標對象（招募者、客戶、同儕）。預設值：GitHub 名稱與個人簡介。
- 專案： 提出 4-9 個最強的專案（看星數、近期推送、是否有首頁、清楚的描述）；由使用者挑選。
- 技能與經歷（可選，可供搜尋）以及聯絡方式。
- 網站存放位置：
USER.github.io（根目錄）或某個倉庫的docs/資料夾。URL 必須是最終版本。
然後寫入 plan.json（schema 與文案規則請參閱 references/plan.md）。文案規則簡述：標題 ≤8 個字，
標語說明「做什麼 + 為誰而做」，每個專案都有一行簡介（強調效益，而非技術堆疊），以及一個可選的
proof 行，引用該倉庫 README 或 GitHub 資料中的數字，絕不能是自己編造的。
語言： 10 種語言的 UI 字串已內建在 scripts/ui.json 中。若要翻譯使用者自己的文案，請加入
plan.t.<lang> 並依照含義翻譯，如同母語人士用該語言自然表達的方式，而非逐字翻譯（請參閱
references/plan.md 的「翻譯」章節）。然後以該語言以母語讀者的身份重新閱讀一次，修正任何聽起來像直譯的內容。
3 · 建置與檢查
python3 scripts/build.py portfolio/repos.json portfolio/plan.json --out portfolio/site
python3 scripts/check.py portfolio/site
check.py 必須印出 PASS。在發佈前，請在瀏覽器中開啟 portfolio/site/index.html 並檢視：
嘗試用錯字搜尋，切換到阿拉伯文（從右到左）以及深色主題。
4 · 發佈（對外：先詢問）
向使用者展示頁面和目標位置，並取得確認。然後：
bash scripts/publish.sh portfolio/site REPO_CLONE URL [--folder root|docs] --yes
它會提交、推送、視需要啟用 Pages，並輪詢直到新版上線，接著印出 LIVE … in N s。
5 · 衡量與報告
在 ≤4 行中報告：上線 URL、LIVE 時間、check.py 分數，以及來自 PageSpeed Insights (pagespeed.web.dev，免費) 或本機 lighthouse（如果已安裝）的 Lighthouse SEO/可存取性/效能分數。
完成條件
check.py在已建置的網站上印出PASS。- 頁面上的每個專案都是使用者的真實倉庫，且每個數字都可追溯到 GitHub 資料或 README。
- 上線 URL 傳回新版網站（
publish.sh已印出LIVE），或者使用者選擇不發佈。
絕不
- 虛構專案、指標、雇主或推薦。改為詢問。
- 未經使用者同意就推送、發佈或啟用 Pages。
- 加入追蹤器、分析工具、Cookie 或外部腳本。頁面不會發出任何第三方請求。
- 在不顯示變更內容的情況下覆蓋現有網站（
publish.sh不加--yes就是乾執行）。