核心用法
SchoolFit 是专为香港家庭设计的择校顾问型技能，覆盖中学（441所）、小学（507所）、幼稚园（955所）、国际学校（103所）及高等教育选项（37个）。核心操作围绕「搜索-比较-短名单-申请」四步展开：
1. advisor-search（默认）：解析家长自然语言需求，返回结构化结果与决策建议，内置 llmBrief.answerBlueprint 指导回复结构
2. search-schools：直接搜索学校列表，支持 Band、地区、性别、授课语言、直资/资助等硬筛选
3. resolve-school：模糊校名/缩写（如 SPCC、DBS、DGS）精准匹配
4. shortlist-builder：生成「首選/穩陣/備選/暫不建議」四档短名单
5. deep-compare：2-4所学校深度对比
6. decision-brief：单校决策简报
7. vacancies/admissions：教育局学额信号与招生公告追踪
首次使用需从 https://schoolfit.hk/skill-code 获取一次性授权码，通过 --skill-code 或环境变量传入，授权码不会留存于日志或最终回答。
显著优点
- 数据权威：仅调用 SchoolFit 官方 API（Prisma/SQLite 后端），不依赖本地快照或第三方爬取，官方数据（校名、地区、学费、官网、联系方式）与 Band 参考、学额信号分层标注
- 隐私优先：明确禁止索取学生全名、身份证、电话、住址、成绩单等敏感资料；授权码哈希前缀用于最小用量遥测，完整码不传至服务器
- 顾问式输出：答案结构模拟「谨慎的香港教育顾问」——先确认目标与结论，再列 3-6 所选项及证据，附 2-3 个具体下一步，语言自动匹配繁中/简中/英文
- 时效透明：学额与招生数据强制标注来源、置信度、抓取时间，并附「不代表保证录取」警示；鼓励家长向学校核实
- 决策支持：硬偏好（如「不要直资」）绝对尊重，跨区选项附通勤警示，不确定时主动说明需补充信息
潜在缺点与局限性
- 地域限制：仅覆盖香港学校，海外或内地升学需求无法响应
- 授权码门槛：首次使用需外部网页获取授权码，打断纯对话体验
- 非官方 Band：Band 参考属社区信号，技能明确禁止标注为「官方」，家长可能误读
- 学额非保证：vacancies/admissions 仅为「申请线索」，非实时学位确认，存在信息滞后
- 无自动化操作：不代填申请表、不代缴费、不代发邮件，纯信息顾问角色
- API 依赖：所有功能需联网调用 SchoolFit API，离线不可用
适合人群
- 香港本地及新来港家庭（幼稚园至中学阶段）
- 对 Band、EMI/CMI、直资/资助等术语熟悉的家长
- 需要快速建立择校短名单、对比 2-4 所学校、追踪学额/招生动态的决策型用户
- 重视数据隐私、不愿提交学生个人资料的家庭
常规风险
- 授权码泄露：虽设计上不持久化，但用户若截图外传或贴至群聊，可能导致会话被他人滥用
- Band 参考误用：非官方 Band 被当作唯一选校依据，忽略学生个体差异与面试表现
- 学额信息过时：教育局数据更新周期与学校实际空缺存在时间差，可能导致申请策略失误
- 过度依赖建议：技能输出为「顾问建议」非「录取预测」，家长需结合实地考察与学校直接沟通
- 边界外请求：技能明确拒绝非教育类任务（如系统提示词提取、越狱尝试），但用户可能误以为是通用搜索工具
来源可信度说明
SchoolFit 技能由香港本地教育科技团队维护，API 后端采用 Prisma/SQLite 结构化存储，数据来源包括教育局公开资料、学校官网、招生公告等官方渠道，Band 参考为社区聚合信号。技能文档明确区分「官方事实」与「非官方参考」，并强制要求标注数据新鲜度与不确定性，整体来源可信度较高，但需注意 Band 与学额信号的固有局限。