Codex Perigon CLI 代码生成|用固定夹具核对顺序与路径
EnglishCodex 安装步骤
- 打开 GitHub 固定提交的 `.agents/skills/codegen/SKILL.md`,核对内容与使用条件。
- 在自己的项目中创建 `.agents/skills/codegen/`,把核对后的文件保存为 `.agents/skills/codegen/SKILL.md`。
- 在该项目根目录启动 Codex,输入 `$codegen` 并选择同名技能。
中文摘要
按 Perigon CLI 的 .NET 生成器约定组织 OpenAPI 或 Roslyn 数据处理,保持输出顺序和格式稳定。
SKILL.md 中文导读
可复现示例
为下面的模拟 OpenAPI 输入写确定性回归测试设计。
{"operations":["listLabels","getLabel"],"sameInputRuns":2,"outputKind":"TypeScript client","compare":"byte equality"}工作步骤
- 查找现有解析辅助方法、生成器和模板。
- 用类型化 API 提取结构,按项目顺序生成结果。
- 让同一夹具的输出摘要可以重复核验。
验收方法
对同一输入运行两次时应得到 `outputsEqual=true`。断言输出没有 `machine-specific path`,并检查生成的调用名称。
GitHub 原文 · 更新日期
适用环境
在 Codex 中打开 Perigon CLI,准备相关生成器和项目的 OpenAPI 测试夹具。
常见问题
OpenAPI 字段需要靠手工拆字符串吗?
存在结构化 API 时优先用 Microsoft.OpenApi 遍历,保持模型提取与输出拼装之间的边界。