AI Agent / 系统课时

运行测试与开发命令

运行测试与开发命令

代码修改完成并不代表任务完成。本课将让 Codex 识别项目已有脚本,按风险从低到高执行测试、静态检查和构建命令,并在需要权限时由你确认操作边界。

学习目标

  • 从项目配置中识别真实可用的验证命令
  • 安全授权 Codex 执行测试、检查和构建
  • 根据退出码和输出判断验证是否通过

先读取项目已有脚本

不要凭经验猜测命令。Node.js 项目应先查看 package.json 的 scripts,Java 项目应检查 Maven 或 Gradle 配置,Python 项目则查看 pyproject.toml、测试配置和项目文档。

可以先要求 Codex:“读取项目构建配置,列出与本次改动最相关的测试、静态检查和构建命令;先不要执行。”确认命令没有数据删除、发布、部署或生产环境副作用后,再授权运行。

按最小验证集执行

以下示例适用于定义了 test、lint 和 build 脚本的 Node.js 项目。真实项目的脚本名称可能不同。

bash
npm run
npm test
npm run lint
npm run build

预期输出

text
Lifecycle scripts included in <PACKAGE_NAME>:
  test
available via `npm run-script`:
  lint
  build

<Test command exits with code 0>
<Lint command exits with code 0>
<Build command exits with code 0>

动态的包名、耗时、测试数量和构建目录可能不同。判断成功时应优先看进程退出码,同时确认输出中没有被忽略的失败、跳过过多测试或只执行了无关测试。

处理权限请求

Codex 在本地运行命令时会受当前沙箱和审批策略约束。普通工作区内的读写和测试通常可以在已授权范围执行;访问工作区外目录、网络或其他高风险能力时,可能要求你批准。

收到审批请求时,先看完整命令、工作目录和目的。安装依赖、下载资源或启动外部服务可能需要网络;删除目录、修改系统配置、发布包和连接生产数据库不应因为“测试需要”就直接放行。需要收紧权限时,可在 Codex 中使用 /permissions 切换到只读或更谨慎的模式。

失败时先分类

验证失败通常分为三类:代码确实有缺陷、环境或依赖缺失、命令选择错误。让 Codex 先保留原始错误,再指出失败发生在哪一步、是否由本次改动引起,以及下一条最小诊断命令是什么。

不要让它在没有定位根因时连续修改大量文件。若测试失败与本次任务无关,应明确记录基线问题,并继续运行与当前改动更相关的检查;若失败由改动引起,则回到实现阶段修正后重新执行同一命令。

形成验证记录

任务结束前,要求 Codex 列出实际执行的命令、退出结果、通过的检查和未能执行的检查。未运行的测试必须明确标记,不能用“应该通过”代替验证。

构建成功只能证明代码能够构建,不能自动证明业务行为正确。至少还要运行与改动直接相关的测试或可观察行为检查。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

运行测试与开发命令

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通