簡歷 Portfolio 復刻
以本 Skill 所在目錄為專案根目錄，保留 React、GSAP 滾動動畫、卡片佈局和響應式視覺。使用者請求製作個人網站時，先檢查素材，再根據真實簡歷完成整個網站。這個倉庫包含可執行原始碼，不需要特定 Agent、雲端服務或 API Key。
首次接手
- 閱讀
references/materials.md，執行node scripts/intake.mjs。腳本會建立固定素材目錄並輸出缺項。 - 使用使用者的語言一次性說明：簡歷放
inputs/resume/；動作影片放inputs/videos/；照片放inputs/photos/；學校、工作單位商標放inputs/logos/；可選模型放inputs/models/。給出材料指南中的鏡頭建議，提醒將綠幕佈光均勻且人物服裝避免綠色。 - 檢查已提交材料，缺簡歷時等待，不能虛構履歷。缺部分影片時先分析簡歷並完成文案；告訴使用者哪些區塊暫用照片/重複鏡頭，哪些素材仍需補齊。空目錄及佔位圖不算使用者材料。
- 讀取
references/adaptation.md，執行事實提取、文案映射、素材加工、組件取代和瀏覽器驗收。使用者說材料已準備好後重新執行 intake，不重複詢問是否繼續。 - 使用
template/resume-portfolio-content-template-general.docx作為文字輸入表。它沿用維護者最佳化版的四列表格排版；先填寫身份、About、教育/工作經歷、聯絡方式，再高密度填寫modules[]。Word 表中的modules[]不預設行業，Agent 要根據 CV 選擇專案經歷、個人作品集、獎項榮譽、研究、論文、客戶案例或專業實踐等類型；初稿可填 3 個模組，首個模組最多 4 個條目，人工確認後再刪減。倉庫以template/resume-portfolio-layout-source.docx作為去除個人元資料的版式來源；需要重建通用欄位版本時執行python scripts/adapt_user_word_template.py，不要寫回來源檔案。
事實與內容
- 簡歷原文是人物事實來源。將每項擬發布事實與原文頁碼/段落記入
work/facts.md；區分正式職稱、學習階段、參與和主導、已發表和投稿中。衝突或日期不明確時只詢問影響輸出的缺項。 src/content/profile.js是頁面文案與媒體編號的唯一資料入口。Word 表是使用者編輯入口，profile.json只是轉換中間產物，不能與頁面長期並行維護。常規復刻優先改這份資料；結構不適配時可調整組件，不硬湊六個能力或四個經歷。- 生成簡潔中文文案及忠實英文翻譯；保留人物的實際專業方向。Clinical、Research、Publication 只是原 Demo 的視覺槽位，不是行業限制。非學術人物應把它們映射為專案經歷、個人作品集、獎項榮譽、客戶案例或專業實踐，並同步修改標題、圖註和模型說明；通用的醫學/顯微鏡/腫瘤視覺不得被解釋為新人資歷。
- 對外聯絡方式由使用者提供並指定公開；未指定的電話、生日、住址、證件等不發布。原始簡歷和原影片只留在 inputs，不能複製進 public。
素材與交付
使用 npm run media 處理編號 01–07 的綠幕 MP4，參數與鏡頭映射見 materials。處理後檢查邊緣、膚色和循環接縫；腳本參數是起點，不是對任意綠幕都適用的品質保證。
依次執行 npm ci、npm run intake、Word 轉換 / 內容映射、npm run media、npm run build、npm run preview。透過可用的瀏覽器工具檢查桌面與手機、雙語、輪播、滾動、透明影片和無模型降級。先把預覽部署到靜態託管或本地可存取位址，使用者點按驗收並提出修改；修改優先回到 Word 表，再同步到 profile 和網頁。使用者明確最終確認後，才執行正式部署。用一個確實不同的新人 Profile 驗證取代，搜尋所有姓名/機構/聯絡方式和佔位文案，不能僅憑 build 成功宣稱復刻完成。
標準化閉環與卡點
下載專案後先收集 inputs/ 素材，再讀取簡歷事實並填寫 Word 表；素材處理和文案映射完成後建置靜態站，先給使用者一個可預覽位址；使用者的修改意見回寫 Word 表並重新建置，最後在明確確認後部署。靜態站預設不依賴後端伺服器，但影片、字型和 3D 模型仍會影響包體積、首屏速度和託管額度。
常見卡點包括：簡歷格式複雜導致事實提取不完整、綠幕邊緣溢色、Logo 沒有公開授權、影片或 GLB 過大、部分 Agent 沒有 DOCX 解析庫、靜態託管無法處理大檔案或 SPA 回退。解決方式是保留頁碼/段落事實索引、先用照片降級、記錄素材來源、壓縮 WebM/GLB、使用 scripts/word_to_profile.py 和 bundled Python、把大素材放物件儲存或改用靜態 CDN，並在每輪建置後做真實瀏覽器驗收。
交付本地預覽、完成的網站原始碼、素材用途索引及驗收結果。預設不上傳使用者新素材、不自動部署。發布或上傳時遵循使用者當前授權。缺材料導致的佔位區塊明確列出。