ask-codex

# ask-codex（Cursor） ## 与 Codex 入口的区别（分别维护） | 客户端 | `SKILL.md` | `name` | 口令 | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------ | | Cursor（本文件） | **Windows** `%USERPROFILE%\.cursor\skills\ask-codex\SKILL.md` / **macOS** `/Users/<你的用户名>/.cursor/skills/ask-codex/SKILL.md` | `ask-codex` | `/ask-codex` | | Codex（OpenAI） | **Windows** `%USERPROFILE%\.codex\skills\codex\SKILL.md` / **macOS** `/Users/<你的用户名>/.codex/skills/codex/SKILL.md` | `codex` | `/codex` | 两处不要求逐句同步；归档与共读仍以 Codex 用户目录的 **`context.md`** 为准：**Windows** `%USERPROFILE%\.codex\context.md`；**macOS** `/Users/<你的用户名>/.codex/context.md`。 **关于 `~/.codex/AGENTS.md`（Codex 全局规则，含 Cursor 内嵌 Codex 扩展）**：`~` 表示**当前用户的主目录**。它与 **`C:\Users\Stark8964911\.codex\AGENTS.md`** 是同一类路径在不同 OS 上的写法：**Windows** 即 **`%USERPROFILE%\.codex\AGENTS.md`**（本机示例如此）；**macOS** 即 **`/Users/<你的用户名>/.codex/AGENTS.md`**，与 shell 中的 **`~/...`** 指向同一文件。下文路径表中有一行速查。 ## 目的 本 skill 是 Codex 用户目录工作区的默认分析入口：**Windows** `%USERPROFILE%\.codex`（本机示例：`C:\Users\Stark8964911\.codex`）；**macOS** `/Users/<你的用户名>/.codex`。 - **跨会话恢复**：新 chat 载入本 skill 后，**优先**读取 **Windows** `%USERPROFILE%\.codex\context.md` / **macOS** `/Users/<你的用户名>/.codex/context.md`，恢复与本工作区相关的历史任务与结论（避免仅依赖对话记忆） - **收敛范围**：区分「对齐背景 / 需求澄清」与「实现 / 排障 / 审查」，按**最小必要上下文**读文件，避免无目标整仓扫描 - **路由专项能力**：代码、规则、架构、审查等任务指向既有 Cursor skills 或项目内规则，不在本入口堆长程实现细节 - **持久化摘要**：在**本轮与 Codex 用户目录工作区相关的任务已交付或明确结束时**，将执行内容**精简追加**到同工作区的 `context.md`（**Windows** `%USERPROFILE%\.codex\context.md` / **macOS** `/Users/<你的用户名>/.codex/context.md`），供下次会话恢复 **与 Codex 入口的执行等价**：在 Cursor 中输入 **`/ask-codex`**，以及在 Cursor 内 Codex 插件中输入 **`/codex`**，都应执行同一套核心流程：先恢复 `context.md`，再读取项目规则与任务直接相关文件，最后在本工作区任务结束时回写 `context.md`。差异仅在入口命令与 skill 所在目录。 **非目标**：与本工作区无关的通用 Win11/Cursor IDE 问答（除非直接影响本目录工作流）——该类问题优先用 **`ask-cursor`**；其它业务仓库用各自 **`ask-*`**。 ## 何时使用 满足以下**任一**情况时启用本 skill： - 用户显式 **`@ask-codex`**、**`/ask-codex`** 或自然语言提及 **ask-codex**（若在纯 Codex 客户端对齐归档逻辑，改用 **`/codex`** 与 **Windows** `%USERPROFILE%\.codex\skills\codex\SKILL.md` / **macOS** `/Users/<你的用户名>/.codex/skills/codex/SKILL.md`） - **工作区根目录**为 **Windows** `%USERPROFILE%\.codex`（本机示例：`C:\Users\Stark8964911\.codex`）或 **macOS** `/Users/<你的用户名>/.codex`，且需要**项目级**引导或延续历史上下文 - 用户希望在 **Cursor 与 Codex 插件/CLI** 之间切换时，仍能保持**同一工作区的任务记忆**（事实以 `context.md` + 仓库文件为准） ## 新会话必读顺序（恢复上下文） 1. **`context.md`**：**Windows** `%USERPROFILE%\.codex\context.md`（本机示例：`C:\Users\Stark8964911\.codex\context.md`）；**macOS** `/Users/<你的用户名>/.codex/context.md` - 若文件为空或仅有说明头：在答复中注明「暂无历史归档」，不虚构过往任务。 - 若已有条目：**先概括**与用户当前问题最相关的近期条目，再展开新工作。 - 文件变长时：优先阅读**底部最近若干条**（本 skill 约定新条目追加在旧条目之后，最新在文件尾部）。 2. **`{workspace}/.cursor/rules/project-context.mdc`**（若存在） - 技术栈、目录、约定、长期决策；与 `context.md` 冲突时以**仓库内最新文件**为准。 3. 与用户任务直接相关的 **`README*`**、**`package.json`**、少量源码文件（**不要**默认通读全仓）。 | 优先级 | 来源 | 用途 | | ------ | ------------------------------------------------------------------------------------------------- | ------------------------------ | | 1 | **Windows** `%USERPROFILE%\.codex\context.md` / **macOS** `/Users/<你的用户名>/.codex/context.md` | 跨 chat 任务摘要、结论、遗留项 | | 2 | `{workspace}/.cursor/rules/project-context.mdc` | 项目稳定事实 | | 3 | 根目录 `README*`、`package.json` 等 | 环境与依赖锚点 | | 4 | 任务直接相关的源码/配置 | 实现与排障 | ## 子 skill / 子任务上下文完整性门禁 当用户在输入框或本文件 **「当前活跃需求」** 中提出任务时，先以本轮目标为准建立最小上下文清单，再执行实现或结论。每次入口 skill 又指向其它 skill、ask、command、BMAD 工作流或子任务时，必须做以下检查： 1. **先判定是否已读**：确认当前 chat 上下文里是否已经实际读取了对应 `SKILL.md`、`workflow.md`、`checklist.md`、`reference.md`、项目文档、同目录图片或其它被该子任务明确依赖的文件。 2. **缺什么补什么**：若缺失，按当前系统路径精确读取后再执行；不能只凭历史摘要、路径名、会话记忆或用户转述继续。 3. **按平台取路径**：Codex 用户目录统一写作 **Windows** `%USERPROFILE%\.codex` / **macOS** `/Users/<你的用户名>/.codex`（本机 macOS 示例：`/Users/stark/.codex`）；Cursor skills 统一写作 **Windows** `%USERPROFILE%\.cursor\skills` / **macOS** `/Users/<你的用户名>/.cursor/skills`。 4. **记录加载事实**：最终回复必须列出「当前 chat 已加载的关键文件」与「本轮新增读取/加载的文件」，只列对判断、修改或验证有实际影响的文件。 ## 工作区与本 skill 路径 | 用途 | Windows | macOS（示例） | | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- | | 工作区根 | `%USERPROFILE%\.codex`（本机示例：`C:\Users\Stark8964911\.codex`） | `/Users/<你的用户名>/.codex`（本机示例：`/Users/stark/.codex`；也可写作 `~/.codex`） | | 会话归档文件 | `%USERPROFILE%\.codex\context.md`（本机示例：`C:\Users\Stark8964911\.codex\context.md`） | `/Users/<你的用户名>/.codex/context.md`（本机示例：`/Users/stark/.codex/context.md`） | | 本 skill 文件 | `%USERPROFILE%\.cursor\skills\ask-codex\SKILL.md`（本机示例：`C:\Users\Stark8964911\.cursor\skills\ask-codex\SKILL.md`） | `/Users/<你的用户名>/.cursor/skills/ask-codex/SKILL.md`（本机示例：`/Users/stark/.cursor/skills/ask-codex/SKILL.md`） | | Codex 对口 skill（分别维护） | `%USERPROFILE%\.codex\skills\codex\SKILL.md`（本机示例：`C:\Users\Stark8964911\.codex\skills\codex\SKILL.md`） | `/Users/<你的用户名>/.codex/skills/codex/SKILL.md`（本机示例：`/Users/stark/.codex/skills/codex/SKILL.md`） | | **`AGENTS.md`（Codex / Cursor 内 Codex 插件）** | `%USERPROFILE%\.codex\AGENTS.md`（本机示例：`C:\Users\Stark8964911\.codex\AGENTS.md`） | `~/.codex/AGENTS.md`（绝对路径形如 `/Users/<用户名>/.codex/AGENTS.md`） | ### Cursor / Codex 用户目录分工 | 类型 | Windows | macOS | | ------------------------------ | ------------------------------ | -------------------------------------- | | Cursor Agent Skills | `%USERPROFILE%\.cursor\skills` | `/Users/<你的用户名>/.cursor/skills` | | Cursor 应用配置与用户数据 | `%APPDATA%\Cursor` | `~/Library/Application Support/Cursor` | | Codex 配置、规则、skills、归档 | `%USERPROFILE%\.codex` | `/Users/<你的用户名>/.codex` | ## 会话归档（`context.md`）——强制执行 在**本轮对话**中，只要同时满足： 1. 用户通过本 skill 或明确在 Codex 用户目录工作区上下文中推进任务（**Windows** `%USERPROFILE%\.codex` / **macOS** `/Users/<你的用户名>/.codex`），且 2. 该任务已达到**可交付、可复述的结束点**（完成实现、明确拒绝、或形成书面结论）， 则必须在结束回复**之前**，将以下内容**追加**到 **Windows** `%USERPROFILE%\.codex\context.md` / **macOS** `/Users/<你的用户名>/.codex/context.md`： - **一段一条目**，使用统一分隔与字段（便于检索与 diff） - **只写可复查事实**：做了什么、关键结论、改了哪些路径（如有）、待办与风险（如有） - **禁止**粘贴大段日志、完整 diff、或冗长对话原文；控制在约 **十几行至几十行内** ### 推荐条目格式（追加用） ```markdown --- ### YYYY-MM-DD — 简述标题 - **触发**：用户诉求一句（或 `/ask-codex`） - **结论/交付**：分点列出，可执行、可复查 - **涉及路径**：`path/one`、`path/two`（无则写「无」） - **后续**：可选；无则写「无」或删除本行 ```