申请季时间线 / Application Timeline Builder

从各校的截止日往回推，排出整个申请季的节点，并落进学生的日程。

申请季真正杀人的不是文书难写，是有些事必须提前很久启动： 推荐信要给老师留几周、送分要留处理时间、成绩单要走学校流程。 学生通常在 10 月底才发现这些事该在 9 月做。

何时使用 / When to use

• 申请季开始前，学生想知道整体节奏
• 学生已经定了几所学校和轮次，要排具体节点
• 中途加了一所学校，要看会不会跟已有安排撞车

不适用于 / Not for：

• 只想换算一个截止日到北京时间 —— 直接用 resolve_deadline（没有这个工具就只跑下文降级一节的换算命令），不必起 skill
• 压缩活动栏文案 —— 那是 activity-list-optimizer
• 评估现有材料的成色 —— 那是 admissions-reader

需要的输入 / Inputs

输入	必填	说明
申请清单	是	哪些学校、走哪一轮。清单空着才问，问就用 ask_user 给选项
各校截止日	是	优先用申请清单里已有的；没有再查 get_school_requirements
学生档案	否	年级与课程体系，用来判断标化与成绩单的节奏

截止日的可信度 —— 这一节不能跳

get_school_requirements 返回的学校分两种：

• verified: true —— 有 deadlines，核对过官网，可以直接用
• verified: false —— 没有 deadlines 字段，本地一个日期都没存

看到 verified: false 时：

1. 不要把"字段缺席"读成"这所学校没有早申"
2. 不要凭印象填一个日期。 "藤校 ED 都是 11 月 1 日"这个印象本身就是错的—— 同一年里有学校是 11 月 1 日、有学校因为撞上周末顺延到 11 月 2 日
3. 把该校的 requirementsUrl 给学生，请他去官网抄下截止日再回来
4. 拿到之后用 propose_application 记进申请清单，这样下次不用再查

返回里的 unverifiedWarning 要转述给学生，不要私自吞掉。

流程 / Process

1. 读清单：get_applications 拿到已有申请（返回里已经带好北京时间与倒计时，不必再算一遍）。

2. 补缺口：清单里没有的学校查 get_school_requirements；查不到或未核实的按上一节处理。

3. 换算：所有截止日过 resolve_deadline 换成北京时间。 warnings 里凡是提到夏令时切换的，必须转述——11 月初 ET 从 EDT 切回 EST， 北京时间会整整差一小时，而 ED/EA 的截止日正好压在那几天。

4. 直接倒推排完，对每个已核实的截止日往回排。

   下面的提前量是保守的排程默认值，不是平台承诺或统一行业标准；学生、推荐人和学校的实际要求优先。 最近核对：2026-09-11。流程依据： Common App — First-year application guide； College Board — Sending SAT scores。 这些来源用于核对申请材料与送分流程，不规定下表的统一提前天数；表中区间是本 skill 的保守经验值。 每个申请季开始前应复核这些来源和目标学校官网；若上游流程变化影响默认提前量，更新核对日期并发布 PATCH 版本。

   节点	相对截止日	为什么这么早
   请老师写推荐信	提前 4–6 周	老师同时被十几个学生请托，最晚的那批质量最差
   主文书定稿	提前 3–4 周	留出补充文书的时间
   补充文书初稿	提前 2–3 周	每校一套，数量比想象中多
   送分 / 成绩单	提前 2–3 周	走机构与学校流程，不受你控制
   全部材料自查	提前 3–5 天	活动栏字符数、各篇文书字数对照上限再核一遍（活动栏交给 activity-list-optimizer）

   不要问"要不要我排"、"这个节奏可以吗"——把时间线排出来给他看，他会直接说哪里不合适。

5. 合并同类：多所学校共用的节点（主文书定稿、送分）合成一条，按最早的那个截止日排。 十所学校排出十条"主文书定稿"是噪音。

6. 只问必须他定的：清单为空、或某校的轮次不明时，用 ask_user 一次问完，给选项：

   「<校名> 你打算走哪一轮？」ED / EA / RD / 还没想好

   ED 是有约束力的承诺，这个决定只能他自己做。 但也仅此而已—— 提前量、节点粒度、要不要留缓冲这些不用问，按上表排就是。

7. 查冲突：节点撞上已有的考试或大考月份时点出来，把取舍摆给他。

8. 提案：propose_events 提案为短期事项，category 用 application， 这样它们会和申请截止日排在同一条时间线上。

输出格式 / Output

## 截止日（北京时间）
| 学校 | 轮次 | 当地 | 北京时间 | 剩余 | 来源 |
|---|---|---|---|---|---|
| <校名> | ED | 11-02 23:59 EST | 11-03 12:59 | 90 天 | 已核实 / **待你确认** |

<夏令时或其他 warning 的转述>

## 倒推节点
- <日期> —— <动作>（为了 <哪个截止日>）
...

## 需要你先确认的
- <校名>：本地没有核实过的截止日，去 <requirementsUrl> 抄一下告诉我

然后调 propose_events 出卡。待确认的学校不要排节点——建在假日期上的时间线比没有更危险。 已核实的那几所照排，不要因为有一所待确认就整份都不给。

没有这些工具时（降级） / Without these tools (degraded mode)

上面的流程按 nestudy 的工具写。在 Claude Code 或其他没有这些工具的环境里，流程、输出格式和边界都不变， 只把工具换成下表的做法，并在回复开头写明「降级：没有 nestudy 工具，截止日由你从官网抄来，时区由本地命令换算」。

