---
title: "用 --output-schema 拿到机器可读结果"
summary: "CI 不要去解析散文。给 JSON Schema，让最终消息按合同输出。"
category: automation
level: advanced
surfaces: [ci]
tags: ["schema", "JSON", "管道"]
canonical: /tips/exec-schema/
---

# 用 --output-schema 拿到机器可读结果

CI 不要去解析散文。给 JSON Schema，让最终消息按合同输出。

```bash
codex exec --json --output-schema ./ci-schema.json \
  -o /tmp/codex-out.json \
  "总结失败的测试和最可能的修复。只输出 schema 里的字段。"
```

把这条和 `resume --last` 串起来：第一轮诊断，第二轮按同一 schema 执行。

`codex exec resume --output-schema` 在后续轮次也支持。结构化输出是 agent 进入管道的方式，不是事后用正则抠。

## 来源

- [Codex CLI Cheat Sheet](https://www.agenticcodingweekly.com/p/codex-cli-cheat-sheet)