Jira 职位记录 是做什么的?
仅当 $JOB_SEARCH_HOME/integrations.yaml 中 tracker_backend: jira 时适用。如果后端为 trello,请改用 trello-card-rules 技能。
从 integrations.yaml 中 jira.* 下识别站点、项目和字段 ID。切勿硬编码站点 URL、项目密钥、字段 ID、电子邮件地址或令牌——无论是凭记忆、旧版技能副本还是打印凭证,均不允许。
创建记录时需设置的字段
| 字段 | 值 |
|---|---|
| 摘要 | <职位名称> — <公司名称> |
| 开始日期 | 记录创建的日期 |
| 来源 | 机会来源,例如 seek 或 linkedin |
| 优先级 | 根据筛选结果设置 |
| 描述 | 第一行为职位链接(超链接形式),然后为完整的职位描述 |
看板列。 在 Backlog 列创建记录。切勿直接在 To Do 中创建:提升到 To Do 是候选人的分诊决定,而非录入步骤。
摘要。 使用 <职位名称> — <公司名称> 且不带前缀。像 Job Hunt: 这样的前缀毫无作用:项目中的每条记录都是职位记录,前缀只会加宽标题并破坏基于标题的搜索。
开始日期。 设置为记录创建的日期,以便记录机会进入管道的日期,而非从工单历史推断。此为记录的起始日期,而非职位的起始日期。字段 ID 来自 jira.fields.start_date。
来源。 在 来源 字段中记录机会来源,其 ID 为 jira.fields.source。可接受的值来自 jira.source_values:seek、linkedin、recruiter、referral、company-site 或 direct。切勿留空——无来源的记录日后无法按渠道筛选,而这正是该字段的全部意义。
请注意,在团队管理(新一代)项目中,自定义字段是项目范围的,可能不会出现在 create-metadata API 中。请从问题的 expand=names 输出或 /rest/api/3/field 中读取 ID,而非断定该字段不存在。
人数。 当项目跟踪公司规模时,记录员工数量及其来源和截止日期,例如 ~3,090(2026 年 6 月 年报) 或 501-1,000(领英区间)。未注明来源的数字比没有数字更糟糕。
职位链接
将原始招聘帖子的链接放在描述顶部,作为带有可读文本的超链接,使其在打开记录时首先可见。切勿将其埋没在其他元数据中,也切勿在段落中间留下裸 URL。
将其格式化为描述的第一行:
[<职位名称> — <公司名称>](<招聘帖子 URL>)
如果项目有专门的 URL 或链接字段,也请一并设置——但描述中的链接必须始终存在,因为它能经受字段配置变更,并在导出描述时一同导出。
在同一操作中设置来源标签(seek、linkedin),以便后续按渠道筛选记录。
重复检查——创建任何内容前执行此操作
在写入之前,搜索项目中的公司和职位名称:
project = <密钥> AND summary ~ "<公司名称>"
project = <密钥> AND summary ~ "<职位名称关键词>"
两种常见失败模式:
- 大小写和标点。
Senior DevOps Engineer - AWS和Senior DevOps Engineer — AWS是相同的职位。在比较前规范化大小写、空格和破折号。 - 仅凭标题确信。 标题是筛选线索,而非级别或匹配度的证据。请勿仅凭标题打开记录。
如果记录已存在,则更新它而非创建第二个。
描述格式
描述中包含职位描述和筛选结果。使其一次阅读即可理解:
##标题下方有内容;避免两个标题背靠背- 关键值使用加粗标签(
**职位:**、**地点:**),而非冒号列表 - 各部分之间留空行
- 链接使用
[描述文本](url),而非裸的“请参见:url” - 代码、文件名和命令用反引号包裹
- 避免大段文字段落;将其拆分开
- 不使用嵌套编号列表
复制完整的职位描述,直到最后一个段落。截断的描述是不完整的记录。
附件
- 同时存储 HTML 源文件和渲染后的 PDF。
- PDF 文件名必须与 HTML 文件名匹配,例如
cv_<KEY>_<company-slug>.pdf与cv_<KEY>_<company-slug>.html并存。 - 先上传替换文件,验证其以预期的名称和大小落地,然后删除已取代的副本。切勿同时保留两个版本。
评定必须基于理由
仅当所述理由支持时,评定才有效。在写评定之前:
- 正面理由(稳定的雇主、熟悉的领域、重叠的技术栈)绝不能支持
Deprioritise或Dead-lead评定。如果列出的每条理由都是正面的,那么要么评定错误,要么真正的理由缺失。 - 说明实际原因:技术栈或学科不匹配、地点、薪资低于底线,或指定的排除规则。没有说明原因的评定只是占位符,而非评估。
- 切勿从已更改的标准继承评定。如果最初的反对理由不再适用,必须重新推导评定,而非让其保留。
标准变更时重新验证
记录一旦写入就会逐渐过时。当 preferences.yaml 发生变化(级别、薪资底线、排除的技术栈)或 profile.md 增加了重要新事实时:
- 重新阅读活跃看板(To Do、Applied、Interview 和 Backlog)中每条记录的匹配理由和差距。
- 标记任何引用不再适用标准的记录,例如级别反对理由在级别变得可接受后,或声称技能但个人资料中不具备。
- 修复推理。请不要直接删除过时的反对理由:删除它可能导致评定失去支持,这比原始错误更糟糕。
- 让 Dead-leads 保持原样。它们是不活动的。
- 删除前先询问。 如果注释或 CV 声称的内容未经验证,请与候选人确认后再移除。个人资料摘要可能遗漏真实经验,因此摘要中没有并非声称内容为假的证据。将确认的事实记录回个人资料。
相关技能
job-search-quality—— 筛选、薪资和标题标准,以及决定记录是否完整的证据门cv-attach-workflow—— 生成定制简历并附加jira-job-records是trello-card-rules的 Jira 对应技能