iamaanahmad/everything-codex

everything-codex

一个实用、由社区维护的库，包含面向 OpenAI Codex 的提示词、Skills、工作流计划、自动化简报和配置示例。

重要提示： 本仓库是一系列可复用资产的集合，而非可安装的 Codex 扩展。请将模板调整适配到你的项目，并通过当前的 Codex 应用、CLI、IDE 扩展、GitHub 集成或组织控制进行配置。不要以为把这些 JSON 文件复制到 .codex/ 目录下，Codex 就会加载或运行它们。

本仓库存在的意义

Codex 如今可在 ChatGPT、IDE 扩展、CLI、GitHub 和团队工作流中运行。它可以执行云端任务、协助本地开发、审查拉取请求、使用 Skills 和基于 MCP 的工具，并安排持续性工作。本仓库为团队提供工程实践的起点，使这些能力变得可靠：清晰的指令、有边界的自动化、验证、审查和安全权限。

关于当前的平台行为、可用性和控制项，请以官方 Codex 文档为准。

Codex 目前能做什么

当前 Codex 的产品功能面包括：

- ChatGPT 和云端任务： 委派功能开发、重构、迁移和审查；使用并行工作树和云端环境处理独立任务。
- CLI 和 IDE： 在终端或受支持的基于 VS Code 的编辑器中本地工作，支持可编辑的差异、任务进度、审批、图像输入、网页搜索和 MCP 连接。
- GitHub： 自动或按需审查拉取请求，然后继续讨论或实施后续工作。
- Skills 和集成： 将团队标准和工作流固化为代码；使用插件和 MCP 连接已批准的外部工具。
- 自动化： 在 Codex 产品支持的情况下，安排常规后台工作并复用对话上下文。
- 团队管理： 符合条件的工作区可以应用环境控制、监控使用情况并管理云端环境。

可用性因套餐、地区、客户端和组织政策而异。在生产环境中依赖某项功能之前，请参阅 Codex 产品页面和官方文档。

仓库结构

everything-codex/
├── AGENTS.md                # 本仓库的贡献者说明
├── skills/                  # 可适配的指令及配套资源
├── automations/             # 计划性工作简报（JSON 模板）
├── workflows/               # 多智能体规划模板（JSON）
├── prompts/                 # 可复用的提示词集合
├── configs/                 # 说明性的策略与集成示例
├── examples/                # 示例项目
├── INSTALL.md               # 安全采用与迁移指南
├── CONTRIBUTING.md          # 模板贡献标准
├── COMPARISON.md            # 面向能力的评估指南
└── STATUS.md                # 当前仓库清单/状态

从这里开始

1. 安装或打开 Codex。 在 ChatGPT、IDE 扩展或 CLI 中使用 Codex。按照适用于你的客户端的当前快速入门进行操作。
2. 添加项目指令。 在目标仓库中创建一个 AGENTS.md，包含构建、测试、lint、安全和审查预期。保持具体且简短。
3. 选择一个模板。 从适合具体任务的提示词、Skill、工作流计划或自动化简报开始。
4. 进行调整。 替换占位符，指定目标仓库名称，确定所需工具和访问权限，并设置明确的输出/审查预期。
5. 以最小权限运行。 从受限或基于审批的模式开始。仅在必要时启用网络访问、MCP、插件、外部 API 或写入操作。
6. 验证并审查。 要求提供测试或其他适合该任务的证据；在合并或部署前检查每一项更改。

正确使用这些资产

项目指令

在目标仓库中使用 AGENTS.md 来建立约定和验证命令。示例：

Project instructions

- Run npm run lint and npm test after TypeScript changes.
- Do not change public API contracts without updating the changelog.
- Ask before adding dependencies or accessing production systems.
- Include a concise summary, test evidence, and remaining risks in the final response.

Skills

skills/ 下的目录是编写示例。它们的 skill.json 和 instructions.md 文件记录了一个可复用的工作流；它们不保证与产品管理的 Skill 清单匹配。使用你的客户端当前支持的设置，将指令复制到 Codex Skill 或项目工作流中，然后在一个小任务上测试结果。

自动化与工作流

automations/ 和 workflows/ 中的文件是可复用的任务简报。在 Codex 中创建定时自动化或并行任务计划时，将它们用作检查清单。对于每次使用，定义所有权、时区、权限、通知/审查行为、故障处理和退出条件。

配置与 MCP

configs/ 中的文件是示例，不是可直接使用的配置。配置格式和策略控制因 CLI、IDE、桌面应用、云环境和托管工作区而异。根据当前官方文档验证每个选项，切勿将机密信息放入受跟踪的文件中。优先使用你平台的机密存储或环境变量机制。

推荐的操作模式

| 目标 | 从以下内容开始 | 防护措施 |
| --- | --- | --- |
| 审查拉取请求 | skills/development/code-review-skill/ 或审查提示词 | 保留人工审查者；要求提供证据并运行相关测试。 |
| 实现功能 | workflows/feature-development/ | 拆分独立工作；指定最终集成负责人。 |
| 诊断缺陷 | workflows/bug-fix-workflow/ 和调试提示词 | 先复现；在适当情况下添加回归测试。 |
| 安全重构 | workflows/refactoring-workflow/ | 建立通过的基线并保持行为覆盖。 |
| 安排例行工作 | automations/ 模板 | 从只读开始；在外部写入或合并前要求审查。 |
| 连接外部系统 | configs/mcp-config.json 作为概念示例 | 仅使用受信任的服务器；限制令牌范围并审查工具权限。 |

安全基线

- 将仓库文件、网页、工具输出和问题文本视为不受信任的输入。
- 不要在提示词、源代码管理、日志、截图或生成的报告中暴露机密。
- 仔细审查权限请求，尤其是网络访问、shell 命令、云凭据和破坏性操作。
- 在可用控制措施的情况下，将云互联网访问限制在所需域内。
- 将代码审查作为额外的保障措施，而不是人工审查或部署控制的替代品。

贡献

参见 CONTRIBUTING.md。新模板应尽可能平台中立，明确说明假设，并作为文档进行验证，而不是表示为不受支持的可执行配置。

官方参考

- ChatGPT 中的 Codex
- Codex 文档
- Codex 产品更新
- Codex 全面可用公告

许可证

MIT。