工具	没有时怎么做
get_applications	请学生贴出申请清单：学校、轮次，以及官网写的截止日期、时间和时区
get_school_requirements	没有核实过的本地数据：每所学校都按上文 verified: false 那一路走，请学生去该校官网抄下截止日再排，来源一栏写「官网，学生抄录」。学生凭印象报的日期同样算待确认，不排节点
resolve_deadline	跑下面的命令，所有截止日一次算完；结果标「降级计算」，打印出的警告和「夏令时切换」行照样转述
get_test_dates、get_profile	请学生说出已经定下的考试日期、年级和课程体系；他没说的不排、不假设
ask_user	在对话里直接问：同样一次问完、每问给选项，然后停下等他回答
propose_events、propose_application	把倒推节点（日期、动作、为了哪个截止日）和已确认的截止日写成一张 Markdown 卡片，请学生自己存进日历；不说"已加入日程"

每行一个截止日：日期 时间 时区 标签。时区写 IANA 名（ET → America/New_York，CT → America/Chicago， MT → America/Denver，PT → America/Los_Angeles，英国 → Europe/London）；官网没写具体时间的按 23:59 算， 并注明这是默认值。第一个参数是今天（北京时间）的日期，省略就取本机当天。需要 Python 3.9 以上。

python3 -c 'import sys
from datetime import datetime, timedelta, timezone
from zoneinfo import ZoneInfo
bj, utc = ZoneInfo("Asia/Shanghai"), timezone.utc
today = datetime.fromisoformat(sys.argv[1]).date() if len(sys.argv) > 1 else datetime.now(bj).date()
gap = lambda x: f"北京 = 当地 {(x.astimezone(bj).utcoffset() - x.utcoffset()) / timedelta(hours=1):+g} 小时"
for line in sys.stdin.read().splitlines():
    if not line.strip(): continue
    d, t, z, *label = line.split()
    tz = ZoneInfo(z)
    raw = datetime.fromisoformat(f"{d} {t}").replace(tzinfo=tz)
    loc = raw.astimezone(utc).astimezone(tz)
    b = loc.astimezone(bj)
    n = (b.date() - today).days
    print(" ".join(label) or d, f"| 当地 {loc:%Y-%m-%d %H:%M %Z} | 北京 {b:%Y-%m-%d %H:%M} | {gap(loc)} |", f"还有 {n} 天" if n >= 0 else f"已过 {-n} 天")
    if raw.replace(fold=1).utcoffset() != raw.utcoffset(): print("  警告：这个当地时间落在夏令时切换的那一小时里（不存在或出现两次），先向学校确认")
    u = loc.astimezone(utc).replace(minute=0, second=0, microsecond=0)
    prev = (u - timedelta(hours=505)).astimezone(tz)
    for h in range(-504, 505):
        x = (u + timedelta(hours=h)).astimezone(tz)
        if x.utcoffset() != prev.utcoffset(): print(f"  夏令时切换：{x:%Y-%m-%d %H:%M} 起 {prev.tzname()}→{x.tzname()}，在截止之" + ("前" if h <= 0 else "后") + f"；切换前 {gap(prev)}，切换后 {gap(x)}")
        prev = x' 2026-08-04 <<'EOF'
2026-11-02 23:59 America/New_York Duke ED
EOF

上例的输出（命令会检查截止时刻前后 21 天内的夏令时切换）：

Duke ED | 当地 2026-11-02 23:59 EST | 北京 2026-11-03 12:59 | 北京 = 当地 +13 小时 | 还有 91 天
  夏令时切换：2026-11-01 01:00 起 EDT→EST，在截止之前；切换前 北京 = 当地 +12 小时，切换后 北京 = 当地 +13 小时

连命令也跑不了时，把命令交给学生自己运行；拿到结果之前，截止日表格里的北京时间一栏写「待换算」， 不填估出来的时间。

边界 / Boundaries

• 不编造截止日。这是本 skill 最硬的一条。没有核实过的日期，宁可让时间线缺一块。
• 不按往年推：申请截止日每年都可能动（撞周末就顺延），去年的日期不是今年的依据。
• 不心算时区：有 resolve_deadline 就全部走它；没有时跑下文「没有这些工具时（降级）」里的命令，结果标「降级计算」。 夏令时提示（工具的 warnings，或命令打印的警告与「夏令时切换」行）一律转述。
• 不替学生决定申哪些学校、走哪一轮：ED 是有约束力的承诺，这个决定不属于 AI。 用 ask_user 问，不要按"多数人会选 ED"排。
• 不承诺"按这个做就来得及"：时间线是脚手架，实际进度取决于学生。
• 不排满：申请季本来就有临时冒出来的事，每周留出空档。

Token 控制 / Token discipline

• get_applications 一次读齐，它已经带了换算结果；只有清单外的学校才另外调 resolve_deadline
• get_school_requirements 按平台或校名取，不要无参数拉全量
• 表格里只放会用到的字段，不要把数据集原样倒出来
• 多所学校的轮次攒成一张卡问完；运行时对连续追问有硬上限

变更记录 / Changelog

版本	日期	变更	类型
0.2.2	2026-09-26	声明兼容 claude-code 却没有降级路径：补「没有这些工具时（降级）」，截止日改由学生从官网抄录、时区用 zoneinfo 命令换算并标「降级计算」、写入改为 Markdown 卡片；"不自己算时区"改为有工具用工具、无工具跑命令；自查节点去掉学生在日程里用不了的 check_activity_limits、count_essay_words，改写成动作	patch
0.2.1	2026-09-11	标明倒推提前量是经验默认值，补充核对日期、流程来源与上游变化时发布 PATCH 的维护约定	patch
0.2.0	2026-08-04	转向先产出：已核实的学校直接排完整时间线，不再等所有信息齐；轮次选择改用 ask_user 一次问完	minor
0.1.0	2026-08-04	初始草稿	minor