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

工作流会自动：

• 以所有格式渲染 CV（PDF、LaTeX、Typst、Markdown、HTML）
• 将八个资源发布到 GitHub Release
• 将 HTML 部署到在线 CV 网站
• 创建 release.json 清单（由 MCP 服务使用）

所有资源均使用稳定、不含版本号的 URL，格式为 releases/latest/download/<name>。

重新发布现有版本

无需创建新标签即可重新运行发布工作流（适用于模板或渲染逻辑变更的情况）：

gh workflow run publish.yml -f tag=2026.09.14

也可以通过 GitHub Actions 界面操作：

1. 打开 Actions → Publish CV
2. 点击“Run workflow”
3. 在 tag 输入框中输入标签
4. 点击“Run workflow”

此操作会重新生成全部八个发布资源并重新部署网站，同时保留原版本号。releases/latest/download/ 下的资源会原地更新（覆盖）。

架构更新

schemas/ 中的 JSON Schema 与 cv-forge 保持同步。当 cv-forge 发布的新版本通过 export-schemas 更改了数据模型时，请更新此仓库中的架构：

1. 在 cv-forge 合并更改 src/cv_forge/models/ 的 PR 后，刷新同步的副本：

   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 中说“更新我的简历”或“添加这份工作”
2. 编辑：直接在对话中编辑 YAML
3. 验证：自动根据架构进行验证
4. 预览：预览渲染后的输出
5. 查看差异：确认后再创建 PR

无需手动编辑 YAML，也无需执行命令行操作。该插件使用你的 gh 身份验证来创建 PR。

相关仓库

• cv-forge — 用于渲染、托管和发布这些数据的工具集。包含 CLI、MCP 服务，以及两个 Claude Code 插件（cv 消费者插件、cv-forge 维护者插件）。