Codex 使用场景总览

本文把 Codex 端的使用文档按“安装验证、主链执行、多 agent 编排、specialist 使用、场景演练”组织起来。

1. 首次使用

• 安装与首个闭环：codex-quick-start.md
• 新项目接入：project-onboarding.md
• 按项目类型直接复制起手句：../../examples/project-type-starter-playbook.md
• 按更垂直项目类型复制连续脚本：../../examples/vertical-project-conversation-scripts.md
• GitHub Actions / AI Eval / 移动端 / 合规 / 内部平台 / 数据质量 demo script：github-actions-supply-chain-demo-script.md、ai-eval-platform-demo-script.md、mobile-miniapp-demo-script.md、security-compliance-platform-demo-script.md、internal-developer-platform-demo-script.md、data-observability-quality-demo-script.md
• 按材料成熟度选择 vertical 场景：../presentation/vertical-scenario-route-map.md
• 按表格查看 vertical 材料覆盖：vertical-scenario-capability-matrix.md
• 完整主链演练：first-team-workflow-walkthrough.md

2. Codex 特有工作方式

• Codex 工作流要领：codex-workflow-essentials.md
• 多 Agent 编排指南：codex-multi-agent-orchestration.md
• 命令与能力矩阵：command-and-capability-matrix.md
• runtime 能力总览：runtime-capabilities-overview.md

3. 日常协作与 specialist

• Specialist 命令工作簿：specialist-commands-playbook.md
• 如果你想优先体验 /tdd、/harness-audit 这类新增命令，也从 specialist-commands-playbook.md 进入
• Codex 场景化示例集：../../examples/codex-scenario-playbook.md
• Handoff 填充指南：handoff-filling-guide-with-examples.md
• Team Intake 完整示例：team-intake-example.md
• Team Plan 完整示例：team-plan-example.md
• Team Execute 完整示例：team-execute-example.md
• Team Handoff 完整示例：team-handoff-example.md
• Team Review 完整示例：team-review-example.md
• Team Release 完整示例：team-release-example.md
• API Mock 策略与生命周期手册：api-mocking-strategy-and-lifecycle-guide.md
• 前后端联调与验收清单：frontend-backend-integration-acceptance-checklist.md
• Consumer-Driven Contract 与 Mock 对齐指南：consumer-driven-contract-testing-with-mock-alignment.md
• Team 命令快速提示：team-commands-quick-prompts.md
• Codex 并行编排提示模板：codex-parallel-prompt-recipes.md
• 角色高频提示模板：role-prompt-recipes.md
• Codex 完整对话样例：codex-end-to-end-conversation-example.md
• QA 放行对话样例：qa-review-conversation-example.md
• DevOps 发布对话样例：devops-release-conversation-example.md
• Tech Lead 收口对话样例：tech-lead-closure-conversation-example.md
• Product Manager 需求澄清对话样例：product-manager-clarification-conversation-example.md
• Project Manager 计划推进对话样例：project-manager-planning-conversation-example.md
• Architect 方案设计对话样例：architect-design-conversation-example.md
• 60 秒跑通第一个 Team 命令：first-team-command-60-seconds.md
• QA 工程师日常操作：qa-engineer-daily-operations.md
• DevOps 工程师日常操作：devops-engineer-daily-operations.md
• 项目经理日常操作：project-manager-daily-operations.md
• Tech Lead 日常操作：tech-lead-daily-operations.md
• 产品经理日常操作：product-manager-daily-operations.md
• 架构师日常操作：architect-daily-operations.md

4. 共享 walkthrough

