重构 director subagents 为 Codex custom agents

This commit is contained in:
wxm
2026-05-18 23:06:35 +08:00
parent 8c7cd6c010
commit d29ea60382
10 changed files with 48 additions and 24 deletions

View File

@@ -4,8 +4,9 @@ This document defines the standard gate prompts for all director and lead review
across every workflow stage. Skills reference gate IDs from this document instead
of embedding full prompts inline — eliminating drift when prompts need updating.
**Scope**: All 7 production stages (Concept → Release), all 3 Tier 1 directors,
all key Tier 2 leads. Any skill, team orchestrator, or workflow may invoke these gates.
**Scope**: All 7 production stages (Concept → Release), all shared director
custom agents, and all key Tier 2 leads. Any skill, team orchestrator, or
workflow may invoke these gates.
---
@@ -14,12 +15,17 @@ all key Tier 2 leads. Any skill, team orchestrator, or workflow may invoke these
In any skill, replace an inline director prompt with a reference:
```
Spawn `creative-director` via subagent delegation using gate **CD-PILLARS** from
`docs/game-studio/director-gates.md`.
Spawn `creative-director` via Codex custom-agent delegation using gate
**CD-PILLARS** from `references/studio-docs/director-gates.md`.
```
Pass the context listed under that gate's **Context to pass** field, then handle
the verdict using the **Verdict handling** rules below.
The matching custom agent must already be defined at
`.codex/agents/<agent-name>.toml`. Pass the context listed under that gate's
**Context to pass** field, then handle the verdict using the **Verdict
handling** rules below.
Director names are Codex custom agent names. Do not recreate them by pasting
profile text into a generic default agent.
---
@@ -78,9 +84,11 @@ Apply the resolved mode:
```
# Apply mode check, then:
Spawn `[agent-name]` via subagent delegation:
- Gate: [GATE-ID] (see docs/game-studio/director-gates.md)
Spawn `[agent-name]` via Codex custom-agent delegation:
- Gate: [GATE-ID] (see references/studio-docs/director-gates.md)
- Custom agent file: .codex/agents/[agent-name].toml
- Context: [fields listed under that gate]
- Codex fork_context: false unless full thread context is required
- Await the verdict before proceeding.
```
@@ -88,8 +96,9 @@ For parallel spawning (multiple directors at the same gate point):
```
# Apply mode check for each gate first, then spawn all that survive:
Spawn all [N] agents simultaneously via subagent delegation — issue all subagent requests before
waiting for any result. Collect all verdicts before proceeding.
Spawn all [N] custom agents simultaneously via Codex subagent delegation. Issue
all subagent requests before waiting for any result. Collect all verdicts before
proceeding.
```
---
@@ -124,7 +133,7 @@ For phase gates, record in `docs/architecture/architecture.md` or
## Tier 1 — Creative Director Gates
Agent: `creative-director` | Model tier: Opus | Domain: Vision, pillars, player experience
Agent: `creative-director` | Custom agent file: `.codex/agents/creative-director.toml` | Domain: Vision, pillars, player experience
---
@@ -266,7 +275,7 @@ any session that produces player feedback
## Tier 1 — Technical Director Gates
Agent: `technical-director` | Model tier: Opus | Domain: Architecture, engine risk, performance
Agent: `technical-director` | Custom agent file: `.codex/agents/technical-director.toml` | Domain: Architecture, engine risk, performance
---
@@ -412,7 +421,7 @@ or before finalizing any engine-specific implementation approach
## Tier 1 — Producer Gates
Agent: `producer` | Model tier: Opus | Domain: Scope, timeline, dependencies, production risk
Agent: `producer` | Custom agent file: `.codex/agents/producer.toml` | Domain: Scope, timeline, dependencies, production risk
---
@@ -538,7 +547,7 @@ is invoked
## Tier 1 — Art Director Gates
Agent: `art-director` | Model tier: Sonnet | Domain: Visual identity, art bible, visual production readiness
Agent: `art-director` | Custom agent file: `.codex/agents/art-director.toml` | Domain: Visual identity, art bible, visual production readiness
---
@@ -573,7 +582,7 @@ Agent: `art-director` | Model tier: Sonnet | Domain: Visual identity, art bible,
**Context to pass**:
- Art bible path (`design/art/art-bible.md`)
- Game pillars and core fantasy
- Platform and performance constraints (from `docs/game-studio/technical-preferences.md` if configured)
- Platform and performance constraints (from the project technical preferences document, if configured)
- Visual identity anchor chosen during brainstorm (from `design/gdd/game-concept.md`)
**Prompt**:
@@ -619,7 +628,9 @@ Agent: `art-director` | Model tier: Sonnet | Domain: Visual identity, art bible,
## Tier 2 — Lead Gates
These gates are invoked by orchestration skills and senior skills when a domain
specialist's feasibility sign-off is needed. Tier 2 leads use Sonnet (default).
specialist's feasibility sign-off is needed. If a Tier 2 lead custom agent is
added later, invoke it with the same Codex custom-agent delegation pattern used
for Tier 1 agents.
---