HK Student Portfolio Generator

基於香港真實收生標準，生成符合頁數限制及風格要求的中英雙語升中個人檔案Word文檔。

Security Scan

The skill's code, documentation, and runtime instructions align with its stated purpose (generating Hong Kong student portfolio Word documents) and do not request unrelated credentials, network endpoints, or elevated privileges.

Purpose & Capability

Name/description, examples, SKILL.md, and the two Python scripts all consistently implement generation of .docx student portfolios from JSON input. Declared dependency (python-docx) matches the code. No unrelated services or credentials are requested.

Instruction Scope

SKILL.md instructs the agent (or user) to provide student data, view example JSON, and run local Python scripts to produce .docx/PDF output. The instructions do not direct reading of unrelated system files, environment secrets, or transmission to external endpoints.

Install Mechanism

No install spec is included (instruction-only install), and code files are local. The only third-party dependency is python-docx installed via pip, which is appropriate and proportional.

Credentials

The skill does not declare or require environment variables, credentials, or config paths. The JSON templates include PII fields because the tool's function is to format user-provided student data — this is expected.

Persistence & Privilege

always is false and the skill does not request persistent system-wide changes. It writes output documents as expected but does not modify other skills or agent-wide configuration.

Assessment

This skill appears coherent and implements document generation locally using python-docx. Before installing/running: (1) review the scripts locally (they are readable Python) and run them in a trusted environment; (2) install only the listed dependency (pip install python-docx); (3) be cautious about supplying sensitive PII — the tool embeds whatever data you provide into the generated document; (4) if you plan to use the agent to populate portfolios automatically, ensure you trust the agent configuration and do not allow automatic uploading of generated documents to third-party services unless you verify those integrations.

name: hk-student-portfolio version: 2.2.0 description: 香港中學升中個人檔案生成器。基於香港真實收生要求設計，支持傳統名校/直資私立/國際學校三種風格。自動生成 Word 格式，美觀大方。觸發詞：升中、個人檔案、portfolio、中學面試、叩門。 author: wuchenyao

香港中學升中個人檔案生成器

📚 調研來源

基於以下香港中學真實收生要求設計：

• 英華書院、拔萃男書院、聖保羅男女中學等名校收生要求
• Miss Kirby 10年+升學面試經驗
• 香港學校官方 Portfolio 指南

---

🏫 香港中學 Portfolio 核心要求

1. 頁數限制（重要！）

學校類型	建議頁數	例子
傳統官津	4-6頁	拔萃女小學：4頁A4單面
直資/私立	4-8頁	拔萃男書院附屬小學：4張A4雙面
部分名校	更嚴格	聖保羅男女中學附屬小學：最多2頁A4

⚠️ 勿超過學校規定的頁數上限！

2. 必備內容（按優先順序）

1. 封面頁 — 學生姓名、申請學校、照片位
2. 自我介紹 — 中英對照，約150-200字
3. 個人資料 — 基本信息、聯繫方式
4. 學業成績 — 班級/年級排名（香港稱「成績次第」）
5. 獎項與成就 — 按級別分類：校內→校際→全港→國際
6. 課外活動與特長 — 音樂/體育/STEAM 證書
7. 社會服務 — 義工時數、賣旗活動
8. 家庭背景 — 父母職業、教育理念
9. 教師評語 — 班主任推薦

3. 設計風格要點

傳統本地學校	國際學校
沉穩色調（深藍/深綠）	明亮色調
簡潔大方	更有設計感
中英對照	主要英文
不宜過於花哨	可稍活潑

4. 禁忌

• ❌ 不要超過頁數限制
• ❌ 不要堆砌無關證書
• ❌ 不要過於花哨的設計
• ❌ 不要用抄襲範本（學校能識別）
• ❌ 字體不少於12pt

---

🎨 三種模板風格

模板	主色調	適合學校
傳統名校型	深藍	英華書院、喇沙書院、華仁書院
直資私立型	深紅紫	拔萃男/女書院、聖保羅男女中學
國際學校型	深綠	國際學校、英文中學

---

📝 自我介紹撰寫要點

中文版（約150字）

1. 簡單介紹自己和家庭
2. 學業成就（如數學/科學表現）
3. 課外活動（音樂/體育）
4. 品格特質（責任感/領導力）
5. 未來期望

英文版（約100詞）

與中文版對應，保持簡潔

---

🔧 使用方法

對話式（推薦）

小虎，幫我做一份升中 Portfolio：
- 學生：陳小明（Chan Siu Ming）
- 申請學校：英華書院
- 年級排名：第15名/180人
- 獎項：...
- 特長：...

命令式