• Bug 修复全流程：bug-fix-complete-walkthrough.md
• Code Review 协作演练：code-review-collaboration-walkthrough.md
• 多服务后端集成演练：multi-service-backend-integration-walkthrough.md
• 紧急修复发布演练：hotfix-emergency-release-walkthrough.md
• 前端重构演练：frontend-refactor-walkthrough.md
• API 设计与演进演练：api-design-evolution-walkthrough.md
• 文档更新协作演练：documentation-update-walkthrough.md
• 构建失败处理演练：build-failure-recovery-walkthrough.md
• 需求澄清与范围管理演练：requirement-clarity-and-scope-walkthrough.md
• 系统架构设计与 ADR 演练：system-architecture-design-walkthrough.md
• 金丝雀灰度发布演练：canary-staging-release-walkthrough.md
• 生产事故应急响应演练：production-incident-response-walkthrough.md
• 发布后回滚与恢复演练：release-rollback-recovery-walkthrough.md
• 前后端并行开发与联调演练：frontend-backend-parallel-integration-walkthrough.md
• 并行研发协调演练：parallel-development-coordination-walkthrough.md
• 跨角色问题分诊演练：cross-role-issue-triage-walkthrough.md
• GitHub Actions 与供应链治理演练：github-actions-supply-chain-walkthrough.md
• AI Eval 平台演练：ai-eval-platform-walkthrough.md
• 移动端与小程序交付演练：mobile-miniapp-delivery-walkthrough.md
• IaC 与 Kubernetes 平台演练：iac-kubernetes-platform-walkthrough.md
• 插件与扩展平台演练：plugin-extension-platform-walkthrough.md
• 数据与 ML Pipeline 演练：data-ml-pipeline-walkthrough.md
• 安全与合规平台演练：security-compliance-platform-walkthrough.md
• 内部开发者平台演练：internal-developer-platform-walkthrough.md
• 数据可观测性与质量平台演练：data-observability-quality-walkthrough.md

5. 一页速查

• 前端缺陷修复一页速查：frontend-bugfix-one-page.md
• 发布收口一页速查：release-closure-one-page.md
• 事故分诊一页速查：incident-triage-one-page.md
• 管理层价值速查一页：executive-value-one-page.md

6. 受众阅读路径

• 实施接入阅读路径：implementation-onboarding-reading-path.md
• 团队培训阅读路径：team-training-reading-path.md

7. 排障与规范

• 安装与使用排障：troubleshooting.md
• 完整使用手册：team-skills-usage.md
• 命令输出合同：team-command-output-contracts.md
• 发布治理阅读路径：release-governance-reading-path.md
• 示例总索引：../../examples/INDEX.md

8. 企业扩展与发布收口

• 自定义 overlay 扩展：custom-overlay.md
• 自定义 overlay 创建入口：custom-overlay.md
• Langfuse 追踪与可观测性集成指南：langfuse-and-observability-integration-guide.md
• 发布治理阅读路径：release-governance-reading-path.md

9. 推荐阅读路径

8.1 第一次用 Codex

1. codex-quick-start.md
2. codex-workflow-essentials.md
3. first-team-workflow-walkthrough.md
4. ../../examples/codex-scenario-playbook.md

8.2 需要并行加速

1. codex-multi-agent-orchestration.md
2. specialist-commands-playbook.md
3. handoff-filling-guide-with-examples.md

8.3 需要新增能力路径

1. 想先看命令、skills、runtime 全景：看 command-and-capability-matrix.md
2. 想体验 /tdd、/harness-audit：看 codex-quick-start.md 和 ../../examples/codex-scenario-playbook.md
3. 想理解并行、budget、compact、cost、instinct：看 runtime-capabilities-overview.md

8.4 需要联调和跨角色协作

1. frontend-backend-parallel-integration-walkthrough.md
2. parallel-development-coordination-walkthrough.md
3. cross-role-issue-triage-walkthrough.md

8.5 需要质量或发布收口

1. qa-engineer-daily-operations.md
2. devops-engineer-daily-operations.md
3. hotfix-emergency-release-walkthrough.md

8.6 需要需求、架构或发布治理

1. product-manager-daily-operations.md
2. architect-daily-operations.md
3. canary-staging-release-walkthrough.md
4. production-incident-response-walkthrough.md

8.7 需要自定义 overlay 扩展能力

1. 想创建自定义 overlay，看 custom-overlay.md

8.8 按受众快速进入

1. 管理层先看 executive-value-one-page.md
2. 实施接入先看 implementation-onboarding-reading-path.md
3. 团队培训先看 team-training-reading-path.md