# 法典技能指南 ## 何时使用此技能 **主要用例**： 1. 用户明确请求“codex”CLI执行（模式1：直接CLI） 2.需要GPT第二意见的复杂调试（模式2：GPT代表团） 3. 对陌生技术进行深入研究（模式二：GPT授权） 4、算法优化验证（方式二：GPT委托） **请勿用于**： * 简单代码解释 * 常规文件操作 * Claude可以直接处理的标准调试 ## 执行模式 ### 模式 1：直接 CLI 执行 **何时** ：用户明确要求运行 codex CLI（“codex exec”、“codexresume”） **工作流程**： 1. 利用“AskUserQuestion”评估和扩展用户查询，提供至少 5 个问题，每个问题都有多个选择选项，以确定最佳模型和推理工作。让第一个问题包括以下组合的选项： 2. 执行：`codex exec --skip-git-repo-check -m --config model_reasoning_effort="" --sandbox --full-auto 2>/dev/null` 3. 通知用户：“您可以随时使用‘codexresume’继续” **恢复** : `echo "新提示" | codex exec --skip-git-repo-checkresume --last 2>/dev/null` ### 模式 2：GPT 委托进行分析 **何时**：复杂问题需要第二意见（异步竞争条件、架构决策、算法验证） **工作流程**： 1. 分析背景并确定 GPT 分析有何帮助 2. 制定包含所有相关上下文的综合查询： * 问题陈述 * 目前的发现 * 代码片段（如果适用） * 错误信息 * 尝试过的解决方案 * 具体问题 3. 保持上下文简洁但完整（优选<10K tokens） 4. 执行：`codex -p "<详细上下文>"` 5. 将 GPT 响应综合为可行的见解 6. 报告调查结果： * GPT 分析的清晰总结 * 具体建议或解决方案 * 其他注意事项或警告 * 后续步骤（如果适用） ### 错误处理 * 在执行前验证 codex 二进制文件是否存在：`which codex` * 出现非零退出代码时立即停止并向用户报告 * 在重试失败的命令之前请求方向 * 使用前请参阅 AskUserQuestion 工具使用部分中的“高影响力标记确认”： * `--全自动` * `--沙箱危险-完全访问` * `--skip-git-repo-check` （默认，但向用户提及） ### 上下文管理 * 构建查询时优先考虑最相关的信息 * 如果上下文很大，则总结背景信息 * 将复杂的问题分解为具体的、可回答的问题 * 避免传递整个代码库 - 提取相关片段 ## AskUserQuestion 工具使用此技能使用 AskUserQuestion 工具进行所有用户交互。以下是标准调用模式： ### 初始配置（模式 1，步骤 1）在模式 1 执行开始时，通过一个问题收集模型、推理工作和沙箱模式： **像这样调用该工具：** 使用 AskUserQuestion ： - 问题：“选择 Codex 配置（模型、推理工作和沙箱）” - 选项： 1.“gpt-5.2-codex/高/只读（推荐）”-平衡，仅分析 2.“gpt-5.2-codex / xhigh /只读” - 最高质量，仅分析 3.“gpt-5.2-codex/high/workspace-write”-平衡，可以编辑文件 4.“gpt-5.2-codex/xhigh/workspace-write”-最大质量，可以编辑文件 5.“gpt-5.2/中等/只读”-更快，通用 6.“gpt-5.2-codex/high/danger-full-access”-网络/广泛访问 7.“自定义”-用户将分别指定模型、工作量和沙箱 ### 高影响力标志确认在使用 --full-auto 或危险标志执行之前： **像这样调用该工具：** 使用 AskUserQuestion ： - 问题：“准备好使用这些标志执行：[LIST FLAGS]。继续吗？” - 显示完整的命令预览 - 选项： 1.“立即执行”-按配置运行 2.“修改配置”-更改设置 3.“取消”-中止 ### 执行后跟进 codex 命令完成后： **像这样调用该工具：** 使用 AskUserQuestion ： - 问题：“法典已完成。[摘要]。下一步？” - 选项： 1.“通过附加提示继续”- 继续会话 2.“分析结果”-查看输出 3.“完成”——完成 4.“使用不同的配置重试”-调整设置 ### 错误恢复当命令失败或有警告时： **像这样调用该工具：** 使用 AskUserQuestion ： - 问题：“错误：[特定错误]。如何继续？” - 显示成功与失败的情况 - 选项： 1.“调整后继续”-修复并继续 2.“使用不同的配置重试”-更改模型/工作量/沙箱 3.“接受部分结果”——使用有效的结果 4.“调用治疗技能” - 修复过时的 SKILL.md ## 运行任务 1. 请参阅 AskUserQuestion 工具使用部分中的“初始配置”，以在一个问题中收集模型、推理工作和沙箱模式 2. 使用适当的选项组合命令： * `-m, --model <模型>` * `--config model_reasoning_effort=""` * `--sandbox <只读|工作区写入|危险完全访问>` * `--全自动` * `-C, --cd <目录>` * `--skip-git-repo-check` 3. 始终使用--skip-git-repo-check。 4. 继续上一个会话时，通过标准输入使用“codex exec --skip-git-repo-checkresume --last”。恢复时不要使用任何配置标志，除非用户明确请求。恢复语法：`echo“此处是您的提示”| codex exec --skip-git-repo-checkresume --last 2>/dev/null`。所有标志都必须插入到 exec 和resume 之间。 5. **重要**：默认情况下，将 `2>/dev/null` 附加到所有 `codex exec` 命令以抑制思考标记 (stderr)。仅当用户明确请求查看思考标记或需要调试时才显示 stderr。 6. 运行命令，捕获 stdout/stderr（根据需要进行过滤），并为用户总结结果。 7. **Codex 完成后**，通知用户：“您可以随时通过说‘Codex 恢复’或要求我继续进行其他分析或更改来恢复此 Codex 会话。” ### 快速参考使用案例|沙盒模式 |关键标志 ---|---|--- 只读评论或分析| `只读` | `--sandbox 只读 2>/dev/null` 应用本地编辑 | `工作区写入` | `--sandboxworkspace-write --full-auto 2>/dev/null` 允许网络或广泛访问 | `危险-完全访问` | `--sandboxanger-full-access --full-auto 2>/dev/null` 恢复最近的会话 |继承原创| `回显“提示” | codex exec --skip-git-repo-checkresume --last 2>/dev/null` 从另一个目录运行 |匹配任务需求| `-C ` 加上其他标志 `2>/dev/null` ## 跟进 * 在每个“codex”命令之后，请参阅 AskUserQuestion 工具使用部分中的“执行后后续操作” * 恢复时，通过标准输入传输新提示： `echo "new Prompt" | codex execresume --last 2>/dev/null`。恢复的会话自动使用与原始会话相同的模型、推理工作和沙箱模式。 * 在提出后续行动时重申所选择的模型、推理工作和沙盒模式。 ## 错误处理指南 * 每当“codex --version”或“codex exec”命令以非零值退出时停止并报告失败；在重试之前请求指示。 * 请参阅 AskUserQuestion 工具使用部分中的“高影响力标志确认”和“错误恢复” * 当输出包含警告或部分结果时，请参阅 AskUserQuestion 工具使用部分中的“错误恢复” ## 治疗技能整合当检测到 Codex CLI API 更改时（命令失败、意外的输出格式或已弃用的标志）： 1. **检测**：在执行过程中注意命令失败或API不匹配 2. **触发器** ：通过“/heal-skill codex”标记治疗技能 3. **分析**：修复代理使用“codex --help”和“codex features list”分析当前的 CLI 4. **更新**：更新技能文档以匹配当前API 5. **验证**：重新验证代理配置的兼容性 6. **模型验证**：确保仅引用 gpt-5.2 和 gpt-5.2-codex 模型 **监控的常见更改**： * 新的或已弃用的命令标志 * 沙箱模式或推理工作选项的更改 * 型号可用性更新 * MCP 集成更改 * 会话管理API修改

法典

包含技能