RenderCV 开发上下文
为 RenderCV 代码库的编写与审查提供架构导览、源码规范和参考文件索引，让 AI 助手按项目自身的标准产出代码。
该技能为纯开发上下文文档，仅以@引用指向仓库内源码、测试与文档，不要求网络访问、凭据或破坏性操作；唯一命令 `just format`/`just check` 属本地代码质量检查，风险面极小。扣分点：未明确数据流与失败时的回滚说明，发布者身份未经验证，静态审查无法确认被引用文件内容全部无害。
技能结构自洽：引用路径具体（schema/renderer/cli/tests/pyproject/justfile），代码规范（类型标注、docstring 顺序、just check 零错误）内部一致且与 pyproject 中 ruff/ty/pytest 配置相互印证。扣分点：静态审查无法执行验证，未说明引用文件缺失或 just 工具不可用时的失败反馈，环境前置条件（uv/just 安装）未在技能内声明。
触发条件明确写入 description（'Use when writing or reviewing RenderCV code'），受众（RenderCV 贡献者）与场景清晰，误触发风险低。扣分点：能力边界与非适用范围未显式声明（如仅适用于 2.x 代码库版本），未讨论中文环境或中国大陆可达性问题（docs.rendercv.com 等外链文档）；无执行性输出。
MIT 许可清晰，pyproject 元数据完整（版本 2.8、变更日志与文档 URL、维护者邮箱），仓库含活跃 CI 工作流，信息按'引用→指南→规范'分层可读。扣分点：技能自身无版本号/更新说明，未列出常见问题或已知限制，维护责任仅可从仓库间接推断。
作为开发上下文技能，能将贡献者需要的代码规范、文档路径与质量检查命令集中呈现，边际价值真实但有限（资深贡献者可自行阅读仓库）。扣分点：静态审查无法验证引用内容在当前版本是否完整可用，产出为间接上下文而非直接可用成果，成本收益证据有限。
仓库提供可审计的一手材料：测试目录、覆盖率徽章、CI 工作流（claude-issue-triage/claude-pr-review 及 test workflow 徽章）以及配套 evals（promptfoo 用例与验证 graders）佐证项目测试文化，但所评技能本身的关键声明（引用文件内容与规范执行）未被这些证据直接覆盖。静态审查不执行，无法宣称独立复现，故不高于 5。
- 本评估为纯静态源码审查，未执行任何命令或测试，结论置信度低。
- 技能依赖仓库内 @ 引用文件及 uv/just 工具链，缺少这些前置条件时可能无法按预期工作，失败反馈未在技能内说明。
- 技能自身无版本号与更新记录，仓库演进后引用路径或规范可能过时，使用前请核对当前代码。
- 未验证发布者身份；相关外链文档（docs.rendercv.com 等）在中国大陆网络可能不可达。
- 该技能仅适用于 RenderCV 代码库开发/评审场景，不适用于终端用户的简历生成任务（那是另一个技能的范畴）。
这个 Skill 能做什么，适合哪些场景？
这是 RenderCV 仓库内置的 Agent Skill，位于 .claude/skills/rendercv-development-context/。它不生成简历本身，而是面向开发者：把代码库架构文档、测试指南、JSON Schema 说明和 schema/renderer/cli 等源码目录挂进 AI 的上下文。技能正文固化了 RenderCV 的源码标准，包括 Python 3.12+ 严格类型标注、Google 风格 docstring，以及提交前必须通过 just check 零错误的要求。适合参与 RenderCV 本身开发的贡献者，而不是用 RenderCV 写简历的普通用户。
通过 @ 引用加载 docs/developer_guide/ 下的架构、测试、JSON Schema 文档，以及 src/rendercv/schema/、src/rendercv/renderer/、src/rendercv/cli/、tests/、pyproject.toml 和 justfile；提供三份实操指南：如何添加主题（add_theme）、如何添加语言环境（add_locale）、如何添加社交网络（add_social_network）；规定代码标准：所有函数、变量和类属性必须严格类型化，使用 type 语句、PEP 695 类型参数、管道联合类型（str | int）和 str | None 写法；要求 docstring 按 Google 风格组织，含 Why 和 Example 段落，并按描述→Why→Example→Args→Returns→Raises 的顺序排列；指定提交前运行 just format 和 just check，且 just check 必须零错误，仅在无替代方案时用 # ty: ignore 或 #NOQA 注释。
- 想给 RenderCV 贡献新主题的开发者，需要按 add_theme 指南和现有代码结构操作
- 为 RenderCV 添加新语言/locale 支持的贡献者，可依赖 add_locale 指南和 schema 上下文
- 审查 RenderCV 拉取请求的维护者，可据此检查类型标注、docstring 格式和 just check 是否通过
- 接手 RenderCV 代码库的新维护者，需要快速理解 schema/renderer/cli 三层的架构划分
- 用 AI 编码代理修改 RenderCV 源码的开发者，希望代理遵循项目自己的规范而非通用 Python 风格
这个 Skill 有哪些优点和局限？
- 代码标准具体可执行：严格类型化、PEP 695 语法、docstring 段落顺序都有明确规则，而非泛泛建议
- 附带的 @ 引用把架构文档和关键源码目录直接挂进上下文，省去手动检索
- 三份 how-to 指南（主题、locale、社交网络）覆盖了最常见的贡献场景
- 来自 RenderCV 官方仓库，与代码库同步维护，遵循 MIT 许可
- 只对 RenderCV 仓库本身有用，对外部项目没有价值
- 依赖仓库内的文件路径和 just 命令，脱离该 monorepo 上下文即失效
- 源材料未说明该技能本身是否经过评估测试（README 提到的 promptfoo 评估是针对面向用户的简历技能合集的）
如何安装这个 Skill？
该技能随 RenderCV 仓库以 .claude/skills/rendercv-development-context/ 形式分发。README 提到的安装命令 npx skills add rendercv/rendercv-skill 安装的是面向终端用户的简历技能合集，并非本开发技能；要将本开发技能用于 Claude Code，应克隆 rendercv/rendercv 仓库并让其位于项目的 .claude/skills/ 目录下（或按所用客户端的 skills 目录约定放置），源材料未提供更具体的单独安装步骤。
如何使用这个 Skill？
在 Claude Code 等支持 Agent Skills 的客户端中，当提示涉及编写或审查 RenderCV 代码时，技能会依据其 description 被触发；也可以显式说“按照 rendercv-development-context 的规范给这个函数补 docstring”或“帮我按 add_theme 指南加一个新主题”。技能依赖仓库内的文件引用（@ 指向 docs、src、tests 等），因此必须在 RenderCV 仓库根目录的工作区中使用。