让 Codex CLI 接管 bug 分诊：osFoundry 记录频道实操配置

作者演示如何让 Codex CLI 通过 MCP 自动分诊 osFoundry 项目里的 bug 记录频道：读 schema、翻页拉取 status 为 new 的条目，再逐条填写 Status、Owner 和 Severity。文章给出从建频道、授权连接到写提示词的完整步骤，并用一次模拟执行展示了服务端校验和版本冲突如何兜底。

分工与前提：Codex 写值，schema 定边界

• Codex 用 list_project_resources 找到记录频道，从 list_record_items 返回的 schema 读取字段规则；osFoundry 侧负责校验，类型错误或未知选项直接拒绝。
• 写入走 edit_record_item，会先弹 Codex 自己的写操作确认；改动在 Data 标签页里和同事的编辑一样可见，每次调用记录在连接的 Recent activity。
• 前提是 ~/.codex/config.toml 里已有 [mcp_servers.osfoundry] 配置，且 codex mcp login osfoundry 已完成。

四步配置：建频道、对 schema、加项目、裁工具

• 用 Create Record Channel 新建 Custom 类型频道，并在 Settings 里把 Project 指到 Codex 连接所在的项目——连接是经由项目到达频道的，挪走频道后下一次调用就会被拒。
• Schema 标签页是契约：每个字段有类型、Required 标记，Select/Multi-Select 有选项。注意 Codex 必须发送存储值（如 triaged）而不是标签（如 Triaged）；Formula 字段由表达式计算，谁都不能写。
• 在连接设置的 Projects 里点 Add to project，再到 Tools 确认 list/read/edit record item、poll resource events 等工具已启用；只想让 Codex 读就取消勾选 edit record item。
• 在 Codex 侧用 enabled_tools 只保留六个工具，default_tools_approval_mode 设为 writes：三个只读工具静默执行，每次 edit_record_item 才询问——40 条就是 40 次确认，也是 40 次可叫停的机会。

提示词怎么写：规则落纸，拒绝不猜

• 示例提示词明确：只处理 status 为 new 的条目、按最新优先；按 area 分配 owner（billing→aiko，auth→mika，其余→ren），并给出 severity。
• 强调用 schema 里的选项值而非标签；如果 osFoundry 拒绝某个值，不要猜，留空该字段并在最后列出。

一次真实跑法：两次拒绝救了两次场

• 分页用 before_id：每页以最旧条目结尾，下一页取它之前的条目，中途新报的 bug 不会把旧条目挤到后面，因此不会重复读取。
• Points 字段上限 13，Codex 提交 20 被整条拒绝后，它只去掉该字段保存其余，而不是把 20 砍成 13——被裁过的估算看起来像真实值。
• 版本冲突检查生效：Mika 在 Codex 读取和写入之间认领了某条 bug，expected_version 不匹配被拒，Codex 重读后保留她的状态和负责人，没有覆盖。
• 最终 38 条 new 处理了 37 条，1 条因描述写 about 20 points 超出字段范围而留空待人工。

边界在哪

• schema 就是值的上限：select 字段只接受选项值，In progress、Aiko Tanaka 这类标签会被拒而不是自动转换，因为转换等于猜测。
• 想让 Codex 不再就某字段询问，去 Schema 标签页改字段定义；Codex 无法从外部放宽限制。
• 新增/删除条目和改 schema 仍在 app 里做，Codex 只能改已有条目的字段值。