ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

codex-plugin-cc项目概览:架构、命令、3个技能全解

codex-plugin-cc项目概览:架构、命令、3个技能全解 codex-plugin-cc项目概览架构、命令、3个技能全解【免费下载链接】codex-plugin-ccUse Codex from Claude Code to review code or delegate tasks.项目地址: https://gitcode.com/GitHub_Trending/co/codex-plugin-cccodex-plugin-cc是一个面向 Claude Code 用户的官方 Codex 插件让你无需切换工具就能在 Claude Code 内直接调用 Codex 完成代码审查code review或委托开发任务。一句话概括Claude Code 负责对话与调度Codex 负责重活两者共享同一台机器上的同一份本地 Codex CLI、同一份登录态与仓库配置。一、codex-plugin-cc 能帮你做什么安装后你会获得两大类能力 能力命令说明代码审查/codex:review只读审查质量等同在 Codex 里直接跑/review对抗式审查/codex:adversarial-review可指定焦点挑战设计与实现决策任务委托/codex:rescue把调查 Bug、修复问题等任务交给 Codex会话迁移/codex:transfer把当前会话上下文导出到 Codex 线程任务管理/codex:status、/codex:result、/codex:cancel查看进度、取回结果、取消后台任务环境自检/codex:setup检查 Codex 是否已安装并登录前置条件很简单Node.js 18.18以及一个 ChatGPT 订阅含免费或 OpenAI API Key。二、项目架构命令、钩子、脚本、技能四层协作这个项目README.md的目录结构非常清晰整个插件由四部分组成plugins/codex/ ├── commands/ 7 个斜杠命令的提示词定义 ├── hooks/ 生命周期钩子配置 ├── agents/ codex-rescue 子代理 ├── skills/ 3 个内置技能 ├── scripts/ Node.js 运行时代码核心 └── schemas/ 审查输出 JSON Schema1. 命令层commands/每个斜杠命令都是一个 Markdown 提示词文件定义参数、执行模式和输出规则。例如 review.md 规定审查命令只读、不改代码并引导在任务较大时优先后台运行。2. 钩子层hooks/hooks.json 注册了三类钩子——SessionStart/SessionEnd负责会话生命周期记录Stop钩子则驱动可选的审查门禁review gateClaude 准备收工时自动触发一次针对性 Codex 审查发现问题就阻止收工让 Claude 先修复。3. 运行时层scripts/核心入口是 codex-companion.mjs它负责把命令请求转发给本机 Codex。配套模块各司其职例如 app-server.mjs 封装 Codex app-server 协议job-control.mjs 管理后台任务state.mjs 持久化任务状态render.mjs 负责结果展示。4. 子代理层agents/codex-rescue.md 定义了codex:codex-rescue子代理。它的定位是薄转发器只负责把救援请求原样转发给运行时脚本不自己看代码、不自己查进度保证行为可控、输出可预期。三、最快上手4 步安装配置在 Claude Code 中依次执行/plugin marketplace add openai/codex-plugin-cc /plugin install codexopenai-codex /reload-plugins /codex:setup/codex:setup会检查本机 Codex 是否就绪缺失且可用 npm 时会询问是否帮你安装即npm install -g openai/codex已安装但未登录时会提示运行!codex login。安装成功后你可以在/agents列表里看到codex:codex-rescue子代理说明一切正常 ✅一个推荐的首次体验流程/codex:review --background /codex:status /codex:result四、7 个斜杠命令实战指南/codex:review快速只读审查审查当前未提交改动或用--base main审查整个分支。支持--wait前台等待和--background后台运行。注意它是只读的绝不修改代码多文件的大改动建议放后台跑。/codex:adversarial-review定向压力测试与review不同它接受额外的焦点文本可让 Codex 专门质疑某个决策/codex:adversarial-review --base main challenge whether this was the right caching design适合上线前针对鉴权、数据丢失、竞态条件等风险区域做对抗式审查。/codex:rescue把重活委托给 Codex通过codex:codex-rescue子代理把调查、修复类任务交给 Codex常用参数--resume/--fresh继续本仓库最近一次 Codex 线程或强制开新线程--model/--effort指定模型与推理强度spark会自动映射为轻量模型--background长任务放后台例如/codex:rescue --background investigate why the tests started failing。任务管理与会话迁移/codex:status查看当前仓库正在运行和最近完成的任务/codex:result取回已完成任务的完整输出附带会话 ID可用codex resume session-id在 Codex 中续跑/codex:cancel取消正在运行的后台任务/codex:transfer把 Claude Code 会话转成持久 Codex 线程打印codex resume命令实现跨工具接力调试五、3 个内置技能全解技能skills是插件的内部规范对普通用户不可直接调用但它们决定了插件的行为质量 1. codex-cli-runtime运行时调用契约定义在 SKILL.md。它约束 rescue 子代理只能发起一次task调用并把输出原样返回禁止自行探索仓库或追加分析从机制上防止子代理越权干活。2. codex-result-handling结果呈现规范定义在 SKILL.md。核心规则包括审查结果按严重度排序、文件路径和行号原样保留、推断与事实严格区分最关键的一条铁律——呈现审查发现后必须停下询问用户要修哪些严禁自动应用修复。3. gpt-5-4-prompting提示词工程指南定义在 SKILL.md。它教 Claude 如何像操作员而非协作伙伴那样给 Codex 写提示词用 XML 标签组织task、structured_output_contract、verification_loop、grounding_rules等结构化块并配套三份参考文档——prompt-blocks.md可复用提示块codex-prompt-recipes.md端到端模板codex-prompt-antipatterns.md常见反模式六、典型工作流与注意事项三个高频场景发版前审查/codex:review简单直接甩锅给 Codex/codex:rescue investigate why the build is failing in CI长任务后台跑/codex:adversarial-review --background然后/codex:status、/codex:result跟进配置复用插件复用本机 Codex 的全部配置包括~/.codex/config.toml用户级和项目根目录.codex/config.toml项目级需信任该仓库。想固定模型或推理强度在config.toml里配置即可。两个提醒⚠️使用量会计入你的 Codex 用量额度review gate/codex:setup --enable-review-gate会形成 Claude 与 Codex 的反复循环消耗较快只在计划密切盯守会话时开启七、常见疑问需要单独的 Codex 账号吗不需要额外账号插件直接使用本机 Codex CLI 的登录态没登录过则需 ChatGPT 账号或 API Key 登录一次。会另起一套运行时吗不会。它走的是本机同一个 Codex CLI 与 app server同一份仓库、同一份环境行为与直接使用 Codex 一致。我现有的 Codex 配置还能用吗可以完全沿用包括自定义 base URL 等设置。总结codex-plugin-cc 用命令 钩子 子代理 技能的轻量架构把 Codex 的审查与执行能力无缝接入了 Claude Code 工作流是双 AI 工具协作的一个务实范例。【免费下载链接】codex-plugin-ccUse Codex from Claude Code to review code or delegate tasks.项目地址: https://gitcode.com/GitHub_Trending/co/codex-plugin-cc创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表