Communitygithub.com

Flagrare/agent-skills

建立並維護一份有來源佐證的晉升地圖,幫助使用者規劃職涯下一步。它會訪談使用者關於目標(職等、軌道、週期與原因),研究公司實際的晉升機制(流程、時程、申請文件範本、主管評分表),繪製組織圖並找出直接了解使用者工作成果的人,最後計算出與主管洽談的最佳時機。每項事實都附有來源與已驗證/未驗證/推斷狀態,當來源有衝突時會並列呈現,而非默默解決。

agent-skills 是什麼?

這個技能旨在幫助 AI 代理器的使用者建立一份個人化的晉升地圖,以應對在不同公司平台(如 Claude Code、Cursor、Codex 等)中的職涯發展。它透過結構化的流程,系統性地蒐集並分析關鍵資訊:首先訪談使用者確認目標職等、軌道(技術職或管理職)與動機;接著研究公司內部的實際晉升流程、時程、申請文件範本與評分標準;然後繪製組織圖,找出哪些人直接了解使用者的工作成果,並辨識出參與考核會議的成員。每個步驟產出的事實都要求附帶原始來源與驗證狀態(已驗證/未驗證/推斷),當不同來源出現矛盾時,會明確標示衝突而非私自選邊。最終產出 `promotion-map.md` 與 `promotion-map.json` 兩份文件,供使用者閱讀並帶入一對一會議,同時也供其他職涯技能讀取。此技能不會主動發布任何資訊,所有資料均為本地端且私密。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Flagrare/agent-skills/tree/HEAD/plugins/flagrare/skills/promotion

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

晉升

禁止使用破折號。 此技能寫出的任何內容皆不得包含破折號;請改用逗號、冒號或括號。此規則由儲存庫的鉤子強制執行。請參閱 /flagrare:write-docs。

使用平實詞彙。 在使用者會看到的任何內容中,請使用 <plugin root>/lib/career/GLOSSARY.md 中的平實名稱(例如:「高級行為」,而非「評分表欄位」;「你的書面陳述」,而非「申請文件」;「你主導的專案」,而非「倡議」)。首次出現某個術語時,用幾個字說明其含義,並在使用者在工作中會聽到的公司用語旁加上括號。

晉升的決定是在使用者不在場的會議中,依據一份書面陳述,由一群大多不認識使用者的人,在提前數月排定的時程表上做出。此技能讓這些事實及早浮上檯面:使用者想去哪裡及原因、公司實際如何決定、評分表要求什麼、誰對使用者的工作有第一手了解,以及關鍵對話必須在何時發生。

它會產出一份晉升地圖:promotion-map.md 供使用者閱讀並帶入一對一會議,以及 promotion-map.json(包含相同的事實,供其他職涯技能使用)。此地圖為本地端且私密。此技能絕不會發布、傳送或公開任何內容。

函式庫

此插件附帶了位於 <plugin root>/lib/career/ 的輔助腳本。插件根目錄在此技能基礎目錄的上兩層。執行方式為 python3 <plugin root>/lib/career/<script>.py ...。這些腳本僅讀取並列印 JSON;此技能使用「寫入」工具來寫入所有檔案,因為沙盒化的 shell 無法寫入 ~/.claude/skills 目錄下。

  • career_state.py paths|contributions|plan --home "$HOME":檔案位置、貢獻紀錄(新舊位置的聯集)以及遷移計畫。
  • map_schema.py check <map.json> --today YYYY-MM-DD:檢查錯誤、遺漏區段、過期區段(超過 90 天)、衝突。
  • deadlines.py --deadline YYYY-MM-DD --today YYYY-MM-DD [--dead START:END ...] [--published]:計算與主管洽談的時機。--dead 為可選且可重複。

地圖的結構定義在 reference/map-schema.md,Markdown 版型定義在 reference/map-template.md。其他共享狀態檔案(貢獻紀錄、旗標、倡議)說明於 <plugin root>/lib/career/STATE.md;若要清除已處理的旗標,請將其從 flags.json 中移除後再寫入。

