功能描述

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

使用说明 (SKILL.md)

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

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

Name: HK Student Portfolio Generator
Author: wuchenyao-tech

📚 調研來源

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

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

🏫 香港中學 Portfolio 核心要求

1. 頁數限制（重要！）

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

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

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

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

3. 設計風格要點

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

4. 禁忌

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

🎨 三種模板風格

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

📝 自我介紹撰寫要點

中文版（約150字）

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

英文版（約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 資料夾整理

✅ 成功關鍵

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

📚 範例參考

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

範例	學校類型	數據文件	模板輸出
傳統名校型	官津中學	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 \x3CJSON數據> --template \x3C模板風格> --output \x3C輸出路徑>

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

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

對話式用法（推薦）

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

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

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)

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

安全使用建议

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.

功能分析

Type: OpenClaw Skill Name: hk-student-portfolio Version: 2.2.0 The skill bundle is a legitimate utility for generating student portfolios and resumes in Word format. The Python scripts (hk_portfolio.py and resume_student.py) use the standard python-docx library to transform JSON data into styled documents without any network calls, shell execution, or unauthorized file access. The SKILL.md and README.md files provide clear instructions for the AI agent and users, and the version history specifically notes the removal of external API calls and upload features to improve security.

能力评估

✓ 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.

版本历史

v2.2.0

Security fix: removed external API calls and Feishu upload references. All example data is clearly fictional/anonymized. No outbound network requests.

v2.1.0

Initial release

元数据

Slug hk-student-portfolio

版本 2.2.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题

HK Student Portfolio Generator 是什么？

基於香港真實收生標準，生成符合頁數限制及風格要求的中英雙語升中個人檔案Word文檔。它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 118 次。

如何安装 HK Student Portfolio Generator？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install hk-student-portfolio」即可一键安装，无需额外配置。

HK Student Portfolio Generator 是免费的吗？

是的，HK Student Portfolio Generator 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

HK Student Portfolio Generator 支持哪些平台？

HK Student Portfolio Generator 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 HK Student Portfolio Generator？

由 wuchenyao-tech（@wuchenyao-tech）开发并维护，当前版本 v2.2.0。

HK Student Portfolio Generator