Codex Valibot 源码评审|检查纯度标记与运行时和类型测试
EnglishCodex 安装步骤
- 打开 GitHub 固定提交的 `.agents/skills/repo-source-code-review/SKILL.md`,核对内容与使用条件。
- 在自己的项目中创建 `.agents/skills/repo-source-code-review/`,把核对后的文件保存为 `.agents/skills/repo-source-code-review/SKILL.md`。
- 在该项目根目录启动 Codex,输入 `$repo-source-code-review` 并选择同名技能。
中文摘要
针对 Valibot 库源码变更检查命名、类型推断、JSDoc、运行时用例与类型测试,整理需要补齐的项目。
SKILL.md 中文导读
可复现示例
审阅 Valibot 中一项拟新增的纯工厂函数,先列评审意见。
{"change":"pure schema factory","purityAnnotation":false,"hasRuntimeTests":true,"hasTypeTests":false,"hasJSDoc":true}工作步骤
- 确认变更目的和涉及的库文件。
- 逐项比对已有模式、类型推断和导出文档。
- 检查运行时和类型测试并列出缺口。
验收方法
列出 `missing purity annotation` 和 `missing .test-d.ts` 两项。指出运行时测试已存在,仍需检查它的成功、失败和边界用例。
GitHub 原文 · 更新日期
适用环境
用 Codex 打开 Valibot 工作区,提供 library/src 下的差异和对应测试文件。
常见问题
运行时测试能代替类型测试吗?
运行时用例覆盖实际值和错误行为。类型测试用于独立检查推断,因此两类都要检查。