# From policy rules to a working prototype — with Codex

**对象：**做海关数据分析与研发的美国朋友。**时长：**30 分钟。**目标：**她能把一个有明确输入、规则和验收标准的任务交给 Codex，检查结果，并带走一个能运行的原型。

**核心句：**“You bring the domain judgment. Codex helps turn it into working, testable tools.”

讲解与演示默认中文；页面右上角可切换英文，切换时保留当前货物输入和计算结果。英文话术保留为可选参考。所有地区、分类、规则与税率均为教学虚构，不对应真实法案。这里的“地区”明确指原产地区，不等同于出口国或运输地点。

## 课前准备（不占 30 分钟）

在线分享地址：https://ppt.binghuozhuguang.com 。默认中文，右上角切换英文；页面底部可以下载大纲与 Demo 需求说明。

- 预先打开 Codex 并完成登录，选一个只放演示素材的独立文件夹；按公司政策确认允许使用的账号、工具和数据范围。
- 打开本目录 `index.html` 作为成品和备用演示；双击即可，无需 API Key、网络或服务器。
- 将 `demo-brief.md` 复制到另一个空文件夹，现场让 Codex 在那里生成，避免改写准备好的成品。
- 预演一次生成流程。现场生成速度不保证；超过 2 分钟就切到备用成品，把时间留给审阅与验证。

## 0–3 分钟｜从她的工作切入：为什么值得用？

**画面：**先展示成品页顶部，再停在规则实验室。

**开场：**“When a policy changes, how much time goes into understanding the change, updating rules, checking affected records, and explaining the result?”

把她的工作拆成四个产出：规则表 → 计算实现 → 回归样例 → 影响报告。Codex 可以帮助读代码、起草实现、运行检查并修改文件；人的价值在于提供业务含义和判断正确性。避免承诺固定倍数的提效。

**衡量效率：**记录从需求到可审阅原型的时间、人工修正次数、已知样例通过情况、能否解释每笔结果。写得快只是其中一项。

## 3–7 分钟｜哪些工作可以交给 Codex？

| 工作 | 给它的上下文 | 要求交付 | 人来确认 |
|---|---|---|---|
| 理解现有计算逻辑 | 入口函数、schema、样例 | 流程说明、规则定位、疑点 | 是否符合业务实际 |
| 清洗与分析数据 | 脱敏样例、字段定义 | 清洗脚本、重复/缺失报告 | 缺失值能否补、异常怎么处理 |
| 更新规则 | 经确认的规则说明、有效期 | 规则表、最小代码改动 | 法规解释与适用范围 |
| 验证变更 | 人工算出的样例 | 边界测试、前后差异 | 预期值是否可信 |

**话术：**“Ask for an artifact you can inspect: a script, a rule table, a test, or a change report.”

不要只问“这笔税是多少”。更好的任务是“根据这份已确认规则，实现可追溯的计算，并用这些样例验证”。

## 7–11 分钟｜怎么用：一次清晰的任务交接

在 Codex 中选中演示文件夹，指出文件 `demo-brief.md`。演示“需求 → 文件改动 → 运行结果 → 查看差异”的闭环。界面随版本可能变化，不依赖某个按钮位置。

提示词包含五件事：**目标、上下文、边界、交付物、验收标准**。信息不确定就明确标出来。

先发送（中文，英文版本供参考）：

```text
阅读 demo-brief.md，先总结规则关系，指出会影响计算结果的歧义。暂时不要实现，给出三个能手算验证的例子和预期结果。
```

```text
Read demo-brief.md. Summarize the rule relationships and list any ambiguity that would change a calculation. Do not implement yet. Give me three hand-checkable examples with expected results.
```

现场看它是否问清楚：原产地还是运输地？日期边界是否包含当天？豁免免掉哪个组件？重复规则怎么处理？只讨论本 Demo 已声明的简化口径。

**你应确认：**同一 base 组只取最高优先级；不同 surcharge 组可叠加；豁免只影响指定附加费；优先级相同且同时匹配时进入复核。优先级只在明确的互斥组内比较，不是法案效力的通用排序。

## 11–21 分钟｜现场做出一个可用 Demo

### 11–14：生成可运行页面

确认规则理解无误后，发送（中文，英文版本供参考）：

```text
按照 demo-brief.md 实现一个独立的 index.html，默认中文，支持英文切换。不使用外部依赖或 API。展示可编辑货物信息、两个规则版本、命中与跳过的规则及原因，以及明显的人工复核状态。验证需求中的验收样例，报告改动、实际执行的检查和剩余限制。
```

```text
Implement the prototype described in demo-brief.md as one self-contained index.html. Default to Chinese and provide an English language switch and no external dependencies or API calls. Show editable shipment inputs, both policy versions, matched and skipped rules with reasons, and a visible review state. Verify the acceptance examples in the brief. Report what you changed, the checks you actually ran, and any remaining limitations.
```

