昇進
emダッシュは使用禁止。 このスキルが書き出すものにemダッシュを含めてはいけません。代わりにカンマ、コロン、または括弧を使用してください。リポジトリフックによって強制されます。
/flagrare:write-docsを参照。
平易な言葉。 ユーザーが読むものには、
<plugin root>/lib/career/GLOSSARY.mdの平易な名称を使用してください(「ルーブリック行」ではなく「シニアレベルの行動」、「パケット」ではなく「あなたの書面でのケース」)。用語が最初に登場するときは、簡単な説明を数語で付け、さらにユーザーが職場で聞くであろう会社独自の言葉を括弧書きで追加してください。
昇進は、ユーザーが立ち会えない会議室で、ユーザーのことをほとんど知らない人々によって、数ヶ月前に設定されたカレンダーに基づき、書面によるケースから決定されます。このスキルは、それらの事実を早期に明らかにします。すなわち、ユーザーがどこを目指しているのか、その理由、会社が実際にどのように決定するのか、ルーブリックが何を求めているのか、誰がユーザーの仕事内容を直接知っているのか、そして重要な会話がいつ行われなければならないのか、です。
このスキルは昇進マップを書き出します。ユーザーが読んで1on1に持参するためのpromotion-map.mdと、同じ事実を含み他のキャリアスキルが使用するpromotion-map.jsonです。マップはローカルかつプライベートです。このスキルは、いかなるものも投稿、送信、公開しません。
ライブラリ
プラグインには、<plugin root>/lib/career/にヘルパースクリプトが同梱されています。プラグインルートは、このスキルのベースディレクトリの2つ上のディレクトリです。各スクリプトはpython3 <plugin root>/lib/career/<script>.py ...として実行してください。これらはJSONを読み取り、表示するだけです。このスキルはWriteツールを使用してすべてのファイルを書き込みます。サンドボックス化されたシェルは~/.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に、マークダウンレイアウトはreference/map-template.mdにあります。その他の共有状態ファイル(コントリビューションログ、フラグ、イニシアチブ)については<plugin root>/lib/career/STATE.mdを参照してください。処理済みのフラグをクリアするには、フラグを除いたflags.jsonを書き戻します。
1. 状態を読み込む(毎回の実行時)
career_state.py planを実行します。各writeアクションをWriteツールで適用し、ターゲットが既に存在する場合は事前に読み取ります(Writeツールは読み取っていないファイルを上書きしません)。mkdirアクションは個別のステップを必要としません。フォルダは、その中に最初のファイルが書き込まれたときに作成されます。プレースホルダーマップを書き込まないでください。絶対に何も削除しないでください。~/.claude/skills/flagrare/config.json(トップレベルのIDキー、skills.promotionブロック)と、既存のマップがあればそれを読み取ります。設定ファイルまたはskills.promotionブロックがない場合は、デフォルト値で続行します。- マップがない場合は初回実行(セクション3)です。
map_schema.py checkの出力にmissingセクションがリストされているマップは、中断された初回実行を意味します。欠落しているセクションが最も初期のフェーズから再開します。それ以外の場合は更新(セクション4)を実行します。ただし、ユーザーがpacketモード(セクション5)を要求した場合は除きます。
/flagrare:careerから呼び出されます。 引数はモード(first_run、resume、refresh)と処理するセクションを指定します。指定されたセクションのみを処理します。引数にscheduledも含まれている場合は、インタビューや質問を絶対に行わず、ユーザーからの回答を必要としないセクション(プロセス、カレンダー、ルーブリック、組織、前例)のみを再調査して保存し、ユーザーを必要とする各セクション(ターゲット、人物、マネージャーへの質問)をコーディネーターのNeeds youリストの1行として返します。どちらの場合も、完全なマップではなく、何が変更されたかの短い要約を返します。
2. すべての事実に関するルール
- ソース、日付、ステータス。 すべての事実には、リンクまたは引用元の場所、確認した日付、およびステータス(
verified(生のソースから読み取り、引用済み)、unverified(要約、抜粋、または伝聞)、inferred(あなたの推論))が付与されます。 - 生のソースから逐語的に引用。 Fetchツールは要約・言い換えを行います。引用に依存する場合は、元のページ(例:ページのJSONまたはHTML)を再読み取りし、正確な単語を確認してください。
- 矛盾を表示し、黙って選択しない。 2つのソースが矛盾する場合(組織図とチームディレクトリ、プロセスページとラダーファイルなど)、両方を
alternativesとして保存し、ユーザーに伝えます。 - 「何も見つかりませんでした」は有効な結果です。 ステップで何も見つからなかった場合は、推測せずに具体的な質問を
manager_questionsに追加してください。多くの企業には文書化されたプロセスがありません。 - 人に関する事実は機密です。 ユーザー自身のやり取りのみを読み取ります。ユーザーの仕事に関する直接的なコンテキストを持つ人が誰かを記録します。人がどれだけ有用かというランク付けは決して行わないでください。
- ブラウザを使用する前に同意を求める HRポータルや内部サイトにアクセスする場合。
3. 初回実行
事前にユーザーに伝えてください。初回実行は長く、1時間以上かかることもよくあります。各フェーズの後に保存されるため、停止して再開できます。
毎回の保存では、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つの質問をします。
- 現在のレベルと目標レベル。
- トラック: 個人貢献者またはマネージャー。
- どのサイクルを目指しているか(ステップ4の後、カレンダーがわかってからこれに戻り、1つ提案してください)。
- なぜそれを望むのか、もっとやりたい仕事は何か、減らしたい仕事は何か。
- 目標レベルに関する2つの事実を調査: この会社で終着点か(それ以上の昇進が見込めない)、現在のレベルでの期待される在籍期間。両方を引用。
- 「なぜ」が何を変えるかを説明。 終着点の目標と「安心」という理由は、その目標をゴールにします。「お金」や「スコープ」という理由は、それを超えた計画を意味します。これをマップのセクション1に書き込みます。
- プロセス、カレンダー、パケットテンプレートを 接続されているすべてのソース(wiki、ドキュメント、チャットのお知らせ、ミーティングノート、HRポータル(同意を得て))から見つけます。また、製品の意思決定がどのように行われるか(意思決定ドキュメントと、通常誰がそれを推進するか)も見つけます。Oportunity-scanはこれを必要とします。
また、経営陣が何を測定しているかも見つけます。会社のテーマや戦略ドキュメント、OKRと計画ドキュメント、および計画ミーティングや全員集合で言及されていること(接続されている場合、Granolaなどのミーティングノートで)。ユーザーのエリアにとって重要な各メトリクスを
prioritiesに記録します。テーマ、メトリクス、そのベースラインと目標(それぞれソース付きの事実として)、それを所有するチーム、およびuser_lever(ユーザーの役割がメトリクスの主要なインプットを所有している場合はowner、ユーザーのシステムがそれをフィードしている場合はinput、レバーが別のチームにある場合はnone)。Oportunity-scanはこのリストに対して提案をランク付けします。優先事項はミーティングノートから取得し、人についての引用は絶対に使用しないでください。 target、process、calendar、sectionsのエントリを入力してマップ(JSONとMarkdown)を保存します。
フェーズ2: ルーブリックのギャップ
- マネージャーが評価の基準とする成果物(ラダースプレッドシート、チェックインワークブック)を見つけます。それについて書かれた散文ではありません。ユーザーに、自分のマネージャーがチェックインワークブックを使用しているかどうかを尋ねます。散文と成果物が矛盾する場合は、成果物を使用し、その不一致を
rubric.prose_mismatchesに記録します。 - 行動ごとに1つの
rubric.rowsエントリを構築します。現在のレベルのテキスト、目標レベルのテキスト、安定したID(<area>.<short-slug>)、およびlabel(行動を2〜4語の平易な言葉で表したもの。「問題を見つける」、「求められるレビュアー」)。ボードとダイジェストでは、IDの代わりにラベルが表示されます。 - 各行を
done、partial、not_startedのいずれかでマークし、career_state.py contributionsからのエビデンス、ユーザーに与えられた認知(認知ツールが設定されている場合。以下の「認知」を参照。各ボーナスとそのリンクが証明となり、それにタグ付けされた会社の価値観はコアバリューの行動を指します)、ユーザーのレビューと作業、およびユーザーが共有する過去のレビューノートを使用します。 - 保存。
フェーズ3: 組織とあなたの仕事を知る人々
- 組織: ユーザーの報告チェーン、ユーザーが異動する可能性のある各チームの上位にいる人物、および今後の変更(退職、新しいリーダー、ミーティングノートやお知らせからの再編)。すべての人物にソースとステータスが付与されます。
- あなたの仕事を知っている人、まずエビデンス、次にユーザー:
- ユーザー自身のやり取り(行ったレビューと受けたレビュー、共有スレッド、共有ミーティング、およびユーザーに認知を与えたすべての人)から人を提案し、それぞれにエビデンスリンクを付けます。ユーザーを認知した人は直接その仕事を見ています。その中で昇進委員会に所属している人をフラグ付けします。
- ユーザーに確認と修正を依頼し、ツールでは見えない元マネージャーやハッカソンチームなどを追加するよう依頼します。
seen_your_workとconfirmed_by_userを設定します。
- キャリブレーションに参加する人: プロセスドキュメントから推測し、その文を引用して
inferredとマークします。ユーザーの仕事を見たことがない、その会議に出席する人をリストアップします。 - 前例: 最近の昇進のお知らせを読み、何が評価されたかを記録し、「お知らせはナラティブであり、監査ではない」とマップに書き込みます。詳細ティアはユーザーが要求した場合のみ提供します。コード、ドキュメント、チケットを横断的にチェックし、誰が実際にその作業を開始したかを確認するものです。これはコストがかかり、デフォルトではオフです。
- 保存。
フェーズ4: 計画
- 期限: パケットの締め切りを指定して
deadlines.pyを実行します。今回のサイクルの日付が公開されている場合はそれを使用し、--publishedを渡します。それ以外の場合は、昨年の日付を今回のサイクルに投影し(同じ月、同じ日、1年後)、inferredのままにします。ユーザーに、自分のいる場所でのデッドタイムとなる休日や休暇の期間を尋ね、--deadとして渡します。「Xまでに完了していれば安心、Yまでに絶対」を記録し、そのステータスと状態も記録します。状態がpastの場合は、その旨を明確に伝え、次のサイクルを指定します。 - 未完了の行ごとに1つの次のステップ: すべての
doneではない行に対して、next_stepを書き込みます。会社について見つけた内容に合わせた、エビデンスを追加するための最も安価で具体的なアクション(「採用チャンネルで /interview とタイプする」、「パートナーダッシュボードでペアプロを1回提供する」、「共同所有するロードマップの一部をマネージャーに依頼する」)。ボードにはこれらのステップを含む最大3つのギャップが表示されるため、各ステップは目標ではなく、1週間で完了できるものにしてください。 - パケットの準備状況:
python3 <plugin root>/lib/career/coordinator.py readiness --home "$HOME" --today <date>を実行して、ルーブリックの各行のエビデンス数を取得し(行にタグ付けされたログエントリと行自体のエビデンス)、各テンプレートセクションを、それが参照する行からstrong、thin、emptyのいずれかでマークします。 - ピアフィードバックの候補:
recognition.py summaryから、ユーザーを最も認知した人々とその内容が、書面でのケースに含めるピアフィードバック(3〜5人)の第一候補です。それらをピアフィードバックノートに追加します。 - マネージャーへの質問: まだ不明なすべてのこと、および準備状況に関する質問(「<サイクル>は現実的ですか?何が欠けていますか?」)。
map_schema.py checkを実行します。エラーを修正し、保存します。- ユーザーに短い要約を表示します。ターゲット、2つの会話の日付、まだ示されていないシニアレベルの行動(ラベル別)、誰がまだ彼らの仕事を見る必要があるか、マネージャーへの質問。
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への書き込みをWriteツールで適用します。ネットワークが必要です)。- 古いセクションまたはフラグが設定されたセクションのみを再調査します。他のすべてのセクションはそのまま保持します。
- ユーザーに「何か変更はありますか?」と尋ねます。ターゲット、マネージャー、チーム、自分の仕事を見た人々をカバーします。
- カレンダーセクションが再チェックされた場合、またはフラグがカレンダーが公開されたことを示している場合は、
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への書き込みをWriteツールで適用します。ネットワークが必要です)。recognition.py summaryは合計、会社の価値観、誰がユーザーを最も認知したかを表示します。ツールの自動アカウント(誕生日、記念日、歓迎)からの感謝は別途カウントされ、人物や証拠として扱われることは決してありません。ユーザーについて言及されていることだけを引用します。ツールを介して何かが送信されることは決してありません。
5. パケットモード (/flagrare:promotion packet)
パケットの締め切りが近づいたとき、またはユーザーが要求したとき:
- マップを読み込みます。マップがない場合は、まず初回実行を実行します。前回の昇進日(または入社日)以降のエビデンスを収集します。1ヶ月以内の期間には
/flagrare:brag-docを、より長い期間には/flagrare:impact-timelineを使用します。 - 会社のテンプレートを使用してパケットをドラフトします。
process.packet_templateから取得します(テンプレートが不明な場合は、この共通形状を使用し、フォールバックであることを伝えます: ヘッダーフィールド、次に2〜3のプロジェクト(役割、見積もり...
(原文はここで切り捨てられていますが、重要なセクションは翻訳されています。)