1. 載入狀態(每次執行)

  1. 執行 career_state.py plan。使用「寫入」工具套用每個 write 動作,如果目標檔案已存在,則先讀取它(「寫入」工具不會覆蓋未讀取過的檔案)。mkdir 動作不需要獨立步驟:資料夾會在寫入第一個檔案時自動建立。請勿寫入佔位地圖。絕對不要刪除任何東西。
  2. 讀取 ~/.claude/skills/flagrare/config.json(頂層身份鍵、skills.promotion 區塊)以及現有地圖(如果有的話)。如果設定檔或 skills.promotion 區塊遺失,請使用預設值繼續。
  3. 沒有地圖代表首次執行(第 3 節)。如果 map_schema.py check 的輸出顯示 missing 區段,則表示首次執行中斷:從其區段遺漏的最早階段繼續執行。否則,執行更新(第 4 節),除非使用者要求 packet 模式(第 5 節)。

由 /flagrare:career 呼叫。 引數會指定模式(first_run、resume 或 refresh)以及要處理的區段:僅處理這些區段。當引數也包含 scheduled 時,請勿訪談或提問:僅重新研究並儲存不需要使用者回答的區段(流程、時程、評分表、組織、先例),並將每個需要使用者回答的區段(目標、人員、主管問題)作為一行,回傳給協調器的「待辦事項」清單。在這兩種情況下,請回傳一份簡短的變更摘要,而非完整的地圖。

2. 每項事實的規則

  • 來源、日期、狀態。 每項事實都需附上連結或引述位置、你檢查的日期以及狀態:verified(已讀取並從原始來源引述)、unverified(摘要、片段或間接取得)、inferred(你的推論)。
  • 逐字引述原始來源。 擷取工具會進行摘要。當某段引述將被依賴時,請重新讀取原始頁面(例如頁面的 JSON 或 HTML),並確認確切的文字。
  • 顯示衝突,絕不私下選邊。 當兩個來源不一致時(例如組織圖 vs. 團隊目錄、流程頁面 vs. 職涯階梯檔案),請將兩者都儲存為 alternatives 並告知使用者。
  • 「找不到任何資訊」是有效的結果。 如果某個步驟找不到任何資訊,請改為在 manager_questions 中加入一個具體問題,而不是猜測。許多公司沒有書面流程。
  • 人員相關的事實較敏感。 僅讀取使用者自身的互動。紀錄誰對使用者的工作有第一手了解,切勿列出人員的實用性排名。
  • 在使用瀏覽器存取 HR 入口網站或內部網站前,必須徵求同意。

3. 首次執行

事先告知使用者:首次執行耗時較長,通常需要一個小時或更久,並且每個階段都會儲存進度,因此可以中斷並繼續。

每次儲存都會同時寫入 promotion-map.json 和 promotion-map.md,並為該階段寫入的每個區段設定 sections.<name>.checked_at(今天)和 sections.<name>.sources。沒有 checked_at 的區段會被視為過期。階段 1 寫入 target、process 和 calendar;階段 2 寫入 rubric;階段 3 寫入 org、people 和 precedent;階段 4 寫入 packet_readiness 和 manager_questions。即使未找到任何內容,也要寫入每個區段(包含其 checked_at 的空列表或物件),這樣空的區段就不會被誤認為是中斷的執行。

