Codex 路径类型指南
为 Codex Rust 代码选择兼容跨平台 URI 与本地路径的类型。
技能仅提供路径类型选择与迁移指导，没有脚本、网络访问、凭据处理或破坏性默认操作，且要求编辑保持最小并在困难时询问用户；但未明确用户确认、数据流披露、回滚方案或敏感路径处理边界，因此未满分。
规则结构一致，覆盖协议边界、内部类型、迁移约束及失败策略；但技能自身没有测试、示例执行结果或针对关键路径的诊断反馈。按静态校准，可靠性不超过10分。
名称、描述和触发条件清楚，适用于新增或明确迁移路径承载类型，并说明部分不适用场景；但缺少输入输出示例、更多非适用边界、中文说明及大陆网络环境适配证据，因此扣分。
具备简短的元数据、标题和分层要点，仓库提供Apache-2.0许可证与官方来源；但没有版本、变更记录、维护责任、更新路径、安装说明、示例或FAQ，维护信息不完整。
能够直接为Rust路径类型选择和URI迁移提供可操作约束，核心任务价值明确；但没有可验证的代表性产出、编译结果或测试覆盖，且实际迁移仍需人工判断。按静态校准取有效性上限7分。
技能内容本身是可审阅的原始规则，且仓库有许可证与CI相关材料；但未提供针对该技能关键路径的专门测试、第三方复现或交叉证据，结论主要依赖静态阅读。
- 该技能是迁移目标状态的指导，不是可独立执行或验证的自动化工具；采用前应检查相关类型是否实际存在并通过项目测试。
- 未说明路径转换失败、外部平台差异和安全相关路径的具体审查流程；不要仅凭文档假设迁移无回归。
- 未提供中文文档或大陆网络可达性信息，但其核心内容是本地代码审查指导，不明显依赖海外在线服务。
它能做什么 & 适用场景
该技能为 Codex 仓库中的操作系统路径类型选择提供规范。它重点处理 app-server 和 exec-server 协议中的路径表示，以及协议边界与内部实现之间的转换。指南覆盖旧版本地路径字符串、PathUri、AbsolutePathBuf 和 PathBuf 的使用场景。它还规定了迁移期间的兼容性、安全性、诊断和持久化约束。
在定义或明确迁移路径相关类型时，指导开发者选择 LegacyAppPathString、PathUri、AbsolutePathBuf、PathBuf 或 String。它要求在 app-server 协议边界转换路径表示，在 exec-server API 中使用 file:// URI，并为模型生成的工具参数保留普通 String 后再进行功能特定的路径处理。它还规定路径转换错误的处理方式、诊断中的 URI 表示以及迁移代码应保持小范围。
- 维护 app-server 协议类型，同时需要保留现有客户端发送和接收的本地路径字符串。
- 为 exec-server API 增加或迁移使用 file:// URI 的路径字段。
- 在共享于 app-server 和 exec-server 的依赖中设计不会混淆不同路径语义的 API。
- 处理模型生成的工具参数，使其支持任意操作系统上的原始相对路径或绝对路径。
- 迁移路径系统，同时避免改变模型可见文本或引入大量新的失败模式。
优缺点一览
- 明确区分协议边界类型、内部路径类型和模型工具参数类型。
- 覆盖旧客户端兼容、跨平台 URI、错误处理和诊断等迁移约束。
- 强调小范围修改，并限制 URI 进入持久化存储。
- 内容高度针对 Codex 仓库及其 app-server、exec-server 架构，通用 Rust 项目未必适用。
- 未提供脚本、测试套件或自动迁移工具。
- 未说明具体 PathUri 等类型的定义、API 细节或完整迁移示例。
如何安装
该技能位于 Codex 仓库的 .codex/skills/path-types/SKILL.md，README 未提供单独安装步骤。安装 Codex CLI 可使用：Mac 或 Linux 执行 curl -fsSL https://chatgpt.com/codex/install.sh | sh；Windows 执行 powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"；也可执行 npm install -g @openai/codex 或 brew install --cask codex。
如何使用
在 Codex 仓库中定义新路径类型或明确请求迁移现有路径类型时触发，例如：“请为 exec-server 协议新增的路径字段选择合适的 Rust 类型，并遵循 path-types 指南。”