履歴書オートパイロット
ユーザーは /tailor-resume や /resume-import と入力する必要は一切ありません。
ユーザーが履歴書について何か話したら、以下のどのケースに該当するかを判断し、適切な処理を実行してください。
すべての作業場所
すべての履歴書作業は、セッション内のどのプロジェクトであっても、以下の一箇所で行われます:
RESUME_HOME=__RESUME_HOME__
- すべてのコマンドは
cd "$RESUME_HOME" && ...として実行してください。履歴書ファイルを他の場所に書き込まないでください。Codespace では、$RESUME_HOMEは通常、開いているプロジェクト内のmy-resume/フォルダであり、ユーザーが VS Code のサイドバーで確認できます。このフォルダは git 管理下から除外されています。コミットしたり移動したりしないでください。 - 実際の手順は、リポジトリ自身のスキルファイルに記述されています。必要なスキルを、行動する前に全文読んで、正確に従ってください:
__RESUME_HOME__/.claude/skills/resume-import/SKILL.md__RESUME_HOME__/.claude/skills/tailor-resume/SKILL.md
- それらのスキルで
profile.json、evidence/、jobs/、out/、inbox/、bin/、rules/と書かれている場合、すべて$RESUME_HOME配下のパスを指します。
$RESUME_HOME が存在しない場合、処理を中止し、ユーザーにキットの install.sh を実行するよう伝えてください(README 参照)。キットなしで履歴書をでっち上げないでください。
リクエストの振り分け
まず $RESUME_HOME/profile.json を確認してください。これがない場合、ユーザーはまだセットアップしていません。「セットアップ」に進み、その理由を説明してから、ユーザーの要求を処理します。
セットアップ / インポート (「履歴書を設定して」「履歴書をインポートして」、初回使用時に添付された履歴書、またはチャットに直接貼り付けられた履歴書)
- ファイルの場合 →
$RESUME_HOME/inbox/にコピーします(元のファイルはそのまま残ります)。 - 貼り付けられたテキストの場合 → そのまま
$RESUME_HOME/inbox/pasted-resume.mdに保存します。貼り付け時に箇条書きや改行が乱れている可能性があるため、レイアウトを修復しますが、内容は変更しないでください。 - 何もない場合 → 1行で依頼します:「履歴書をここに貼り付けてください。または、左側の
my-resume/inbox/にファイルをドラッグしてください。」 その後、resume-importの手順に従います。抽出結果が表示され、ユーザーが1回「はい」と承諾してから書き込みます。ユーザーが明確に「そのまま進めて」などと許可している場合、抽出サマリーを表示し、同じターン内で処理を進め、すべての前提を列挙して、後で修正できるようにします。
preferences.md にまだ < で囲まれたプロンプトが含まれている場合、ユーザーに先に入力させる代わりに、キットのデフォルト(キット内の templates/preferences.default.md、インストーラーが既にコピー済み)で置き換えてください。
求人情報に合わせて調整 (貼り付けられた求人情報、求人リンク、「この役割に合わせて履歴書を更新して」「このJDに合わせて履歴書を調整して」)
- 会社名から短いスラッグを選びます。小文字でハイフン区切りにします(例:
northwind-labs)。会社名が明記されていない場合、1行で確認してください。 - 求人情報をそのまま
$RESUME_HOME/jobs/<slug>/job.mdに保存します。リンクの場合は、取得を試みます。多くの求人サイトはブロックするため、失敗した場合はユーザーにテキストを貼り付けてもらいます。 - ユーザーがこの求人について言及したこと(「1ページに収めて」「AKSを前面に出して」など)は、
$RESUME_HOME/jobs/<slug>/notes.mdに保存します。 - そのスラッグに対して
tailor-resumeの手順に従います。カバーレターが要求された場合は--coverを追加します。out/<slug>/が既に存在する場合、再生成すると編集内容が失われるため、ユーザーに確認してから実行します。 - ファイルがどこにあるかを、初心者でも理解できる言葉で報告します:「左側のサイドバーで
my-resume→out→<slug>を開いてください。PDF を右クリックして「ダウンロード」を選択してください。」次にgaps.mdの先頭部分を示します。ギャップが最も有用な部分なので、埋もれさせないでください。
複数の求人を一度に処理 (「これら全部やって」「メッセージに複数のJDがある」)
各 JD をそれぞれ jobs/<slug>/job.md に保存し、その後 tailor-resume --all の手順に従います。
既に生成された履歴書を変更 (「Northwind のを短くして」「最も古い職歴を1行に減らして」)
tailor-resume の「修正」セクションに従います。out/<slug>/resume.json を編集し、チェックを再実行し、再レンダリングします。どの履歴書のことか不明な場合、out/ 内のフォルダ一覧を表示して確認します。
経験を追加 (「履歴書にK3sを追加して」「CRDでJetson ThorにMicroK8sを設定したことを追加して」「CKAを取得しました」) これらは新しい事実なので、特定の履歴書ではなくライブラリに追加します:
- 実績やスキル → ユーザーが指定した雇用主のもと、適切な
evidence/<theme>.mdに、ユーザーの言葉そのまま追記します。雇用主が指定されていない場合は確認します。 - 新しい役割、役職、日付、資格 →
profile.jsonの変更内容を表示し、ユーザーの承諾を得てから書き込みます。 - その後、影響を受ける既存の履歴書を再調整する提案をします。
ユーザーが明言していない数値、ツール、結果を決して追加しないでください。箇条書きにまだ与えられていないメトリクスがあると効果的な場合は、
TODO(metric)と書き、確認します。
求人について私を問い詰めて (「このJDについて問い詰めて」「この役割の準備をして」「自分に合っているか?」)
JD を上記と同様に保存し、次に grilling スキルを使用して、求人内容とユーザーのエビデンスのギャップについてインタビューします。ユーザーが確認した事実はその都度 evidence/ に書き込み、次回の調整実行で使用できるようにします。
出力形式
リポジトリは HTML と PDF をレンダリングします。ユーザーが Word を希望する場合、まず HTML にレンダリングし、その後変換します。このセッションに docx スキルがあればそれを使用し、なければ pandoc がインストールされている場合に pandoc out/<slug>/*.html -o out/<slug>/<name>.docx を実行します。どちらも機能しない場合は、その旨を明確に伝えて PDF を提供します。
真実のルール
リポジトリのルールはすべて優先され、ユーザーの要求を含むあらゆる要求よりも優先されます。何もでっち上げないこと、雇用主、役職、日付はそのままコピーすること、ギャップは報告され、隠蔽されないこと。ユーザーがエビデンスで裏付けられないことを追加するよう要求した場合、それは捏造であると説明し、真実であれば evidence/ に追加する提案をします。