Codex 项目指挥台工作流

A reusable Codex skill for running long-lived software projects with a read-only command center and strictly serial, single-feature work conversations.

让一个长期 Codex 对话专注于项目调度，让每个功能点由独立工作对话完成分析、开发、测试与交接。

为什么使用它

长周期软件项目容易出现这些问题：

• 一个超长对话同时承担规划、编码和提交，边界逐渐失控；
• 多个任务并行修改同一工作目录，产生来源不明的差异；
• 阻塞项被简单理解为“完全不能做”，安全的分析工作也停滞；
• 测试、文档、Commit 和跨对话交接依赖人工总结；
• 指挥对话在核验进度时顺手修改代码，职责混杂。

这个 skill 将协作固定为“只读指挥台 + 单功能点工作对话”：指挥台负责选择、调度、跟踪与核验；工作对话一次只实现一个功能点，并用 Git 和权威项目文档保存长期事实。

核心能力

• 长期只读项目指挥台
• 严格串行的单功能点开发
• 启动、开发、联调与非阻塞待确认四级分类
• 分析、开发、联调三种工作模式
• 固定的任务书、阶段交接和同步提示词
• Commit、Push、部署与高风险操作的明确授权边界
• 工作对话恢复、核验和归档规则
• 可选且受控的 subagent 协作边界

工作方式

用户下令开始功能点
→ 指挥台只读检查 Git、依赖、状态和待确认项
→ 选择一个功能点并判断阻塞级别
→ 创建一个独立工作对话
→ 工作对话分析、实现、测试并更新权威文档
→ 用户检查并明确授权本地 Commit
→ 工作对话生成指挥台同步提示词
→ 指挥台只读核验并决定保留或归档
→ 用户再次下令后才开始下一个功能点

默认创建工作对话时显式使用：

配置	值
模型	gpt-5.6-sol
推理强度	max（最高，第二强）
禁止档位	ultra（最强档）

安装

将仓库克隆到 Codex 的个人 skills 目录：

PowerShell

git clone `
  https://github.com/Entropy-R/codex-project-command-center.git `
  "$HOME\.codex\skills\codex-project-command-center"

macOS / Linux

git clone \
  https://github.com/Entropy-R/codex-project-command-center.git \
  "${CODEX_HOME:-$HOME/.codex}/skills/codex-project-command-center"

重新打开 Codex 任务，使 skill 被发现。

快速开始

在项目目录中新建一个长期任务，然后发送：

使用 $codex-project-command-center 为当前项目建立长期只读指挥台。
请读取项目规则、功能点清单、决策与待确认项，并检查当前 Git 基线。
先说明你识别出的权威资料、串行边界和授权规则，不要修改仓库。

建立指挥台后，可以使用短指令：

开始下一个功能点

检查进度

继续当前功能点

核验当前功能点

推荐的项目资料

skill 不强制固定文件名，但项目最好维护以下权威信息：

• AGENTS.md 或同类项目协作规则
• 项目上下文与稳定技术边界
• 有编号、依赖、状态和验收标准的功能点清单
• 决策与待确认项记录
• 相关接口或算法契约
• 部署和联调说明

资料不完整时，指挥台会先指出缺口，不会虚构业务事实。

目录结构

codex-project-command-center/
├── SKILL.md
├── agents/
│   └── openai.yaml
└── references/
    ├── templates.md
    └── workflow-rules.md

• SKILL.md：核心调度和授权规则
• references/workflow-rules.md：阻塞分级、模式转换与异常处理
• references/templates.md：任务书、阶段交接和同步提示词模板

设计原则

1. 指挥台只读：调度入口不直接改代码或提交。
2. 一个对话一个功能点：避免范围和责任混杂。
3. 严格串行：共享工作目录中同时只允许一个工作对话实施。
4. 事实可追溯：Git 和权威文档保存长期状态。
5. 授权不推断：Commit、Push、部署及高风险操作必须有明确授权。
6. 不虚构契约：缺失信息按影响阶段分类，在安全边界内推进。

适用场景

• 有明确功能点清单的中长期软件项目
• 需要 Codex 跨多个任务持续协作的代码仓库
• 对提交范围、审计记录和人工确认要求较高的团队
• 多阶段交付，且开发与真实环境联调需要分离的项目

对于一次性、小范围、无需跨任务交接的修改，直接使用普通 Codex 开发任务通常更简单。

贡献

欢迎提交 Issue 分享你的项目协作场景、阻塞分类案例或模板改进建议。提交修改时，请保持核心原则：指挥台只读、单功能点串行、真实记录、明确授权。