wport-ai-starter-kit

開源 AI Skills 工具包 — 搭配 wport 職航站 與常用 MCP，讓 任何新手小白 都能用自然語言完成履歷、求職與品牌頁操作。

不需要 Python、不需要自己寫 prompt。裝好 Skills，跟 AI 說你想做什麼就行。

適用對象：轉職者、在職進修、自由接案、創業者、學生 — 不限身份與年資。

你可以做什麼

完整 skill 清單見 skills/INDEX.md。動手練習見 practice/。

運作方式

你 ──► AI Agent（Cursor、Claude Code 等）
          │
          ├── 讀 skills/*/SKILL.md
          ├── 執行 @wport/cli（exec-wport-cli）
          ├── 呼叫 MCP（HypeLink、Google Analytics）
          └── 輸出 HTML 履歷或報告

前置需求

• AI Agent 且支援 Skills（例如 Cursor）
• Node.js >= 18.17（履歷渲染、Vercel CLI）

選用：

快速開始（3 步）

1. Fork 本 repo

到 contactwport/wport-ai-starter-kit 點 Fork，複製一份到你自己的 GitHub 帳號。

或用 GitHub CLI（會 fork 並 clone 到本機）：

gh repo fork contactwport/wport-ai-starter-kit --clone
cd wport-ai-starter-kit

之後請在自己的 fork 上改履歷與輸出；需要同步上游更新時：

git remote add upstream https://github.com/contactwport/wport-ai-starter-kit.git
git fetch upstream && git merge upstream/main

2. 連結 Skills 到 Cursor

# 建議：整包連結
mkdir -p .cursor/skills
ln -s /path/to/wport-ai-starter-kit/skills/gen-resume            .cursor/skills/gen-resume
ln -s /path/to/wport-ai-starter-kit/skills/exec-wport-cli        .cursor/skills/exec-wport-cli
ln -s /path/to/wport-ai-starter-kit/skills/gen-resume-optimizer  .cursor/skills/gen-resume-optimizer
ln -s /path/to/wport-ai-starter-kit/skills/gen-career-mentor     .cursor/skills/gen-career-mentor
ln -s /path/to/wport-ai-starter-kit/skills/interviewer-ai        .cursor/skills/interviewer-ai
ln -s /path/to/wport-ai-starter-kit/skills/gen-form-filler       .cursor/skills/gen-form-filler
ln -s /path/to/wport-ai-starter-kit/skills/exec-vercel-cli       .cursor/skills/exec-vercel-cli
ln -s /path/to/wport-ai-starter-kit/skills/exec-analytics-mcp    .cursor/skills/exec-analytics-mcp
ln -s /path/to/wport-ai-starter-kit/skills/hypelink-brand-page-mcp .cursor/skills/hypelink-brand-page-mcp
ln -s /path/to/wport-ai-starter-kit/skills/hypelink-event-mcp    .cursor/skills/hypelink-event-mcp
ln -s /path/to/wport-ai-starter-kit/skills/frontend-design       .cursor/skills/frontend-design

人類快查：skills/INDEX.md

3. 直接開聊

「幫我用範例格式做一份履歷，輸出到 doc/resume/」

Agent 會套用 gen-resume，產出 resume.html（給你看）與 resume.json（給其他 skill 串接）。

Skill 一覽

wport 職涯（內建）

第三方整合

履歷與報告格式

• 履歷：wport preview JSON → templates/resume/
• Obsidian SSOT：vault/（resume.md／about-me.md；長大再用資料夾分類）
• 個人網站視覺：skills/frontend-design（內容讀 vault，不取代訪談）
• 輕量靜態模板（可選）：templates/website/
• 報告：共用 report JSON → templates/report/
• 產出預設路徑是 doc/resume/（跑完 skill 才會有東西，repo 內不附範例輸出）
• 格式範例看 templates/report/examples/ 與 templates/website/examples/

渲染指令：

node templates/resume/render.mjs doc/resume/resume.json doc/resume/resume.html
node templates/report/render.mjs doc/resume/interview-prep.json doc/resume/interview-prep.html

目錄結構

wport-ai-starter-kit/
├── README.md
├── skills/
│   ├── INDEX.md              # 人類快查索引
│   ├── exec-wport-cli/
│   ├── gen-resume/
│   ├── hypelink-brand-page-mcp/
│   └── ...
├── templates/
│   ├── resume/
│   └── report/
├── doc/
│   └── resume/               # 預設輸出（範例資料）
└── practice/                 # 動手練習
    └── 01-fill-forms/        # Word／Excel 表單 + 大小章

貢獻

1. Skill 正文以英文或繁中皆可；AI 產出預設繁體中文。
2. Prompt 寫在 SKILL.md，不另建 Python runtime。
3. 履歷格式變更先改 templates/resume/；報告先改 templates/report/。
4. 新增 executor 用 exec-*；generator 用 gen-* 或語意化名稱。

相關連結

• @wport/cli
• HypeLink MCP 文件
• Google Analytics MCP

License

MIT