cv

CV データリポジトリ

Francisco Perez-Sorrosal の CV コンテンツの唯一の信頼できる情報源です。YAML データ、検証スキーマ、公開ワークフローを格納しています。レンダリング済み成果物（PDF、HTML、LaTeX、Typst、Markdown）は GitHub Releases 経由で生成・リリースされ、このリポジトリにはコミットされません。

ここにあるもの

• cv-data/resume.yaml — 構造化された CV コンテンツ（職歴、学歴、スキル、出版物、特許など）
• cv-data/resume-semantics.yaml — セマンティックオーバーレイ（トピック、関係、注釈）
• schemas/ — 検証用 JSON Schema。 cv-forge の内容を反映しています
• .github/workflows/ — CI 検証とタグをトリガーとする公開処理

変更方法

CV データの編集を提案するには：

1. このリポジトリをクローンし、ブランチを作成します：git switch -c update/your-change
2. cv-data/resume.yaml または cv-data/resume-semantics.yaml を編集します
3. ローカルで検証します（下記を参照）
4. プッシュして main に対する PR を作成します

CI ワークフローが自動で検証します。チェックに合格したらマージし、「リリースの公開」に進みます。

PR を作成する前に検証する

# Install check-jsonschema (standalone CLI)
pip install check-jsonschema

# Validate both files
check-jsonschema --schemafile schemas/resume.schema.json cv-data/resume.yaml
check-jsonschema --schemafile schemas/semantics.schema.json cv-data/resume-semantics.yaml

すべて成功しましたか？ PR を作成できます。

リリースの公開

YYYY.MM.DD 形式の CalVer タグをプッシュするとリリースがトリガーされます（同日中に再リリースする場合は、任意で .N を付けられます。例：2026.09.13.1）。

git tag 2026.09.13
git push origin 2026.09.13

ワークフローは自動的に次の処理を行います：

• すべての形式（PDF、LaTeX、Typst、Markdown、HTML）で CV をレンダリングします
• 8 個のアセットを GitHub Release に公開します
• HTML を公開 CV サイトにデプロイします
• release.json マニフェストを作成します（MCP サーバーが使用します）

すべてのアセットは、releases/latest/download/<name> 配下の安定したバージョン番号なしの URL で公開されます。

既存のリリースを再公開する

新しいタグを作成せずに公開ワークフローを再実行するには（テンプレートやレンダリングロジックの変更時に便利です）：

gh workflow run publish.yml -f tag=2026.09.14

または GitHub Actions の UI から実行します：

1. Actions → Publish CV を開きます
2. 「Run workflow」をクリックします
3. tag 入力欄にタグを入力します
4. 「Run workflow」をクリックします

同じバージョン番号のまま、8 個すべてのリリースアセットを再生成し、サイトを再デプロイします。releases/latest/download/ のアセットはその場で更新（上書き）されます。

スキーマの更新

schemas/ の JSON スキーマは cv-forge の内容を反映しています。cv-forge がデータモデルを変更する新しいバージョンをリリースした場合（export-schemas 経由）、このリポジトリのスキーマを更新します：

1. src/cv_forge/models/ を変更する PR が cv-forge にマージされた後、反映済みのコピーを更新します：

   curl -s https://raw.githubusercontent.com/francisco-perez-sorrosal/cv-forge/v1/schemas/resume.schema.json > schemas/resume.schema.json
   curl -s https://raw.githubusercontent.com/francisco-perez-sorrosal/cv-forge/v1/schemas/semantics.schema.json > schemas/semantics.schema.json
   git add schemas/
   git commit -m "chore: sync schemas from cv-forge v1"
   git push
   

2. CI の差分チェック（.github/workflows/validate.yml）は、ローカルのスキーマとリモートの cv-forge v1 のコピーを比較します。差分がある場合はチェックが失敗し、上記の同期が完了するまで PR がブロックされます。cv-forge が v1 タグを付け替える数秒前にプッシュすると、上流の取得で 404 が発生して差分チェックが失敗することがあります。その場合は、タグが存在してから失敗した Validate CV Data ジョブを再実行してください。

CV の利用方法

データとして

• YAML ソース：resume.yaml と resume-semantics.yaml。リリースアセットとして公開されています（下記の URL パターンを参照）
• JSON：MCP サーバーは同じデータを JSON リソース（fps-cv://resume、fps-cv://semantics）および各エントリの検索機能として公開します

ドキュメントとして

• PDF：FranciscoPerezSorrosal_CV.pdf
• HTML（インタラクティブ）：FranciscoPerezSorrosal_CV.html。また、公開 CV サイトでも提供されています
• LaTeX（moderncv）：FranciscoPerezSorrosal_CV.tex
• Typst（moderner-cv）：FranciscoPerezSorrosal_CV.typ
• Markdown：FranciscoPerezSorrosal_CV.md

すべて https://github.com/francisco-perez-sorrosal/cv/releases/latest/download/<filename> から取得できます。

MCP 経由

cv Claude Code プラグインは、CV を提供する MCP サーバーに接続します：

MCP Server: https://fps-cv-mcp.wasmer.app/mcp

サーバーは最新のリリースデータを自動で取得するため、公開時にデプロイする必要はありません。

データの規約

エントリ ID の規則、相互参照のルール、日付形式、検証コマンドについては、CLAUDE.md を参照してください。

プラグインを使った編集

cv-forge メンテナープラグインでは、対話形式の編集フローを利用できます。

1. Claude Code から起動します：「CV を更新して」または「この職歴を追加して」
2. 会話内で YAML を直接編集します
3. スキーマに照らして自動的に検証します
4. レンダリング結果をプレビューします
5. PR を開く前に差分を確認して承認します

手作業での YAML 編集やコマンドラインでの作業は不要です。プラグインは PR に gh の認証情報を使用します。

関連リポジトリ

• cv-forge — このデータをレンダリング、配信、公開する仕組みです。CLI、MCP サーバー、および 2 つの Claude Code プラグイン（cv コンシューマー、cv-forge メンテナー）が含まれています。