Communitygithub.com

Jira 职位记录

如何将工作机会以 Jira 问题形式归档——摘要格式、必填字段、重复检查、描述格式和附件。适用于 tracker_backend 为 jira 的情况。当职位发布成为追踪器记录时,以及在 Jira 看板上创建或更新职位记录时使用。

Jira 职位记录 是什么?

该技能为 AI 代理提供了在 Jira 中管理求职记录的标准化工作流程,适用于“tracker_backend: jira”配置。它指导代理如何正确创建记录,包括设置必填字段(如摘要、开始日期、来源和优先级)以及将职位链接以超链接形式放置在描述顶部。该技能强调重复检查机制,要求代理在创建前搜索项目中的重复项,并考虑大小写和标点差异。描述格式需遵循严格的规则(使用标题、加粗标签和代码块),并附则包括上传 HTML 源文件和渲染的 PDF。技能还强制要求理由和结论之间保持逻辑一致性,并在偏好变更时重新验证记录。支持平台包括 Claude Code、Cursor、Codex 和 Windsurf,使用 Jira REST API 执行所有操作。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SongGithub/personal-skills/tree/HEAD/job-search/skills/jira-job-records

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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 ~ "<职位名称关键词>"

两种常见失败模式:

  1. 大小写和标点。 Senior DevOps Engineer - AWS 和 Senior DevOps Engineer — AWS 是相同的职位。在比较前规范化大小写、空格和破折号。
  2. 仅凭标题确信。 标题是筛选线索,而非级别或匹配度的证据。请勿仅凭标题打开记录。

如果记录已存在,则更新它而非创建第二个。

描述格式

描述中包含职位描述和筛选结果。使其一次阅读即可理解:

  • ## 标题下方有内容;避免两个标题背靠背
  • 关键值使用加粗标签(**职位:**、**地点:**),而非冒号列表
  • 各部分之间留空行
  • 链接使用 [描述文本](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 对应技能

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

SongGithub/personal-skills

Applies a direct, plain-spoken, Australian-English communication style to any text drafted — chat replies, emails, Slack/Teams messages, tickets, PR and commit descriptions, docs. Use whenever drafting prose, not just visual or code artifacts. Skip when the user explicitly asks for a different tone or voice.

SongGithub/personal-skills

A reusable HTML document design system for CVs, one-pagers and short reports — design tokens, layout, typography, print-to-PDF rules and accessibility. Use when generating or restyling a self-contained HTML document meant to be read on screen or printed to PDF.

SongGithub/personal-skills

End-to-end job application workflow. Screen a posting, tailor the HTML CV from the master template, print it to PDF, archive the artifact, and file the result against the configured tracker. Triggers on apply, apply to jobs, submit application, tailor and send CV.

SongGithub/personal-skills

CV attach workflow. Generate a tailored HTML CV for a tracked role, attach the rendered artifact back to its tracker item, then verify the attachment actually landed. Covers template selection, tailoring order, upload headers, and read-back verification.

SongGithub/personal-skills

First-principles reasoning for a startup or a job search, in the spirit of Elon Musk's "zero restart" framing: survival cashflow, the idiot index, and the physical first step. 第一性原理创业与求职法 — 从马斯克「归零重启」思维出发,用生存现金流、白痴指数、长期物理第一步三个步骤,指导创业和求职

SongGithub/personal-skills

Assistant for job applications: evaluating job postings, tailoring CVs, writing cover letters, and preparing for interviews. Triggers on keywords like: job posting, job application, CV, cover letter, resume, interview prep, job fit, career, application, apply, SEEK

SongGithub/personal-skills

Job scraper. Searches job boards for new positions matching the candidate profile, deduplicates against previously seen jobs and the tracker file, then presents new matches with a quick fit assessment. Triggers on: job scrape, find jobs, search jobs, new jobs, /scrape.

SongGithub/personal-skills

Screen job opportunities, prepare job records and tailored CVs, and verify the result against current salary, title, source, and document-quality preferences. Applies to job boards and scheduled searches.

SongGithub/personal-skills

Trello card rules for the job-search tracker. Enforces case-insensitive and fuzzy duplicate detection before any card is created, title formatting, lane placement from config, and logging each card to the tracker database. Applies whenever a job posting becomes a card.

SongGithub/personal-skills

Compares tracked job postings against the candidate profile to find skill gaps, then builds a prioritised gap heatmap and a learning plan with searched study resources and a study order. Triggers on: upskill, skill gaps, what should I learn, learning plan, upskill report.

相关技能