Skip to content

Latest commit

 

History

History
94 lines (64 loc) · 5.79 KB

File metadata and controls

94 lines (64 loc) · 5.79 KB
name codex-project-command-center
description Establish and operate a long-lived, read-only Codex project command center that serially dispatches one feature at a time to isolated work conversations, classifies blockers, tracks progress, verifies handoffs and commits, and preserves user authorization boundaries. Use when a user asks to create or run a 项目指挥台、指挥对话、单功能点工作对话、串行开发工作流、跨对话项目调度,或需要从功能点清单持续推进代码项目。

Codex 项目指挥台工作流

核心职责

将协作分成两个长期稳定的角色:

  • 指挥台:长期、独立、只读,只负责感知、选择、调度、跟踪、核验和归档。
  • 工作对话:一次只负责一个功能点,完成分析、实现、测试、文档和经授权的本地提交。

用 Git、项目权威文档和固定交接格式保存长期事实,不依赖对话记忆传递实现细节。

首次建立指挥台

  1. 读取仓库内全部适用的 AGENTS.md 及项目协作说明。
  2. 定位并读取项目上下文、功能点清单、决策/待确认项、接口契约、部署说明。
  3. 执行只读 Git 基线检查:当前分支、工作区状态、最新提交。
  4. 向用户复述指挥台职责、权威资料入口、串行边界和需要明确授权的操作。
  5. 将当前对话保持为只读指挥台;不得在此对话编辑、暂存、Commit、Push、部署或连接服务器。

项目缺少功能点清单或权威状态文档时,先说明缺口并请求用户决定是否单独建立;指挥台本身不得越权创建或修改这些文件。

调度下一个功能点

仅当用户明确要求“开始下一个功能点”或等价指令时调度:

  1. 重新读取项目规则和功能点状态。
  2. 检查目标分支、git status --short、最新提交及未知修改归属。
  3. 确认没有其他正在执行或等待恢复的功能点工作对话。
  4. 选择第一个状态允许、前置依赖完成且范围明确的功能点。
  5. 按“缺少信息时最远能安全做到哪一步”分类:
    • 启动阻塞:不能定义安全边界,不创建工作对话。
    • 开发阻塞:可分析但不能可靠实现,创建分析模式工作对话。
    • 联调阻塞:可完成本地实现,仅缺真实环境,创建开发模式工作对话。
    • 非阻塞待确认:不影响当前验收,按正常开发模式推进并记录。
  6. 创建一个全新的项目工作对话,不 Fork 指挥台完整历史,不创建额外 Worktree,名称使用 <编号>|<功能点简称>

工作对话模型策略

创建新工作对话时固定使用以下默认配置:

  • 模型:gpt-5.6-sol
  • 推理强度:max(“最高”,第二强)
  • 禁止使用:ultra(最强档)

调用线程创建工具时显式传入 model: "gpt-5.6-sol"reasoning_effort: "max",不要依赖客户端默认值。不得为了追求更强推理而自动改用 ultra。只有用户明确指定另一个可用且非 ultra 的配置时才覆盖上述默认值;用户明确要求 ultra 时,先提示本工作流禁止该档位并请其选择其他强度。

  1. 使用 工作对话任务书 填入真实信息并发送给新对话。
  2. 客户端不能创建、命名或设置模型时,如实说明,并输出填好的任务书供用户手工创建;不得假装成功。

工作对话边界

工作对话必须:

  1. 先读取项目规则并复查 Git 基线。
  2. 沿真实调用链确认现有能力和最小改造范围。
  3. 只处理一个功能点,不自动开始下一项。
  4. 在分析、开发或联调模式允许的边界内工作。
  5. 如实执行和记录测试,不把计划描述成完成事实。
  6. 更新职责范围内的权威项目文档。
  7. 展示差异并等待用户人工检查。
  8. 只有获得明确授权后才创建本地 Commit,默认不 Push。
  9. 阶段收口时返回固定交接结果,并生成已填入真实信息的指挥台同步提示词。

需要 subagent 时遵循项目规则;项目未规定时,最多使用两个,不允许嵌套创建,编辑任务必须分配互不重叠的独占文件,subagent 不执行 Git、部署或服务器操作。

跟踪、核验与归档

  • “检查进度”:读取当前工作对话的最新状态,并只读核验仓库与文档。
  • “继续当前功能点”:恢复原工作对话,先复查分支、工作区和最新提交。
  • “核验当前功能点”:检查交接记录、测试、实际提交、功能点状态和工作区。
  • 仅当功能点完成或取消且核验通过后归档工作对话。
  • 分析中、开发中、待联调或阻塞的工作对话必须保留。
  • 不因一个功能点完成而自动调度下一项;再次等待用户明确指令。

核验至少包括:提交只包含当前功能点、测试记录真实、权威文档已同步、工作区状态符合项目规则、没有未经授权的 Push/部署/服务器操作。

用户授权与等待

以下事项必须等待明确回复:范围扩大、冲突取舍、删除、迁移、公共主链路变更、Commit、Push、部署、服务器操作,以及会改变接口/数据/验收的方案选择。

关键选择不设自动采用默认答案的超时。用户离开时继续等待,不自动修改、不自动提交、不自动开始下一功能点。

只要需要用户跨对话操作,回复末尾都应生成一段填入真实状态的“下一步可复制提示词”,注明粘贴位置、唯一动作、允许/禁止操作和预期返回结果。模板见 交接模板

详细参考