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 ~ "<職稱關鍵字>"
兩種常見的失敗模式:
- 大小寫與標點。
Senior DevOps Engineer - AWS與Senior DevOps Engineer — AWS是相同的職位。在比較之前,請標準化大小寫、空格與破折號。 - 僅憑標題的信心。 標題只是篩選線索,絕非職位等級或適合度的證明。請勿僅憑標題就開啟記錄。
若記錄已存在,請更新而非建立第二筆。
描述格式
描述應包含職缺描述與篩選結果。使其能在一次閱讀中輕鬆理解:
##標題下方應有內容;切勿兩個標題連續出現- 關鍵值使用粗體標籤(
**職位:**、**地點:**),而非冒號清單 - 章節之間留空行
- 連結使用
[描述文字](網址)格式,切勿使用裸的「請參閱:網址」 - 程式碼、檔名與命令使用反引號
- 無文字牆段落;請分段
- 無巢狀編號清單
複製完整的職缺描述直到最後一段。截斷的描述是不完整的記錄。
附件
- 同時儲存 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 對應技能