job-application-tracker

name	job-application-tracker
description	统计简历投递记录并自动更新 README，支持新增/修改记录和可选同步到 GitHub。
license	MIT
compatibility	PowerShell 7+
metadata	{"author":"local","version":"1.0"}

目标

通过统一对话参数和脚本入口，完成以下能力：

• 新增投递记录并自动重算统计
• 修改已有记录并自动重算统计
• 仅更新 README 机器维护区块，不改动人工内容
• 自动维护 README 时间轴（日期+公司名横向排列，超宽自动换行）
• 可选执行 git add/commit/push 同步到远端仓库

触发线

• 新增触发：用户表达“新增投递”“记录投递”
• 修改触发：用户表达“修改投递”“更新进度”

参数与枚举

• 投递类型：秋招、春招、日常实习、暑期实习
• 进度：已投递、测评、HR联系、笔试、一面、二面、三面、四面、面委会、HR面、Offer、拒绝、主动中止
• 进度流程非必经，可跳跃或提前结束

推荐执行

• 初始化：pwsh ./scripts/application-tracker.ps1 -Initialize
• 新增（交互）：pwsh ./scripts/application-tracker.ps1 -Action add
• 修改（交互）：pwsh ./scripts/application-tracker.ps1 -Action update
• 明确同步：pwsh ./scripts/application-tracker.ps1 -Action add -Sync yes

约束

• 修改定位优先级：ID > 公司+岗位+时间
• 编号规则为三位数字（001、002...），每次写回按投递时间升序全量重编号，最早记录编号最小
• 官网必须为 http/https，表中渲染为短连接 [🔗 投递页](url)
• 同步必须显式确认（-Sync ask/yes/no）
• 提交信息模板：docs(tracker): update application records [timestamp]
• 严重警告（防Bug）：当用户要求「更新面试时间/进度时间」时，只能改动 -Progress 字段（例如传入 -Progress "一面(03-19)"）。绝对禁止修改 -Time 字段！-Time 字段代表「首次投递时间」，修改它会导致时间轴排序混乱和记录丢失原本的投递日期。
• LLM 在填充时间时，若用户没有指定精确的年份或详细时间，允许留空或仅传入短日期格式。底层脚本已具备自动填充当前时间戳的功能；而在 README 表格渲染中，仅展示对齐到 MM-dd 精度的日期。
• 对于所有带有 "面" 字的进度（如一面、二面、HR面），若用户未提供日期后缀，底层脚本将自动加上类似 (MM-dd) 格式的日期戳记录。

缺失信息补全规则

• 使用本 skill 时，如果用户未提供完整字段，系统必须补问并等待补全后再执行写入
• 新增记录最少需要：公司、投递类型、进度、岗位、官网。时间为选填。
• 修改记录最少需要：ID，或 公司+岗位（结合时间用于兜底定位）
• 若同步策略不明确，必须显式询问是否执行完整 Git 同步流程（add/commit/push）

README 时间轴维护流程

• 每次 add/update 后，脚本同时重写 TIMELINE 机器维护区块
• 时间轴展示日期与公司名，按投递时间降序排列
• 时间标签仅展示月-日，不展示小时和分钟
• 渲染使用 HTML div/span 横向布局，flex-wrap: wrap 超宽自动换行

Git 同步全流程

• 触发条件：用户明确要求“同步仓库 / 提交并推送 / 处理整个 git 流程”
• 执行顺序：git add → git commit → git push
• git add：默认添加本次修改文件；未指定时可添加全部变更
• git commit：使用模板 docs(tracker): update application records [timestamp]
• git push：提交后立即推送当前分支
• 失败处理：
  • add 或 commit 失败时停止后续步骤并返回错误
  • push 失败时保留本地提交，提示用户稍后重试推送