中文 Codex 实战手册

这是一个中文优先的 Codex Desktop GitHub Pages 实战手册，面向两类读者：

• 初学者：想知道如何在 Codex Desktop 里打开仓库、写清楚目标、审批操作并判断结果是否真的完成。
• 进阶用户：想系统使用 Goal、subagent、AGENTS.md、skills、MCP 和 Scheduled tasks（定时任务），并把 Codex 用成可验证的工程协作者。

内容结构

网页已从单页指南改成多页面实战手册，结构按“任务主线优先，概念能力补充，插件和提示词实践单独说明”的顺序组织：

1. 任务页：daily-workflow.html、desktop-cli.html（Desktop 操作页，保留旧链接文件名）、engineering.html、research.html、automation.html、workflows.html。
2. 概念页：codex.html、git.html、permissions.html、agents-md.html、skills.html、mcp.html、subagents.html、goal.html。
3. Skills 仓库选择页：skills-repositories.html，先看 Codex CLI 生态 Top 10，再比较 Compound Engineering、mattpocock/skills、academic-research-skills-codex、ARIS、leonxlnx/taste-skill、helloianneo/ian-xiaohei-illustrations 和 plexpt/awesome-chatgpt-prompts-zh 的能力、安装路径、prompt 示例和边界。
4. 插件页：compound-engineering.html，说明 EveryInc Compound Engineering plugin 在 Codex Desktop 中的安装和使用方式。
5. 提示词页：prompt-guidance.html，解读 OpenAI GPT-5.6 prompting guidance，并介绍第三方 refine-user-prompt skill。
6. 资料页：resources.html，汇总 OpenAI 官方资料、开源仓库和本指南内部资料。

快速开始

网页指南入口：

index.html

如果 GitHub Pages 以仓库根目录发布，访问地址通常是：

https://whojay0609.github.io/codex-usage-guide/

远程仓库：

https://github.com/WhoJay0609/codex-usage-guide

Compound Engineering plugin：

https://github.com/EveryInc/compound-engineering-plugin

Codex 相关高 stars 开源仓库选择页：

skills-repositories.html

GPT-5.6 提示词与 refine-user-prompt：

prompt-guidance.html
https://github.com/WhoJay0609/refine-user-prompt

仓库文件

• index.html: GitHub Pages 静态网页指南入口。
• assets/site.css: 全站共享视觉样式。
• assets/site.js: 全站共享搜索、复制、主题、导航和 Mermaid 渐进增强。
• assets/theme.js: 在共享 CSS 前应用有限的主题偏好，避免错误主题首屏闪烁。
• data/site-manifest.json: 21 个公开根页面、导航、描述、发布 URL 和逐页资料依据的唯一清单。
• data/changelog.json: 首页“最近更新”和完整更新记录的唯一数据源。
• data/heading-fragments.json: canonical 标题 fragment 与 legacy alias 的受审映射。
• data/publication-policy.json: 公开搜索语料的排除项、敏感内容规则和本地发布边界（doc/ 不进入公开页面链接）。
• scripts/check_site.py: 发布前静态检查，覆盖 HTML 页面、站内链接、锚点、关键章节、公开边界和搜索索引覆盖。
• *.html: 多页面指南，每页可直接通过 GitHub Pages 访问。
• skills-repositories.html: Codex 相关高 stars 开源仓库选择页，包含 skills、MCP、其他辅助工具、第三方仓库边界和可复制 Codex Desktop prompts。
• figures/*.mmd: Mermaid 流程图源文件，可在 GitHub 上预览。
• figures/*.md: Mermaid 图的 Markdown 包装文件。
• figures/*.png: 已渲染图，用于网页展示。
• .nojekyll: 让 GitHub Pages 原样发布静态文件。
• CONTEXT.md: 指南术语表。
• docs/adr/0001-dual-track-chinese-latex-guide.md: 文档结构和受众决策。
• AGENTS.md: 给 Codex/agent 使用的仓库工作规则。

插件、第三方 skills 与辅助工具备注

指南中提到的部分 skills 是插件或第三方扩展，不等同于 OpenAI 官方内置功能。发布或迁移到其它机器时，请以对应仓库、SKILL.md 或插件页面为准。

当前单独说明的扩展：

• compound-engineering: https://github.com/EveryInc/compound-engineering-plugin
• mattpocock/skills（当前上游 v1.2.2；Codex 走 skills.sh / npx skills@latest add，原生 Codex plugin 暂缓）: https://github.com/mattpocock/skills
• academic-research-skills-codex: https://github.com/Imbad0202/academic-research-skills-codex
• ARIS: https://github.com/wanshuiyin/auto-claude-code-research-in-sleep
• awesome-chatgpt-prompts-zh: https://github.com/plexpt/awesome-chatgpt-prompts-zh
• refine-user-prompt: 基于 GPT-5.6 prompting guidance 的第三方 skill：https://github.com/WhoJay0609/refine-user-prompt

发布建议

GitHub Pages 使用仓库根目录发布，index.html 是公开指南主入口。站点采用普通静态 HTML/CSS/JS，不需要构建步骤。data/site-manifest.json 列出公开根页面；doc/ 只保存本地执行记录，不能从公开页面链接进入，也不要把它发布为主内容。

发布前先运行：

make check

只检查生成产物和静态站点合同时运行：

make check-fast

需要本地浏览器回归时运行 make test-browser；部署完成后再运行 make check-published。后者会联网读取 manifest 中的全部 21 个公开页面和关键资产；部署前或网络不可用时必须记录为 not run，不能写成通过。

生成边界：scripts/build_site.py 只负责带 guide:* sentinel 的共享块、标题 fragment/alias、共享数据资产和受控属性归一化。正文、案例、prompt 与截图说明仍是 authored content；不要手改 sentinel 内代码，也不要让生成器用整页模板覆盖正文。真实 Desktop 截图只有在原分辨率脱敏复核完成后才能发布；当前缺失截图不得用 mock 代替。

这个检查会确认根目录 HTML 页面可解析、共享导航完整、站内链接和锚点存在，并且主要任务/资料页保留“真实实例”段落。需要 PDF 时再单独运行 make pdf。

src/main.tex 是独立维护的长文源，不会随 canonical HTML 页面或站点生成器自动同步。修改网页内容时不要假设 PDF 已同步；只有任务明确要求 PDF，并人工核对两套内容边界后，才运行 PDF 构建。

许可证

本项目采用 MIT License。