階段 1:目標、流程及時程

  1. 先訪談,再進行任何研究。 一次問一個問題:
    1. 目前職等和目標職等。
    2. 軌道:技術職或管理職。
    3. 他們鎖定哪個週期(在步驟 4 之後再回來討論,屆時時程已明朗,並提出一個建議)。
    4. 為什麼他們想要這個晉升、他們想要更多什麼樣的工作、以及他們想要更少什麼樣的工作。
  2. 查詢關於目標職等的兩項事實: 此職等在此公司是否為終端職等(沒有再往上的預期),以及目前職等的預期時間帶為何。請引述兩者。
  3. 說明「為什麼」會帶來什麼改變。 終端職等加上「求心安」的「為什麼」,使這個目標成為終點線。「金錢」或「影響力」的「為什麼」則意味著需要規劃超越這個目標。將此寫入地圖的第 1 節。
  4. 在所有已連結的來源中尋找流程、時程和申請文件範本: 維基、文件、聊天公告、會議記錄、HR 入口網站(需經同意)。同時也找出產品決策是如何做出的:決策文件以及通常由誰主導。影響力掃描需要此資訊。 同時也找出領導層關注什麼:公司的主題或策略文件、OKR 與規劃文件,以及規劃會議和全員大會所傳達的訊息(從已連結的會議記錄中,例如 Granola)。記錄每個對使用者所屬領域重要的指標於 priorities 中:主題、指標、其基線和目標(若有書面記錄,則每項皆須附帶來源)、負責的團隊,以及 user_lever:owner(若使用者的職位擁有該指標主要輸入的控制權)、input(若他們的系統饋入該指標)、none(若控制權在其他團隊)。影響力掃描會根據此清單對提案進行排序。優先事項應取自會議記錄,切勿引用關於人的言論。
  5. 儲存地圖(JSON 和 Markdown),並填入 target、process、calendar 和 sections 條目。

階段 2:評分表差距

  1. 尋找主管用來評分的文件(職涯階梯試算表、工作檢核手冊),而非關於它的文字敘述。詢問使用者他們的主管是否使用工作檢核手冊。如果文字敘述和文件不一致,請使用文件,並將不一致記錄在 rubric.prose_mismatches 中。
  2. 為每個行為建立一個 rubric.rows 條目:目前職等的文字、目標職等的文字、一個穩定的 ID(<area>.<short-slug>)、以及一個 label(兩到四個平實詞語的行為描述,例如「發現問題」、「備受追捧的審查者」),看板和摘要會顯示 label 而非 ID。
  3. 將每個欄位標記為 done、partial 或 not_started,並附上來自 career_state.py contributions 的證據、同儕給予使用者的表揚(當表揚工具已設定時,請參閱下方的「表揚」章節:每個獎金及其連結都是證據,且其標記的公司價值指向核心價值行為)、使用者的評論和工作成果,以及使用者分享的過往審查記錄。
  4. 儲存。

階段 3:組織以及誰了解你的工作

  1. 組織: 使用者的彙報鏈、使用者可能加入的團隊的上一級主管、以及即將發生的變動(離職、新任領導者、重組,均來自會議記錄和公告)。每個人都需要附上來源和狀態。
  2. 誰了解你的工作,先看證據,再問使用者:
    • 從使用者自身的互動中提出人選(給予和收到的評論、共享的討論串、共享的會議,以及所有給予他們表揚的人),並附上證據連結。曾經表揚過使用者的人已經親眼看過他們的工作成果;標記出任何同時也是晉升委員會成員的人。
    • 請使用者確認和修正,並補充工具無法看到的資訊,例如前任主管或黑客松團隊的成員。
    • 設定 seen_your_work 和 confirmed_by_user。
  3. 誰參與考核會議: 從流程文件中推斷,引述該句子,並標記為 inferred。列出與會者中那些未曾看過使用者工作成果的人。
  4. 先例: 閱讀近期晉升公告,了解哪些貢獻獲得了肯定,並在地圖中寫下「公告是敘事,而非審計」。僅在使用者要求時才提供深度層級:在程式碼、文件和工單中交叉比對實際發起工作的人是誰。此步驟成本高昂,且預設為關閉。
  5. 儲存。

