college-application

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

College Application

College Application

把志愿填报视为“认识自己 → 理解职业/专业/行业 → 用招生数据约束选择 → 生成可审计报告”的决策过程。主交互在 Agent 对话中完成;HTML 只用于最终报告展示,不再作为主要填写入口。
Treat college application planning as a decision process of “understand yourself → understand careers/majors/industries → constrain choices with admissions data → generate an auditable report.” The main interaction takes place in the Agent conversation; HTML is used only to present the final report and is no longer the primary data-entry interface.

不可省略的声明

Mandatory disclaimer

启动后先告诉用户:本服务仅供高考志愿决策参考,所有性格分析、职业建议、行业判断和录取估算都基于公开来源与模型推断,不能替代各省教育考试院、高校招生章程、官方志愿填报系统或老师/家长意见;最终选择必须交叉验证。最终 HTML 报告顶部和底部也必须显示同样提示。
At startup, first tell the user: This service is for reference only when making Gaokao college application decisions. All personality analyses, career recommendations, industry assessments, and admission estimates are based on public sources and model inferences; they cannot replace the provincial education examination authority, the university’s admissions prospectus, the official application system, or input from teachers or parents. Final choices must be cross-checked. The same notice must appear at both the top and bottom of the final HTML report.

工作区文件

Workspace files

  • CANDIDATE.md
    :考生画像、性格测评摘要、职业方向假设、高考信息。格式见 CANDIDATE-FORMAT.md。
  • PERSONALITY-REPORT.md
    :性格测试计分、解释、职业方向假设。格式见 PERSONALITY-REPORT-FORMAT.md。
  • SOURCES.md
    :所有理论、行业、专业、招生数据的来源台账。格式见 SOURCES-FORMAT.md。
  • plans/*.md
    :职业/专业研究、志愿建议、最终方案。格式见 PLAN-FORMAT.md。
  • final-report.html
    :最终可浏览报告,使用 assets/final-report-template.html。
  • history/events.jsonl
    、
    decision-records/*.md
    、
    audits/*.md
    :如需长期跟踪或独立审计,沿用对应格式文件。
旧版
assets/college-application-template.html
与
scripts/wait_for_request.py
/
complete_request.py
/
update_progress.py
/
fail_request.py
属于网页任务队列工作台的 legacy 兼容资产。新版主流程不要要求用户打开网页填写,也不要把等待器作为必经步骤。
  • CANDIDATE.md
    : Candidate profile, personality assessment summary, career-direction hypotheses, and Gaokao information. See CANDIDATE-FORMAT.md for the format.
  • PERSONALITY-REPORT.md
    : Personality test scoring, interpretation, and career-direction hypotheses. See PERSONALITY-REPORT-FORMAT.md for the format.
  • SOURCES.md
    : Source ledger for all theories, industry, major, and admissions data. See SOURCES-FORMAT.md for the format.
  • plans/*.md
    : Career/major research, application recommendations, and final plan. See PLAN-FORMAT.md for the format.
  • final-report.html
    : Final browsable report, using assets/final-report-template.html.
  • history/events.jsonl
    ,
    decision-records/*.md
    ,
    audits/*.md
    : If long-term tracking or an independent audit is needed, follow the corresponding format files.
The legacy
assets/college-application-template.html
and
scripts/wait_for_request.py
/
complete_request.py
/
update_progress.py
/
fail_request.py
are legacy compatibility assets for the web task queue workbench. The new main flow must not require the user to open a web page for data entry or make the waiter a mandatory step.

固定对话流程

Fixed dialogue flow

1. 生成性格测试 HTML 表单

1. Generate a personality assessment HTML form

使用脚本从 assets/personality-assessment-form.html 生成一份静态 HTML 表单,交给用户在浏览器里填写:
bash
python3 <skill-dir>/scripts/create_assessment.py \
  --workspace <考生工作区绝对路径> \
  --open
--open
会自动用系统默认浏览器打开表单,避免用户自己去文件夹里找。脚本默认输出类似
<workspace>/personality-assessment-YYYY-MM-DD.html
的文件路径。把这个文件路径告诉用户,并说明:请用浏览器打开 HTML 表单,填完后点击“下载给 Agent 的 JSON”,再把下载的 JSON 文件发回、粘贴内容,或授权 Agent 读取该文件。不要要求用户在终端聊天里逐题填写。
Markdown 模板 assets/personality-assessment-template.md 只作为 fallback:用户无法打开 HTML 时,可运行
create_assessment.py --format md
生成可填写 Markdown。
表格基于 RIASEC 职业兴趣与 Mini-IPIP 大五人格短量表,总计 32 题,1–5 分。
Use the script to generate a static HTML form from assets/personality-assessment-form.html and give it to the user to complete in a browser:
bash
python3 <skill-dir>/scripts/create_assessment.py \
  --workspace <candidate workspace absolute path> \
  --open
--open
automatically opens the form in the system’s default browser, so the user does not have to find it in a folder. The script outputs a file path such as
<workspace>/personality-assessment-YYYY-MM-DD.html
by default. Tell the user the file path and explain: Please open the HTML form in your browser, and after completing it, click “Download JSON for Agent,” then send the downloaded JSON file back, paste its contents, or authorize the Agent to read the file. Do not ask the user to complete the questions one by one in the terminal chat.
The Markdown template assets/personality-assessment-template.md is only a fallback: if the user cannot open the HTML, run
create_assessment.py --format md
to generate a fillable Markdown form.
The questionnaire is based on the RIASEC Career Interest Inventory and the Mini-IPIP abbreviated Big Five personality inventory, with 32 items scored from 1 to 5.

2. 生成性格与职业方向报告

2. Generate a personality and career direction report

解析用户发回的性格测试结果 JSON(或 fallback Markdown),按模板内规则计分。计分后先生成一份可读 HTML 报告,方便用户确认自己看得懂:
bash
python3 <skill-dir>/scripts/render_personality_report.py \
  --input <personality-assessment-result.json> \
  --output <考生工作区绝对路径>/personality-report.html
报告应先给白话重点结论,再把完整得分表和局限放在后面展开。
  • RIASEC:得到前三码,如
    I-A-S
    。
  • Big Five:计算开放性、尽责性、外向性、宜人性、神经质相对水平,反向题必须倒转。
  • 输出 3–6 个职业方向假设,每个方向都写“支持证据 / 反证或风险 / 需要现实验证的问题”。
性格测试只能作为方向线索,不得把测试结果写成诊断或命运结论。
Parse the personality assessment result JSON returned by the user (or the fallback Markdown), and score it according to the rules in the template. After scoring, first generate a readable HTML report so the user can confirm that they understand it:
bash
python3 <skill-dir>/scripts/render_personality_report.py \
  --input <personality-assessment-result.json> \
  --output <candidate workspace absolute path>/personality-report.html
The report should present plain-language key conclusions first, followed by the full score table and limitations in expanded form.
  • RIASEC: Obtain the top three codes, such as
    I-A-S
    .
  • Big Five: Calculate relative levels of Openness, Conscientiousness, Extraversion, Agreeableness, and Neuroticism; reverse-scored items must be reversed.
  • Output 3–6 career direction hypotheses. For each direction, include “supporting evidence / counterevidence or risks / questions requiring real-world validation.”
The personality test can only serve as a directional clue; do not present its results as a diagnosis or a verdict on the person’s fate.

3. 职业、专业与行业深度研究

3. Conduct in-depth research on careers, majors, and industries

围绕职业方向假设生成 3–6 个专业簇。每个专业簇必须研究:
  • 真实学习内容、核心课程、培养方案差异。
  • 真实工作日常、职业出口、跨专业路径、继续深造路径。
  • 行业需求、地域分布、学历门槛、资格门槛、AI/自动化影响。
  • 适合与不适合该方向的证据。
  • 可点击、可追溯来源。
优先来源:教育部专业目录、阳光高考、高校官网培养方案/招生章程/就业质量报告、国家统计局、人社部门、行业主管部门、权威行业协会。招聘网站和商业报告只能作辅助信号,必须说明样本偏差。
Generate 3–6 major clusters around the career direction hypotheses. Every major cluster must be researched for the following:
  • Actual learning content, core courses, and differences in curriculum structure.
  • Real day-to-day work, career outcomes, cross-major pathways, and pathways for further study.
  • Industry demand, geographic distribution, degree requirements, qualification requirements, and the impact of AI/automation.
  • Evidence supporting and contraindicating fit with this direction.
  • Clickable, traceable sources.
Preferred sources include the Ministry of Education’s major catalog, Sunshine Gaokao, official university websites for curriculum plans/admissions prospectus/employment quality reports, the National Bureau of Statistics, human resources and social security departments, industry regulators, and authoritative industry associations. Job boards and commercial reports may be used only as supplementary signals, and any sample bias must be stated.

4. 生成高考信息 HTML 表单

4. Generate a Gaokao information HTML form

使用脚本从 assets/admission-info-form.html 生成一份静态 HTML 表单,交给用户在浏览器里填写:
bash
python3 <skill-dir>/scripts/create_admission_info.py \
  --workspace <考生工作区绝对路径> \
  --open
--open
会自动用系统默认浏览器打开表单,避免用户自己去文件夹里找。脚本默认输出类似
<workspace>/admission-info-YYYY-MM-DD.html
的文件路径。把这个文件路径告诉用户,并说明:请用浏览器打开 HTML 表单,填完后点击“下载给 Agent 的 JSON”,再把下载的 JSON 文件发回、粘贴内容,或授权 Agent 读取该文件。不要要求用户在终端聊天里逐项填写。
Markdown 模板 assets/admission-info-template.md 只作为 fallback:用户无法打开 HTML 时,可运行
create_admission_info.py --format md
生成可填写 Markdown。
高考信息文档必须覆盖:
项目要求
招生省份必填
填报年份默认当前年份,可修改
意向填报地区可多个;区分必须/优先/无所谓
考试模式由省份按 references/province-exam-mode.md 自动带出并复核
选科按 3+3 或 3+1+2 校验;物理与历史互斥
高考成绩 / 全省位次至少填一项;位次优先
批次/类别/特殊资格如普通类、专项计划、中外合作等
学费、家庭等现实约束可选但要主动提示;不主动收集健康/体检隐私信息,相关专业限制由用户自行查招生章程
信息不完整时先补信息,不要直接生成志愿建议。
Use the script to generate a static HTML form from assets/admission-info-form.html and give it to the user to complete in a browser:
bash
python3 <skill-dir>/scripts/create_admission_info.py \
  --workspace <candidate workspace absolute path> \
  --open
--open
automatically opens the form in the system’s default browser, so the user does not have to find it in a folder. The script outputs a file path such as
<workspace>/admission-info-YYYY-MM-DD.html
by default. Tell the user the file path and explain: Please open the HTML form in your browser, and after completing it, click “Download JSON for Agent,” then send the downloaded JSON file back, paste its contents, or authorize the Agent to read the file. Do not ask the user to complete the fields one by one in the terminal chat.
The Markdown template assets/admission-info-template.md is only a fallback: if the user cannot open the HTML, run
create_admission_info.py --format md
to generate a fillable Markdown form.
The Gaokao information document must cover the following:
ItemRequirement
Admissions provinceRequired
Application yearDefaults to the current year and can be changed
Preferred application regionsMultiple selections allowed; distinguish required/preferred/no preference
Examination formatAutomatically populated and reviewed based on the province according to references/province-exam-mode.md
Subject selectionValidate under 3+3 or 3+1+2; Physics and History are mutually exclusive
Gaokao score / provincial rankAt least one is required; rank takes priority
Batch/category/special eligibilityFor example, regular category, special plans, Sino-foreign cooperation, etc.
Tuition, family circumstances, and other practical constraintsOptional but should be proactively raised; do not proactively collect private health or medical-examination information; the user should check the admissions prospectus for related major restrictions
If information is incomplete, obtain the missing information first rather than directly generating application recommendations.

5. 录取机会估算与志愿建议

5. Estimate admission opportunities and provide application recommendations

按 references/admission-estimation.md 执行。优先比较位次;只有满足至少 3 个可比年份、当年计划已发布、口径一致、来源可核验时,才可输出区间式概率。否则只输出“冲刺 / 有机会 / 较稳 / 兜底”定性等级,并明确缺少哪些数据。
严禁把聚合站、自媒体、论坛或未注明年份的投档线作为关键依据。关键招生事实必须回到省教育考试院、教育部阳光高考或高校本科招生网复核。
Follow references/admission-estimation.md. Prioritize comparisons by rank. Output an interval probability only when there are at least three comparable years, the current year’s enrollment plan has been published, the definitions are consistent, and the sources are verifiable. Otherwise, output only qualitative levels—“Reach / Possible / Relatively Safe / Safety”—and clearly state which data are missing.
Never use aggregators, self-media accounts, forums, or cutoff scores without a stated year as key evidence. Critical admissions facts must be checked against the provincial education examination authority, Sunshine Gaokao, or the university’s official undergraduate admissions website.

Agent 主动取数策略

Agent proactive data retrieval strategy

如果用户只提供分数、没提供位次,Agent 应先尝试从省教育考试院官方一分一段表获取对应年份的位次参考;若当年数据未发布,可用最近年份估算“参考位次”,但必须标注不可替代真实位次。只有官方来源找不到、页面失效或用户所在省数据不可获得时,才要求用户上传/提供一分一段表、招生计划或投档线文件。
If the user provides only a score and no rank, the Agent should first attempt to retrieve the corresponding year’s official score-to-rank table from the provincial education examination authority. If data for the current year have not been published, the most recent year may be used to estimate a “reference rank,” but it must be explicitly stated that this cannot replace the actual rank. Only when no official source can be found, the page is no longer accessible, or data for the user’s province are unavailable should the user be asked to upload or provide a score-to-rank table, enrollment plan, or cutoff-score file.

6. 生成最终 HTML 报告

6. Generate the final HTML report

最终报告优先使用脚本渲染:
bash
python3 <skill-dir>/scripts/render_report.py \
  --workspace <考生工作区绝对路径> \
  --output <考生工作区绝对路径>/final-report.html
脚本读取工作区中的
research.json
、
CANDIDATE.md
、
PERSONALITY-REPORT.md
、
SOURCES.md
,套用 assets/final-report-template.html。缺字段时显示“待补充 / 无法查证”,不得自动编造内容。
最终报告先展示重点结论:方向是否匹配、当前数据够不够、下一步要补什么。完整性格得分、专业行业细节、方法、不确定性和来源台账放到后面折叠展开,避免用户一打开就被专业术语淹没。
最终报告至少包含:
  • 顶部“仅供参考 / 必须交叉验证 / 不构成录取承诺”声明。
  • 性格测试结果:RIASEC、Big Five、解释与局限。
  • 适合职业方向与专业簇:匹配证据、反证、现实探索建议。
  • 职业/专业/行业深度分析:学习内容、工作日常、趋势、门槛、风险。
  • 高考信息与录取分析:省份、模式、选科、分数/位次、数据口径、冲稳保建议。
  • 来源台账:完整 URL、发布机构、年份/口径、最后核验日期、状态。
  • 无法查证或数据不足的结论必须单独标出,不得混在确定结论里。
The final report should preferably be rendered with the script:
bash
python3 <skill-dir>/scripts/render_report.py \
  --workspace <candidate workspace absolute path> \
  --output <candidate workspace absolute path>/final-report.html
The script reads
research.json
,
CANDIDATE.md
,
PERSONALITY-REPORT.md
, and
SOURCES.md
from the workspace, and applies assets/final-report-template.html. When fields are missing, display “To be supplemented / Unverifiable”; never fabricate content.
The final report should first present the key conclusions: whether the direction is a good match, whether the current data are sufficient, and what to add next. Put the full personality scores, detailed major and industry information, methodology, uncertainties, and source ledger in expanded collapsible sections later, so that the user is not overwhelmed by technical terminology as soon as they open the report.
The final report must include at least the following:
  • A “For reference only / Must be cross-checked / Does not constitute an admission guarantee” notice at the top.
  • Personality assessment results: RIASEC, Big Five, interpretation, and limitations.
  • Suitable career directions and major clusters: matching evidence, counterevidence, and practical exploration recommendations.
  • In-depth analysis of careers, majors, and industries: learning content, day-to-day work, trends, requirements, and risks.
  • Gaokao information and admission analysis: province, examination format, subject selection, score/rank, data definitions, and reach/match/safety recommendations.
  • Source ledger: full URL, publishing organization, year/definition, last verification date, and status.
  • Conclusions that cannot be verified or lack sufficient data must be marked separately and must not be mixed with definitive conclusions.

7. 可选独立审计

7. Optional independent audit

用户要求复核、报告用于重要决策、或 Agent 对关键来源不确定时,启动全新 subagent 按 AUDIT-FORMAT.md 独立审计。审计不通过时,不得显示“可用于正式填报”。
If the user requests a review, the report will be used for an important decision, or the Agent is uncertain about a key source, launch a fresh subagent to conduct an independent audit according to AUDIT-FORMAT.md. If the audit does not pass, do not display “Approved for formal submission.”

来源与诚实边界

Sources and honesty boundaries

  • 每个外部事实、行业判断、专业信息、招生规则、投档数据和概率输入都必须有
    source_ids
    ,并能追溯到
    SOURCES.md
    的完整 URL。
  • 搜索结果摘要不是来源;Tavily/WebSearch 只能发现链接,不能直接支撑结论。
  • 页面失效、来源冲突、年份不匹配、口径不一致时,要明确写“无法查证 / 存在冲突 / 仅作辅助线索”。
  • 不输出“稳录”“保证录取”“100%”等承诺性措辞。
  • Every external fact, industry assessment, major-related fact, admissions rule, cutoff-score datum, and probability input must have
    source_ids
    and be traceable to the full URL in
    SOURCES.md
    .
  • Search-result snippets are not sources; Tavily/WebSearch can only be used to discover links and cannot directly support conclusions.
  • If a page is no longer accessible, sources conflict, years do not match, or definitions are inconsistent, explicitly state “Unverifiable / Conflicting / Supplementary clue only.”
  • Do not output promise-based wording such as “guaranteed admission,” “assured admission,” or “100%.”