Communitygithub.com

Jira 職缺記錄

如何以 Jira 議題形式記錄職缺機會 — 包含摘要格式、必填欄位、重複檢查、描述格式與附件。適用於 tracker_backend 為 jira 的情況。在職缺公告成為追蹤記錄時,以及在 Jira 看板上建立或更新職缺記錄時使用。

Jira 職缺記錄 是什麼?

此技能定義了在 Jira 中管理職缺機會記錄的標準作業流程,當 `tracker_backend` 設為 `jira` 時自動啟用。它詳細說明了建立記錄時必須設定的欄位,例如摘要的固定格式為 `<職稱> — <公司>`、記錄建立日期、來源(如 seek 或 linkedin)、優先級,以及包含職缺連結和完整描述的格式化說明。技能強調嚴格的副本檢查,以避免重複記錄,並提供描述格式、附件管理(HTML 與 PDF)、以及如何確保篩選結果(verdict)有充分理由支持的指引。此外,它還包含當候選人的偏好或個人資料變更時重新驗證記錄的原則,確保所有記錄保持準確且可據以行動。此技能旨在提升使用 Jira 看板追蹤職缺的開發者或求職者的組織效率與資料完整性。

相容平台~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)列建立:晉升至待辦列是候選人的分類決策,而非輸入步驟。

摘要。 使用 <職稱> — <公司> 格式,不加前綴。像 Job Hunt: 這樣的前綴並無幫助:專案中的每一筆記錄都是職缺記錄,前綴只會讓標題變寬並破壞基於標題的搜尋。

開始日期。 設定為記錄建立的日期,以便記錄機會進入管道的日期,而非從工單歷史推斷。這是記錄的開始日期,而非職位的開始日期。欄位 ID 來自 jira.fields.start_date。

來源。 在來源欄位記錄機會的來源,其 ID 為 jira.fields.source。接受的值來自 jira.source_values:seek、linkedin、recruiter、referral、company-site 或 direct。切勿留空 — 沒有來源的記錄日後無法按渠道篩選,而這正是該欄位的意義所在。

請注意,在團隊管理的(次世代)專案中,自訂欄位是專案範圍的,可能不會出現在建立元資料 API 中。請從議題的 expand=names 輸出或 /rest/api/3/field 讀取 ID,而非斷定該欄位不存在。

員工人數。 若專案追蹤公司規模,請記錄員工人數及其來源與截止日期,例如 ~3,090(2026 年 6 月年報) 或 501-1,000(LinkedIn 範圍)。無來源的數字比沒有數字更糟。

職缺連結

將原始職缺公告的連結保留在描述的頂部,作為帶有可讀文字的超連結,使其在開啟記錄時第一眼就能看到。切勿將其埋藏於其他中繼資料中,也切勿在中間段落留下裸 URL。

格式為描述的第一行:

[<職稱> — <公司>](<職缺網址>)

若專案有專用的 URL 或連結欄位,也請一併設定 — 但描述中的連結是必須始終存在的,因為它能承受欄位配置變更,並會隨描述一同匯出。

在同一步驟中設定來源標籤(seek、linkedin),以便日後按渠道篩選記錄。

副本檢查 — 在建立任何內容之前執行此操作

在寫入之前搜尋專案中的公司與職稱:

project = <金鑰> AND summary ~ "<公司>"
project = <金鑰> AND summary ~ "<職稱關鍵字>"

兩種常見的失敗模式:

  1. 大小寫與標點。 Senior DevOps Engineer - AWS 與 Senior DevOps Engineer — AWS 是相同的職位。在比較之前,請標準化大小寫、空格與破折號。
  2. 僅憑標題的信心。 標題只是篩選線索,絕非職位等級或適合度的證明。請勿僅憑標題就開啟記錄。

若記錄已存在,請更新而非建立第二筆。

描述格式

描述應包含職缺描述與篩選結果。使其能在一次閱讀中輕鬆理解:

  • ## 標題下方應有內容;切勿兩個標題連續出現
  • 關鍵值使用粗體標籤(**職位:**、**地點:**),而非冒號清單
  • 章節之間留空行
  • 連結使用 [描述文字](網址) 格式,切勿使用裸的「請參閱:網址」
  • 程式碼、檔名與命令使用反引號
  • 無文字牆段落;請分段
  • 無巢狀編號清單

複製完整的職缺描述直到最後一段。截斷的描述是不完整的記錄。

附件

  • 同時儲存 HTML 原始碼與產生的 PDF。
  • PDF 檔名必須與 HTML 檔名相符,例如 cv_<KEY>_<公司縮寫>.pdf 與 cv_<KEY>_<公司縮寫>.html 並存。
  • 先上傳替代檔案,確認其已成功上傳且具有預期的名稱與大小,然後刪除被取代的舊版本。請勿保留兩個版本。

結論必須有理由支持

結論只有在所列出的理由支持時才有用。在寫入之前:

  • 正面理由(穩定的雇主、熟悉的領域、重疊的技術棧)永遠無法支持「暫緩」或「死線索」的結論。如果列出的所有理由都是正面的,那麼結論要麼是錯的,要麼是遺漏了真正的理由。
  • 陳述實際根據:技術棧或學科不符、地點、薪資低於底線,或指定的排除規則。沒有陳述根據的結論只是佔位符,而非評估。
  • 切勿從後來已變更的標準繼承結論。如果最初的異議不再適用,必須重新推導結論,而非讓其保持原狀。

當標準變更時重新驗證

記錄一旦寫入就會逐漸過時。當 preferences.yaml 變更(職位等級、薪資底線、排除的技術棧)或 profile.md 獲得重大新資訊時:

  • 重新閱讀活躍看板列(待辦、已申請、面試中、待處理)中每筆記錄的適合度理由與差距。
  • 標記任何引用已不再適用標準的記錄,例如異議的職位等級後來已變成可接受,或宣稱的技能在個人資料中並不存在。
  • 修正推理。請不要只是刪除過時的異議:刪除它可能使結論失去支持,這比原本的錯誤更糟。
  • 保留死線索。它們是無效的。
  • 在刪除之前先詢問。 如果某個備註或履歷聲明看起來未經驗證,請與候選人確認,而非直接刪除。個人資料摘要可能遺漏實際經驗,因此簡歷中的缺失並非該聲明為假的證據。將確認的事實記錄回個人資料中。

相關技能

  • 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.

相關技能