Interview Preparation Toolkit

一套本機優先的面試準備工作流，將履歷客製化、準備文件、互動式 mock interview、Q&A 渲染與主動回憶練習拆成可重複使用的 Agent Skills。

除了首次工作區初始化 Skill 可在符合條件時由 Agent 提示外，其餘 Agent Skills（包含可協助選路的 $ask-how-to）都需要由使用者明確啟動；也可直接使用對應的 $skill-name。

工作流

Skill	用途	主要輸出
$ask-how-to	在任何階段判斷目前狀態、下一個適用的本專案 Skill 與必要前置	路由建議；不寫入檔案
$initialize-interview-workspace	首次使用時檢查並建立空白履歷工作區	my-resume/完整履歷.md（只有 headers）
$build-tailored-resume	以 master resume 與 JD 客製化 ATS 友善履歷	customize-resume/<date-time>/<company>/<role>/
$interview-preparation	建立或更新 JD 分析、準備計畫與面試速查表	interview-prepare/<company>/<role>/ 下的準備文件
$start-mock-interview	從既有準備包啟動練習或正式模擬，並維護 canonical Q&A	mock_interview_qa.md（使用者同意記錄時）
$render-mock-qa-html	將穩定的 canonical Q&A 渲染成快速複習頁	mock_interview_qa.html
$build-interview-practice-html	將 A/B/C 分級 Q&A 轉成主動回憶與進度追蹤頁	mock_interview_practice.html
$build-interview-ppt	從客製化履歷建立面試簡報	interview-ppt/<date-time>/<company>/<role>/

通用的面試技巧與入職前查核文件不需要啟動 Skill：

• interview-skills/：離職原因、職涯規劃與薪資談判。
• onboarding_checklist.md：Offer 或入職前的公司查核清單。

本機工作區

候選人與職缺資料放在專案根目錄；以下目錄預設由 .gitignore 排除：

my-resume/
├── 完整履歷.md
└── 專案/*.md

interview-prepare/<company>/<role>/
├── jd_analysis.md
├── preparation_plan.md
├── interview_cheatsheet.md
└── mock_interview_qa.md

customize-resume/<date-time>/<company>/<role>/
interview-ppt/<date-time>/<company>/<role>/

interview-preparation 只負責前三份準備文件；互動式 mock interview 與 mock_interview_qa.md 由 $start-mock-interview 負責。

空白履歷骨架只代表工作區已初始化，不是可供履歷客製化或面試準備使用的 master resume。

使用方式

1. 不確定目前該做什麼時，啟動 $ask-how-to；它只會根據本專案狀態推薦下一個 Skill 或必要行動。
2. 第一次使用若缺少 my-resume/完整履歷.md，啟動 $initialize-interview-workspace，或接受 Agent 提出的初始化建議。
3. 填寫 my-resume/完整履歷.md，並在需要時補充 my-resume/專案/ 的詳細資料。
4. 明確啟動 $interview-preparation，提供目標公司、職缺、面試日期與 JD。
5. 準備文件完成後，明確啟動 $start-mock-interview，選擇練習模式或正式模擬。
6. Q&A 穩定後，依需求啟動 $render-mock-qa-html 或 $build-interview-practice-html。
7. 需要客製化履歷或簡報時，分別啟動 $build-tailored-resume 或 $build-interview-ppt。

設計原則

• $ask-how-to 只在本專案 Skills 之間提供唯讀路由，不自動呼叫其他 Skill，也不建立第二份流程或資料來源。
• 初始化 Skill 只在目標檔案不存在時建立 headers-only 骨架；不覆蓋既有履歷，也不代填候選人資料。
• 每個面試準備包只保留一份 mock_interview_qa.md，作為該準備包的唯一 canonical Q&A source。
• start-mock-interview 負責新增與更新 QA card；HTML Skills 只驗證、呈現或提供練習，不重新分類題目，也不建立第二份題庫。
• 題目透過 A/B/C、semantic ID 與 follow-up 關係管理；練習頁的進度只保存在瀏覽器 localStorage，不回寫 Markdown。
• 所有面試故事都應以真實經驗為基礎，不虛構專案、數字、職責或成果。
• 產生的 HTML 頁面可在本機離線使用，不依賴追蹤服務或網路資源。