生成期间讲：Codex 正在把需求变成文件；最终计算应由明确规则和确定性代码执行。这个成品没有在线调用 AI，AI 参与的是开发过程。

### 14–18：运行并核对结果

打开生成页面（来不及就打开准备好的 `index.html`）。依次点击预设场景，先让朋友猜结果，再揭晓。

| 场景 | 版本 1 | 版本 2 | 说明 |
|---|---:|---:|---|
| Region A / Sensor / $10,000 / 2026-07-01 | $1,500 | $1,700 | base 5% + surcharge 10%→12% |
| 同上，有已核验的豁免凭证 | $500 | $500 | 只免 surcharge，base 仍在 |
| Region B / Sensor / $10,000 | $200 | $200 | 2% 特定 base 替代 5% 通用 base |
| Region A / Textile / $10,000 | $800 | $800 | Sensor 的附加规则不适用 |
| Region A / Sensor / 2026-06-30 | $1,500 | $1,500 | 新版本的 12% 尚未生效 |
| 原产地缺失或同优先级规则冲突 | REVIEW | REVIEW | 不输出猜测的金额 |

展示计算轨迹：哪些规则匹配、哪些没匹配、为什么被替代、哪条豁免了什么。所有金额为 USD；仅演示从价税，同一计税基数，按最终总额四舍五入到美分，不涉及真实收费、配额、数量税、反倾销/反补贴等复杂口径。

### 18–21：现场提出一次小变更

让朋友选一个改动。例如：“Region A 的 Sensor 附加税从 7 月 1 日起变为 12%”。预制页已包含这两个版本；现场生成时可先做 v1，再追加 v2，或用下面提示词检查已有版本：

```text
Review the v2 change: Region A sensor surcharge becomes 12% on 2026-07-01, inclusive. Before that date it remains 10%. Exempt shipments remain exempt from this surcharge. Compare v1 and v2 for our examples, verify the day before and the effective date, and explain which records change and why. Change only what is necessary.
```

**重点：**不要只盯着“代码写出来了”。看日期边界、例外规则、影响范围和回归结果。

## 21–25 分钟｜怎样判断它做对了？

- 选一笔自己能算清楚的样例：$10,000 × (5% + 12%) = $1,700；豁免后 $500。
- 检查异常：未知分类、缺失原产地、冲突、零或负值应拒绝或复核，不能当作 0% 静默通过。本 Demo 拒绝零值。
- 检查时间：生效前一天、当天、结束后一天。Demo 的日期区间两端都包含。
- 查看文件差异：是否只改目标规则？是否偷偷扩大豁免范围？
- 要它报告实际运行的命令、结果和没验证的部分；测试预期应来自人确认的规则，不能只由模型自证。

**可复制：**“Show me the evidence that this works, including one case where the tool must refuse to calculate.”

## 25–28 分钟｜使用准则：她的行业尤其要守住什么？

1. **数据边界：**使用公司批准的工具、账号与环境；先用合成/脱敏数据。真实报关数据、客户信息、凭据和受控材料按公司要求处理。“在本机操作”不等于“数据不离开机器”。
2. **规则来源：**AI 可以帮整理，但有效税率、分类、原产地和法案解释需要授权人员核验。生产规则保留来源、版本、生效时间、审批记录，必要时核查 USITC、CBP 及正式公告。
3. **权限边界：**从隔离演示目录和有限权限开始；数据库写入、生产部署、外发信息需明确授权。外部文档中的指令不自动变成执行授权。
4. **可复现：**保留输入、规则版本、计算轨迹和审阅结果；高风险变更走团队评审。未知或冲突进入人工复核。

**话术：**“Let AI accelerate implementation. Keep accountability for the rules and the release.”

## 28–30 分钟｜让她自己做一次，带走一个行动

请她提出一个新场景，用“目标 + 文件 + 边界 + 验收”写一条提示词，解释预期结果，再操作 Demo 验证。

结束问题：“What is one recurring task you could pilot with synthetic data this week?”

建议的首个试点：挑一条已确认的规则变更，产出规则表、可运行计算、5–10 个已知样例和影响对照；记录完成时间与修正次数，再决定是否接入真实流程。

## 中文变更提示词

```text
检查 v2 规则变更：地区 A 的传感器附加税从 2026-07-01 当天起变为 12%，此前仍为 10%。符合豁免条件的货物继续豁免这项附加税。对比样例在 v1/v2 下的结果，检查生效前一天与生效当天，说明哪些记录改变以及原因，只修改必要部分。
```

## 官方参考（2026-11-14 核对）

- [Codex 提示与任务示例](https://developers.openai.com/codex/prompting)：上下文、实现与验证工作流。
- [Codex 入门](https://developers.openai.com/codex/quickstart)：账号与工作目录入口；当前链接可能跳转到整合后的文档。
- [Codex 安全与权限](https://developers.openai.com/codex/security)：执行环境与权限控制参考。公司审批要求仍以她所在组织为准。

本文不是现行美国税法说明；示例数字不从现实税率推导。