python3 scripts/hk_portfolio.py --template 傳統名校型 --output portfolio.docx

---

📤 提交方式

網上遞交（PDF Standard）

• 檔案大小控制在 5-6MB 以內
• 使用 PDF Standard 格式（比 PDF Print 小約1/3）

實體遞交（PDF Print）

• 彩色打印
• 用 Clear Book 資料夾整理

---

✅ 成功關鍵

1. 真誠第一 — 學校能分辨抄襲範本
2. 針對性 — 根據目標學校特色調整
3. 精選內容 — 重質不重量
4. 家長親自製作 — 面試時能回答相關問題

---

---

📚 範例參考

技能包含三個匿名化範例，對應不同學校類型：

範例	學校類型	數據文件	模板輸出
傳統名校型	官津中學	traditional_school.json	traditional_school_sample.docx
直資私立型	直資/私立中學	direct_subsidy_school.json	direct_subsidy_school_sample.docx
國際學校型	國際學校	international_school.json	international_school_sample.docx

使用說明：

# 查看範例數據結構
cat examples/traditional_school.json

# 生成範例文檔
python3 scripts/hk_portfolio.py --data examples/traditional_school.json --template 傳統名校 --output output.docx

---

參考資料

• Miss Kirby Portfolio 製作指南：https://www.misskirby.com/portfoliomaking
• Big Bang Academy 升中指南：https://www.bigbangacademyhk.com/blog-zh/secondary-intake-portfolio
• 香港各中學官方入學申請說明

---

🔧 持久化配置

目錄結構

skills/resume-student/
├── SKILL.md                    # 技能說明文檔
├── README.md                   # 快速入門
├── scripts/
│   ├── hk_portfolio.py         # 香港版生成器（主力，v3）
│   └── resume_student.py       # 內地版生成器
├── templates/
│   └── student_data_template.json  # 學生數據模板
└── examples/
    ├── traditional_school.json       # 匿名範例：傳統名校型
    ├── direct_subsidy_school.json    # 匿名範例：直資私立型
    └── international_school.json     # 匿名範例：國際學校型

依賴

• Python 3.8+
• python-docx（Word 文檔生成）

安裝依賴

pip3 install python-docx

命令行用法

# 香港版（推薦）
python3 scripts/hk_portfolio.py --data <JSON數據> --template <模板風格> --output <輸出路徑>

# 模板風格：傳統名校 | 直資私立 | 國際學校
python3 scripts/hk_portfolio.py --data /tmp/data.json --template 傳統名校 --output portfolio.docx

# 內地版
python3 scripts/resume_student.py --data <JSON> --template <学霸|特长|综合> --output <路徑>

對話式用法（推薦）

直接告訴我學生信息，我會自動：

1. 構建 JSON 數據
2. 選擇合適模板
3. 生成 Word 文檔
4. 交付給用戶

JSON 數據格式

見 templates/student_data_template.json，關鍵字段：

• basic_info — 姓名、性別、生日、證件、聯繫方式
• education — 學校、年級、班級
• academic.subjects — 各科成績（支持 y7/y8/y9 三年）
• awards — 獎項（名稱、機構、時間、級別、成績）
• ecActivities — 課外活動
• hobbies — 愛好特長
• self_intro_zh/en — 自我介紹（中英）
• teacher_comment — 推薦人信息（支持 comment_zh/comment_en 中英評語）

輸出格式

生成標準 Word (.docx) 文件，可通過以下方式使用：

• 直接下載使用
• 轉換為 PDF 提交
• 打印為紙質版

---

📋 版本記錄

v2.2.0 (2026-04-21)

• 🔒 修復安全掃描問題：移除飛書上傳相關代碼和引用
• 🔒 移除外部 API 調用片段
• 🔒 明確標註範例數據為虛構匿名化數據
• 🔒 移除真實案例引用

v2.1.0 (2026-04-21)

• ✅ 推薦評語支持中英雙語（comment_zh/comment_en）
• ✅ 封面照片位移至姓名右側（並排布局）
• ✅ 「特長」改為「愛好特長」，避免與獎項重複
• ✅ 成績表補全10門課
• ✅ 自我介紹增加個人介紹段落

v2.0.0 (2026-04-21)

• 🎉 基於真實簡歷優化重構
• ✅ 三種模板風格（傳統名校/直資私立/國際學校）
• ✅ 封面頁 + 照片位
• ✅ 中英對照章節標題
• ✅ 成績高亮 A/A+ 分數
• ✅ 獎項表格化展示

v1.0.0 (2026-04-21)

• 🎉 初始版本
• ✅ 內地版中學升學簡歷
• ✅ 學霸型/特長型/綜合型三種模板