階段 4:計畫

  1. 截止日期: 使用申請文件截止日期來執行 deadlines.py。如果本週期的日期已公布,請使用它並傳遞 --published。否則,將去年的日期投射到本週期(同月同日,但延後一年),並標記為 inferred。詢問使用者其所在地有哪些假期或休假週期是空檔時間,並將其作為 --dead 傳遞。以「舒適時間為 X,絕對時間為 Y」的格式記錄,並附上狀態。如果狀態為 past,請直接說明,並指出下一個週期。
  2. 每個未完成的欄位都有一個下一步: 對於每個不是 done 的欄位,寫下 next_step:能夠增加證據的最簡單、最具體的可行動作,並根據你對該公司的了解量身訂做(例如「在招募頻道中輸入 /interview」、「提供一次夥伴儀表板的配對工作階段」、「向你的主管要求共同主導路線圖的一部分」)。看板會列出三個差距最大的項目的這些步驟,因此請確保每個步驟都能在一週內完成,而非一個目標。
  3. 申請文件準備就緒度: 執行 python3 <plugin root>/lib/career/coordinator.py readiness --home "$HOME" --today <date> 以取得每個評分表欄位的證據數量(帶有該欄位標籤的日誌條目,加上該欄位自身的證據),然後根據這些欄位資料,將申請文件範本的每個區段標記為 strong、thin 或 empty。
  4. 同儕回饋人選: 根據 recognition.py summary,最常表揚使用者的那些人以及他們表揚的內容,是書面陳述中同儕回饋的首選人選(3 到 5 位);將他們加入「同儕回饋」備註中。
  5. 主管問題: 所有仍未知的事項,加上準備就緒度的問題(「<現在週期> 的目標實際嗎?還缺少什麼?」)。
  6. 執行 map_schema.py check。修正任何錯誤,然後儲存。
  7. 向使用者顯示簡短摘要:目標、兩個對話日期、尚未展現的資深行為(依標籤)、還有誰需要看到他們的工作成果,以及要問主管的問題。指向 promotion-map.md。

4. 更新

  1. 執行 map_schema.py check,並讀取 career/flags.json(如果有的話,其他技能會在那裡寫入過期訊號,例如重組、離職或時程公布)。當表揚工具已設定時,使用 python3 <plugin root>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD> 來更新表揚資料(使用「寫入」工具套用其計畫寫入的 career/recognition.json;此操作需要網路)。
  2. 僅重新研究已過期或被標記的區段。保持其他所有區段不變。
  3. 詢問使用者「有什麼變化嗎?」,涵蓋目標、主管、團隊以及看過他們工作的人。
  4. 如果時程區段被重新檢查,或者有旗標表示時程已公布,請重新執行 deadlines.py 並更新 calendar.manager_conversation。
  5. 當未完成欄位的證據發生變化時(某個步驟已完成或不再是成本最低的選項,則予以替換),更新其 next_step,並補上任何遺漏的 label。
  6. 為每個重新檢查的區段更新 checked_at,清除你已處理的旗標,然後儲存。

表揚

當使用者公司使用同儕表揚工具(目前支援 Bonusly)時,其感謝內容是使用者無需自行記錄的證明。設定方式:使用者在該工具中建立個人 API 權杖,並將其儲存到 ~/.config/flagrare/bonusly-token(或 config.json 中 skills.career.recognition.token_file 指定的檔案)。切勿將權杖儲存在 config.json 或儲存庫中,也切勿將其貼到聊天中。然後執行 python3 <plugin root>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD>(使用「寫入」工具套用其計畫寫入的 career/recognition.json;此操作需要網路);recognition.py summary 提供總數、公司價值以及最常表揚使用者的人是誰;來自工具自動帳戶(生日、週年、歡迎)的感謝會被分開計算,且絕不會被視為人員或證據。僅引述關於使用者的內容。絕對不會透過該工具發送任何內容。

5. 申請文件模式 (/flagrare:promotion packet)

當申請文件截止日期接近,或使用者要求時:

  1. 載入地圖;如果沒有地圖,請先執行首次執行。蒐集自上次晉升(或入職日期)以來的證據:對於最多一個月的時間範圍,使用 /flagrare:brag-doc;對於更長的時間範圍,使用 /flagrare:impact-timeline。
  2. 使用公司範本起草申請文件,範本來自 process.packet_template(如果範本未知,請使用此通用結構並說明這是備用方案:標頭欄位,接著 2-3 個專案(角色、估算

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能