Resumé ビルダー
エビデンスに基づく一つの経歴レコードを docs/personal/resumes/ 以下で管理し、そこからターゲットとなる履歴書を派生させ、明示的に公開とされたサブセットのみを個人ウェブサイトに公開します。
必要に応じて以下のサポートドキュメントを参照してください:
references/convention.md— 必須のファイルレイアウト、レコードフィールド、クレームID、バリアント、公開状態。references/website-sync.md— 履歴書ウェブサイトを発見・更新するが、それを第二の情報源にしないための方法。references/source-recovery.md— レガシーサイト、リポジトリ履歴、ブックマークマネージャ、アーカイブされた履歴書から職務経歴を復元する方法。assets/scaffold/— 空の履歴書ルート用のスターターファイル。
デフォルトの判断
事実は一度だけ存在し、バリアントは安定したIDでそれらを選択する。 役割や成果をバリアントにコピーして、それが乖離することを決して許可しない。正規レコードを更新し、その後、ターゲット役割のためにそのクレームを選択、順序付け、または狭い範囲で再構成する。ウェブサイトは公開ターゲットであり、正規の職務経歴データベースではない。
安全性と真実性
- 日付、役職、数値、資格、雇用主、クライアント、技術を決して捏造しない。不確かな素材は
status: needs-verificationとマークすること。 - 実際に知られている最も正確な日付を保持すること。フォーマットに合わせるために日を製造しない。
- 連絡先詳細、報酬、推薦状、顧客名、非公開のエビデンスは、明示的に別段の指定がない限りプライベートとして扱うこと。
- プライベートフィールドを公開リポジトリに公開またはコミットしないこと。
- エビデンスは、正規クレームの横にリンクまたは短い出典メモとして保持すること。機密性の高いソース資料を履歴書ツリーにコピーしないこと。
- 公開前に、重要な文言の変更や未解決の事実をユーザーに提示すること。
ワークフロー
- 個人ソースを見つける。
- 管理する
AGENTS.mdを読む。 docs/personal/resumes/を含むリポジトリルートを使用する。- ディレクトリがない場合は、
assets/scaffold/をそこにコピーすることを提案する。 - その
README.mdと、要求された変更に関与するすべてのレコードを読む。
- 管理する
- 編集前に在庫を確認する。
- 正規の役割、プロジェクト、クレームID、バリアント、公開ターゲットをリストアップする。
- レコードを現在の履歴書ウェブサイト、リポジトリ履歴、ブックマークされたソース、提供された履歴書ファイルと比較する。
- 矛盾、古いオープンエンドの役割、未確認のクレームを報告する。
- レガシーブートストラップの場合は、
references/source-recovery.mdに従う。
- まず正規の事実を更新する。
work-history/およびprojects/レコードを追加または修正する。- 再利用可能な成果には、それぞれ安定したクレームIDを付与する。
- 可視性、信頼度、エビデンス、
last_verifiedを記録する。 - 新しい事実が終了日を確定した場合、以前のオープンエンドの役割をクローズする。
- バリアントを構築またはリフレッシュする。
- 正規プロファイルと選択されたクレームIDから
variants/<slug>.mdを作成する。 - ターゲット役割に合わせてサマリー、順序、強調を調整する。
- 求人説明のキーワードは、正規のエビデンスがそれらをサポートする場合にのみ保持する。
- 特定アプリケーション向けのバリアントは、ここでアプリケーショントラッキングを複製するのではなく、既存のアプリケーションレコードにリンクする。
- 正規プロファイルと選択されたクレームIDから
- レンダリングしてレビューする。
- 選択されたすべてのクレームIDを解決する。
- 時系列、時制、一貫性、ページ長、連絡先フィールド、リンク、スペルをチェックする。
- 重要な編集箇所と
needs-verificationの項目をユーザーに提示する。
- 公開ターゲットを同期する。
references/website-sync.mdに従う。visibility: publicのレコードのみを更新する。- ターゲットリポジトリのコンテンツスキーマとローカル指示を保持する。
- 公開前に、利用可能な最も狭い範囲のバリデーションをビルドまたは実行する。
- 鮮度を記録する。
- バリアントの
last_reviewedを更新する。 - 確認されたウェブサイト更新後、ターゲットレコードの
last_publishedとソースリビジョンまたはコミットを更新する。 - 未公開または未確認のままのものを報告する。
- バリアントの
バリアントのルール
バリアントは以下のことができます:
- 正規クレームIDを選択し、順序付ける。
- ターゲット固有のサマリーを使用する。
- サポートされるクレームを、その意味を変えずに短縮する。
- サポートされるスキルを読みやすくグループ化する。
- 関連性のない役割、プロジェクト、クレームを省略する。
バリアントは以下をしてはなりません:
- バリアントにのみ存在する事実を作成する。
- 範囲、シニア度、所有権、数値的影響を誇張する。
- プライベートなクレームを公開する。
- 日付や役職を黙って変更する。
- 別のターゲットバリアントを上書きする。
完了チェック
- レンダリングされたすべてのクレームが1つの正規レコードに解決される。
- すべての公開クレームが明示的に public とマークされている。
- 未解決の矛盾が事実として提示されていない。
- 現在の役割は現在時制、完了した役割は過去時制が使用されている。
- 日付は時系列的に一貫しており、オープンエンドの役割は意図的なものである。
- ウェブサイトは同期後に指定された公開バリアントと一致している。
- 生成されたファイルは、正規レコードとバリアントから再現可能である。