如果你一直在使用OpenAI的Codex命令行接口(CLI),你可能会发现它虽然强大,但使用起来就像驾驶一辆没有方向盘的赛车。它提供了原始的能力,但整个工作流程完全由你来掌控,容易陷入混乱。
这正是Oh My Codex的用武之地。这款工作流增强层在短时间内获得了近3000颗星,目前总星数已超过12000,它解决了开发者在使用AI编程代理时最大的痛点之一:混乱、不一致的工作流程,让你总是猜测AI代理到底做了什么。
为何重要?
问题不在于AI编程助手缺乏能力,而在于其“编排”能力。你启动一个会话,澄清需求,迭代解决方案,但在某个阶段,你可能会丢失上下文。AI代理是否完全理解了范围?它遵循了最佳实践吗?你甚至是否在解决正确的问题?
Oh My Codex通过提供以下功能直接解决了这些问题:
- 结构化的工作流程:引导你从需求澄清到任务完成。
- 代理团队:处理复杂的、多步骤的任务。
- 持久化状态管理:让你能从上次中断的地方继续。
- 规范技能:强制执行一致的执行模式。
它将Codex作为执行引擎,但为其包裹了我们大多数人之前未曾意识到却急需的“护栏”。
开始使用
前置条件
在深入了解之前,请确保你已具备:
- OpenAI Codex CLI 已安装并配置。
- Node.js 18+ 版本。
- 对AI编程助手工作原理的基本了解。
安装步骤
通过Git克隆仓库,进入目录,安装依赖,并可选地进行全局链接:
git clone https://github.com/Yeachan-Heo/oh-my-codex.git
cd oh-my-codex
npm install
npm link (可选,便于访问)
配置
Oh My Codex使用一个配置文件来定义你的工作流程和代理行为。在你的项目根目录创建一个名为.codex-workflow.yml的文件,示例如下:
workflows:
default: $deep-interview
skills:
$deep-interview:
description: "Clarify requirements before coding"
steps:
- analyze_request
- ask_clarifying_questions
- confirm_understanding
- propose_approach
- execute
$ralplan:
description: "Plan before implementation"
steps:
- decompose_problem
- identify_dependencies
- create_task_list
- estimate_effort
- present_plan
核心技能:$deep-interview
Oh My Codex真正的强大之处在于其预置的技能。其中,$deep-interview技能可能是最直接有用的。它强制AI在直接开始编写代码之前,先进行一个明确的需求澄清阶段,从而避免了盲目编码。