晉升
禁止使用破折號。 此技能寫出的任何內容皆不得包含破折號;請改用逗號、冒號或括號。此規則由儲存庫的鉤子強制執行。請參閱
/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. 載入狀態(每次執行)
- 執行
career_state.py plan。使用「寫入」工具套用每個write動作,如果目標檔案已存在,則先讀取它(「寫入」工具不會覆蓋未讀取過的檔案)。mkdir動作不需要獨立步驟:資料夾會在寫入第一個檔案時自動建立。請勿寫入佔位地圖。絕對不要刪除任何東西。 - 讀取
~/.claude/skills/flagrare/config.json(頂層身份鍵、skills.promotion區塊)以及現有地圖(如果有的話)。如果設定檔或skills.promotion區塊遺失,請使用預設值繼續。 - 沒有地圖代表首次執行(第 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:目標、流程及時程
- 先訪談,再進行任何研究。 一次問一個問題:
- 目前職等和目標職等。
- 軌道:技術職或管理職。
- 他們鎖定哪個週期(在步驟 4 之後再回來討論,屆時時程已明朗,並提出一個建議)。
- 為什麼他們想要這個晉升、他們想要更多什麼樣的工作、以及他們想要更少什麼樣的工作。
- 查詢關於目標職等的兩項事實: 此職等在此公司是否為終端職等(沒有再往上的預期),以及目前職等的預期時間帶為何。請引述兩者。
- 說明「為什麼」會帶來什麼改變。 終端職等加上「求心安」的「為什麼」,使這個目標成為終點線。「金錢」或「影響力」的「為什麼」則意味著需要規劃超越這個目標。將此寫入地圖的第 1 節。
- 在所有已連結的來源中尋找流程、時程和申請文件範本: 維基、文件、聊天公告、會議記錄、HR 入口網站(需經同意)。同時也找出產品決策是如何做出的:決策文件以及通常由誰主導。影響力掃描需要此資訊。
同時也找出領導層關注什麼:公司的主題或策略文件、OKR 與規劃文件,以及規劃會議和全員大會所傳達的訊息(從已連結的會議記錄中,例如 Granola)。記錄每個對使用者所屬領域重要的指標於
priorities中:主題、指標、其基線和目標(若有書面記錄,則每項皆須附帶來源)、負責的團隊,以及user_lever:owner(若使用者的職位擁有該指標主要輸入的控制權)、input(若他們的系統饋入該指標)、none(若控制權在其他團隊)。影響力掃描會根據此清單對提案進行排序。優先事項應取自會議記錄,切勿引用關於人的言論。 - 儲存地圖(JSON 和 Markdown),並填入
target、process、calendar和sections條目。
階段 2:評分表差距
- 尋找主管用來評分的文件(職涯階梯試算表、工作檢核手冊),而非關於它的文字敘述。詢問使用者他們的主管是否使用工作檢核手冊。如果文字敘述和文件不一致,請使用文件,並將不一致記錄在
rubric.prose_mismatches中。 - 為每個行為建立一個
rubric.rows條目:目前職等的文字、目標職等的文字、一個穩定的 ID(<area>.<short-slug>)、以及一個label(兩到四個平實詞語的行為描述,例如「發現問題」、「備受追捧的審查者」),看板和摘要會顯示label而非 ID。 - 將每個欄位標記為
done、partial或not_started,並附上來自career_state.py contributions的證據、同儕給予使用者的表揚(當表揚工具已設定時,請參閱下方的「表揚」章節:每個獎金及其連結都是證據,且其標記的公司價值指向核心價值行為)、使用者的評論和工作成果,以及使用者分享的過往審查記錄。 - 儲存。
階段 3:組織以及誰了解你的工作
- 組織: 使用者的彙報鏈、使用者可能加入的團隊的上一級主管、以及即將發生的變動(離職、新任領導者、重組,均來自會議記錄和公告)。每個人都需要附上來源和狀態。
- 誰了解你的工作,先看證據,再問使用者:
- 從使用者自身的互動中提出人選(給予和收到的評論、共享的討論串、共享的會議,以及所有給予他們表揚的人),並附上證據連結。曾經表揚過使用者的人已經親眼看過他們的工作成果;標記出任何同時也是晉升委員會成員的人。
- 請使用者確認和修正,並補充工具無法看到的資訊,例如前任主管或黑客松團隊的成員。
- 設定
seen_your_work和confirmed_by_user。
- 誰參與考核會議: 從流程文件中推斷,引述該句子,並標記為
inferred。列出與會者中那些未曾看過使用者工作成果的人。 - 先例: 閱讀近期晉升公告,了解哪些貢獻獲得了肯定,並在地圖中寫下「公告是敘事,而非審計」。僅在使用者要求時才提供深度層級:在程式碼、文件和工單中交叉比對實際發起工作的人是誰。此步驟成本高昂,且預設為關閉。
- 儲存。
階段 4:計畫
- 截止日期: 使用申請文件截止日期來執行
deadlines.py。如果本週期的日期已公布,請使用它並傳遞--published。否則,將去年的日期投射到本週期(同月同日,但延後一年),並標記為inferred。詢問使用者其所在地有哪些假期或休假週期是空檔時間,並將其作為--dead傳遞。以「舒適時間為 X,絕對時間為 Y」的格式記錄,並附上狀態。如果狀態為past,請直接說明,並指出下一個週期。 - 每個未完成的欄位都有一個下一步: 對於每個不是
done的欄位,寫下next_step:能夠增加證據的最簡單、最具體的可行動作,並根據你對該公司的了解量身訂做(例如「在招募頻道中輸入 /interview」、「提供一次夥伴儀表板的配對工作階段」、「向你的主管要求共同主導路線圖的一部分」)。看板會列出三個差距最大的項目的這些步驟,因此請確保每個步驟都能在一週內完成,而非一個目標。 - 申請文件準備就緒度: 執行
python3 <plugin root>/lib/career/coordinator.py readiness --home "$HOME" --today <date>以取得每個評分表欄位的證據數量(帶有該欄位標籤的日誌條目,加上該欄位自身的證據),然後根據這些欄位資料,將申請文件範本的每個區段標記為strong、thin或empty。 - 同儕回饋人選: 根據
recognition.py summary,最常表揚使用者的那些人以及他們表揚的內容,是書面陳述中同儕回饋的首選人選(3 到 5 位);將他們加入「同儕回饋」備註中。 - 主管問題: 所有仍未知的事項,加上準備就緒度的問題(「<現在週期> 的目標實際嗎?還缺少什麼?」)。
- 執行
map_schema.py check。修正任何錯誤,然後儲存。 - 向使用者顯示簡短摘要:目標、兩個對話日期、尚未展現的資深行為(依標籤)、還有誰需要看到他們的工作成果,以及要問主管的問題。指向
promotion-map.md。
4. 更新
- 執行
map_schema.py check,並讀取career/flags.json(如果有的話,其他技能會在那裡寫入過期訊號,例如重組、離職或時程公布)。當表揚工具已設定時,使用python3 <plugin root>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD>來更新表揚資料(使用「寫入」工具套用其計畫寫入的career/recognition.json;此操作需要網路)。 - 僅重新研究已過期或被標記的區段。保持其他所有區段不變。
- 詢問使用者「有什麼變化嗎?」,涵蓋目標、主管、團隊以及看過他們工作的人。
- 如果時程區段被重新檢查,或者有旗標表示時程已公布,請重新執行
deadlines.py並更新calendar.manager_conversation。 - 當未完成欄位的證據發生變化時(某個步驟已完成或不再是成本最低的選項,則予以替換),更新其
next_step,並補上任何遺漏的label。 - 為每個重新檢查的區段更新
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)
當申請文件截止日期接近,或使用者要求時:
- 載入地圖;如果沒有地圖,請先執行首次執行。蒐集自上次晉升(或入職日期)以來的證據:對於最多一個月的時間範圍,使用
/flagrare:brag-doc;對於更長的時間範圍,使用/flagrare:impact-timeline。 - 使用公司範本起草申請文件,範本來自
process.packet_template(如果範本未知,請使用此通用結構並說明這是備用方案:標頭欄位,接著 2-3 個專案(角色、估算