简历构建器
在 docs/personal/resumes/ 目录下维护一份有证据支持的单一职业履历,从中派生出针对特定职位的简历变体,并仅将明确标记为公开的内容发布到个人网站。
需要时请阅读以下支持文档:
references/convention.md—— 必需的文件结构、记录字段、声明ID、变体以及发布状态。references/website-sync.md—— 发现并更新简历网站,避免将其变为第二个事实来源。references/source-recovery.md—— 从遗留网站、仓库历史、书签管理器以及存档简历中恢复工作经历。assets/scaffold/—— 用于新建简历根目录的初始文件。
默认决策
事实只存储一次;变体通过稳定ID选择它们。 切勿将某个职位或成就复制到变体中并任其漂移。应更新规范记录,然后为特定目标职位选择、排序或适当调整声明措辞。网站只是发布目标,而非规范的工作经历数据库。
安全与真实性
- 切勿虚构日期、职位名称、指标、证书、雇主、客户或技术。对于不确定的内容,标记为
status: needs-verification。 - 保留已知最精确的日期;不要为了满足格式而捏造具体某一天。
- 除非明确标记,否则将联系方式、薪酬、推荐信、客户名称以及非公开证据视为私密信息。
- 不要将私密字段发布或提交到公共仓库。
- 将证据作为链接或简短来源说明附在规范声明旁;不要将机密源材料复制到简历树中。
- 在发布前,向用户展示实质性措辞变更以及未解决的事实。
工作流程
- 定位个人源目录。
- 读取主导的
AGENTS.md文件。 - 使用包含
docs/personal/resumes/的仓库根目录。 - 如果该目录不存在,提供将
assets/scaffold/复制到该处的选项。 - 读取其
README.md以及与请求变更相关的所有记录。
- 读取主导的
- 编辑前进行盘点。
- 列出规范职位、项目、声明ID、变体以及发布目标。
- 将记录与当前简历网站、仓库历史、书签来源以及任何提供的简历文件进行比较。
- 报告矛盾之处、过期的未限定结束日期的职位以及未经验证的声明。
- 对于遗留数据的引导恢复,请遵循
references/source-recovery.md。
- 首先更新规范事实。
- 添加或修改
work-history/和projects/中的记录。 - 为每个可复用的成就分配一个稳定声明ID。
- 记录可见性、置信度、证据以及
last_verified。 - 当新事实确定了结束日期时,关闭之前未限定结束日期的职位。
- 添加或修改
- 构建或刷新变体。
- 根据规范档案和选定的声明ID创建
variants/<slug>.md。 - 针对目标职位定制摘要、顺序和重点。
- 仅当规范证据支持时,才保留职位描述中的关键词。
- 将特定于申请的变体链接到现有的申请记录,而不是在此处重复申请跟踪。
- 根据规范档案和选定的声明ID创建
- 渲染并审查。
- 解析每个选定的声明ID。
- 检查时间顺序、语态、一致性、页长、联系方式字段、链接和拼写。
- 向用户呈现实质性编辑以及任何标记为
needs-verification的项目。
- 同步发布目标。
- 遵循
references/website-sync.md。 - 仅更新
visibility: public的记录。 - 保持目标仓库的内容模式和本地说明。
- 在发布前运行最窄范围的可用验证。
- 遵循
- 记录新鲜度。
- 更新变体的
last_reviewed字段。 - 在验证网站更新后,更新目标记录的
last_published字段以及源修订版本或提交哈希。 - 报告哪些内容仍未发布或未经核实。
- 更新变体的
变体规则
一个变体可以:
- 选择并排序规范声明ID;
- 使用针对目标职位的摘要;
- 在不改变原意的条件下缩短支持的声明;
- 为便于阅读对支持的技能进行分组;
- 省略不相关的职位、项目和声明。
一个变体不得:
- 创建仅存在于变体中的事实;
- 夸大范围、资历、所有权或数值影响;
- 暴露私密声明;
- 悄悄地更改日期或职位名称;
- 覆盖另一个针对特定职位的变体。
完成检查清单
- 每个渲染的声明都能解析到一条规范记录。
- 每条公共声明都明确标记为公开。
- 没有将未解决的矛盾作为事实呈现。
- 当前职位使用现在时;已完成的职位使用过去时。
- 日期在时间顺序上一致,并且未限定结束日期的职位是故意为之。
- 同步后,网站与指定的公开变体一致。
- 生成的文件可以从规范记录和变体中复现。