这是一个面向 Codex 的个人工作流 marketplace，用来持续沉淀可复用的 Codex 个性化能力：插件、skills、hooks、启动上下文、输出风格和开发辅助流程。
目标是把平时用着顺手的 Codex 配置打包起来，让别人也可以直接安装、启用和复用。
| 类型 | 说明 |
|---|---|
| Plugins | 完整的 Codex 插件包，可以包含 manifest、hooks、skills、MCP 配置或其他可安装能力。 |
| Skills | 可复用的任务工作流，让 Codex 在特定场景下按固定方法做事。 |
| Hooks | 在 Codex 生命周期事件中自动运行脚本，例如 session start、tool use、stop 等。 |
| Presets | 输出风格、协作习惯、项目启动上下文等可以复用的个性化设置。 |
| 插件 | 类型 | 说明 | 文档 |
|---|---|---|---|
| explanatory-output-style | Plugin + SessionStart Hook | 把 Claude Code 官方 explanatory-output-style 插件的解释型协作体验适配到 Codex。 | 插件文档 |
| commit-commands | Plugin + Skills + UserPromptSubmit Hook | 为提交加入分段的模型与思考强度 attribution，通过 UTF-8 文件安全创建并验证 GitHub.com/GitHub Enterprise PR 正文，并 force 清理 gone 分支。 | 插件文档 |
codex plugin marketplace add ZaunEkko/codex-plugins
codex plugin add explanatory-output-style@zaunekko
codex plugin add commit-commands@zaunekko包含 command hook 的插件首次运行前需要在 Codex 中 review 并 trust：
/hooks
安装并信任后，新开一个 Codex thread。当前插件会在会话启动阶段注入额外上下文：
Codex Session Start
↓
explanatory-output-style
↓
additionalContext 注入
↓
Codex 使用解释型输出风格协作
适合这些场景：
- 希望 Codex 不只给结果，也解释实现选择。
- 希望把常用提示词变成可安装插件。
- 希望给团队或朋友共享同一套 Codex 工作方式。
commit-commands 提供三个 Git 工作流 skill。Codex 可以根据“提交改动”“明确要求发布 PR”“清理 gone 分支”等明确意图自动选择，也可以使用 $ 强制调用：
$commit
$commit-push-pr
$clean-gone
在每个用户 turn 开始时，插件 hook 会解析当前 Codex 模型与思考强度，并让 $commit 与 $commit-push-pr 为新提交写入固定标识和动态 Model: <model> <effort> 段落。$commit-push-pr 也支持发布 clean worktree 中已有的分支提交，通过 UTF-8 文件避开 Windows PowerShell 5.1 的管道乱码，并在创建后验证完整 PR 正文及结尾的 Generated with [Codex](https://chatgpt.com/codex)。安装或更新后需要在 /hooks 中重新审查并信任该 hook。
这些 skill 不会仅因工作完成就擅自执行副作用。工作流步骤以 Anthropic 原版为准；其中 clean-gone 会像原版一样执行 git worktree remove --force 和 git branch -D，调用前必须先审查仓库状态。
每个插件单独维护文档，根 README 只保留入口导航：
- explanatory-output-style：解释型输出风格插件说明、安装、hook 信任方式和本地验证命令。
- commit-commands：提交、发布 PR、分支清理、安全边界和本地验证说明。
codex-plugins/
├── .agents/plugins/marketplace.json
├── .github/workflows/ci.yml
├── docs/<plugin-name>/README.md
├── plugins/<plugin-name>/.codex-plugin/plugin.json
├── plugins/<plugin-name>/hooks/
├── plugins/<plugin-name>/skills/<skill-name>/SKILL.md
├── i18n/<language>/docs/<plugin-name>/README.md
├── tests/
└── README.md
| 类型 | 方向 | 状态 |
|---|---|---|
| 输出风格 | explanatory-output-style | ✅ 已提供 |
| 项目上下文 | 自动注入项目约定、目录说明、常用命令 | 🧪 计划中 |
| Review 风格 | 固定代码审查口径和检查清单 | 🧪 计划中 |
| 开发辅助 | commit-commands Git 工作流 | ✅ 已提供 |
| Hook 自动化 | session/tool/stop 生命周期脚本 | 🧪 计划中 |
codex plugin list
python -m py_compile plugins/explanatory-output-style/hooks/session_start.py
python plugins/explanatory-output-style/hooks/session_start.py
python -m unittest discover -s tests- 安装前看清插件说明。
- 在
/hooks中 review command hook。 - 改动 hook 后重新 trust。
- 触发会提交、推送或删除分支的 skill 前先审查当前仓库状态。
- 不要把 API key、token、密码或机器专属路径写进 hook 输出。
本项目使用 MIT License 开源。
Made for reusable Codex workflows by ZaunEkko