B. AskUserQuestion → request_user_input Mapping
GSD workflows use AskUserQuestion (Claude Code syntax). Translate to Codex request_user_input:
Parameter mapping:
header → header
question → question
- Options formatted as
"Label" — description → {label: "Label", description: "description"}
- Generate
id from header: lowercase, replace spaces with underscores
Batched calls:
AskUserQuestion([q1, q2]) → single request_user_input with multiple entries in questions[]
Multi-select workaround:
- Codex has no
multiSelect. Use sequential single-selects, or present a numbered freeform list asking the user to enter comma-separated numbers.
Execute mode fallback:
- When
request_user_input is rejected (Execute mode), present a plain-text numbered list and pick a reasonable default.
C. Task() → spawn_agent Mapping
GSD workflows use Task(...) (Claude Code syntax). Translate to Codex collaboration tools:
Direct mapping:
Task(subagent_type="X", prompt="Y") → spawn_agent(agent_type="X", message="Y")
Task(model="...") → omit (Codex uses per-role config, not inline model selection)
fork_context: false by default — GSD agents load their own context via <files_to_read> blocks
Parallel fan-out:
- Spawn multiple agents → collect agent IDs →
wait(ids) for all to complete
Result parsing:
- Look for structured markers in agent output:
CHECKPOINT, PLAN COMPLETE, SUMMARY, etc.
close_agent(id) after collecting results from each agent
Arguments:
- Phase number (required) — which phase's REVIEW.md to fix (e.g., "2" or "02")
--all (optional) — include Info findings in fix scope (default: Critical + Warning only)
--auto (optional) — enable fix + re-review iteration loop, capped at 3 iterations
Output: {padded_phase}-REVIEW-FIX.md in phase directory + inline summary of fixes applied
Optional flags parsed from {{GSD_ARGS}}:
--all — Include Info findings in fix scope. Default behavior fixes Critical + Warning only.
--auto — Enable fix + re-review iteration loop. After applying fixes, re-run code-review at same depth. If new issues found, iterate. Cap at 3 iterations total. Without this flag, single fix pass only.
Context files (AGENTS.md, REVIEW.md, phase state) are resolved inside the workflow via gsd-sdk query init.phase-op and delegated to agent via config blocks.
Execute the code-review-fix workflow from @/home/delorenj/code/bhappy/.codex/get-shit-done/workflows/code-review-fix.md end-to-end.
The workflow (not this command) enforces these gates:
- Phase validation (before config gate)
- Config gate check (workflow.code_review)
- REVIEW.md existence check (error if missing)
- REVIEW.md status check (skip if clean/skipped)
- Agent spawning (gsd-code-fixer)
- Iteration loop (if --auto, capped at 3 iterations)
- Result presentation (inline summary + next steps)
1---2name: gsd-code-review-fix3description: Auto-fix issues found by code review in REVIEW.md. Spawns fixer agent, commits each fix atomically, produces REVIEW-FIX.md summary.4---56<codex_skill_adapter>7## A. Skill Invocation8- This skill is invoked by mentioning `$gsd-code-review-fix`.9- Treat all user text after `$gsd-code-review-fix` as `{{GSD_ARGS}}`.10- If no arguments are present, treat `{{GSD_ARGS}}` as empty.1112## B. AskUserQuestion → request_user_input Mapping13GSD workflows use `AskUserQuestion` (Claude Code syntax). Translate to Codex `request_user_input`:1415Parameter mapping:16- `header` → `header`17- `question` → `question`18- Options formatted as `"Label" — description` → `{label: "Label", description: "description"}`19- Generate `id` from header: lowercase, replace spaces with underscores2021Batched calls:22- `AskUserQuestion([q1, q2])` → single `request_user_input` with multiple entries in `questions[]`2324Multi-select workaround:25- Codex has no `multiSelect`. Use sequential single-selects, or present a numbered freeform list asking the user to enter comma-separated numbers.2627Execute mode fallback:28- When `request_user_input` is rejected (Execute mode), present a plain-text numbered list and pick a reasonable default.2930## C. Task() → spawn_agent Mapping31GSD workflows use `Task(...)` (Claude Code syntax). Translate to Codex collaboration tools:3233Direct mapping:34- `Task(subagent_type="X", prompt="Y")` → `spawn_agent(agent_type="X", message="Y")`35- `Task(model="...")` → omit (Codex uses per-role config, not inline model selection)36- `fork_context: false` by default — GSD agents load their own context via `<files_to_read>` blocks3738Parallel fan-out:39- Spawn multiple agents → collect agent IDs → `wait(ids)` for all to complete4041Result parsing:42- Look for structured markers in agent output: `CHECKPOINT`, `PLAN COMPLETE`, `SUMMARY`, etc.43- `close_agent(id)` after collecting results from each agent44</codex_skill_adapter>4546<objective>47Auto-fix issues found by code review. Reads REVIEW.md from the specified phase, spawns gsd-code-fixer agent to apply fixes, and produces REVIEW-FIX.md summary.4849Arguments:50- Phase number (required) — which phase's REVIEW.md to fix (e.g., "2" or "02")51- `--all` (optional) — include Info findings in fix scope (default: Critical + Warning only)52- `--auto` (optional) — enable fix + re-review iteration loop, capped at 3 iterations5354Output: {padded_phase}-REVIEW-FIX.md in phase directory + inline summary of fixes applied55</objective>5657<execution_context>58@/home/delorenj/code/bhappy/.codex/get-shit-done/workflows/code-review-fix.md59</execution_context>6061<context>62Phase: {{GSD_ARGS}} (first positional argument is phase number)6364Optional flags parsed from {{GSD_ARGS}}:65- `--all` — Include Info findings in fix scope. Default behavior fixes Critical + Warning only.66- `--auto` — Enable fix + re-review iteration loop. After applying fixes, re-run code-review at same depth. If new issues found, iterate. Cap at 3 iterations total. Without this flag, single fix pass only.6768Context files (AGENTS.md, REVIEW.md, phase state) are resolved inside the workflow via `gsd-sdk query init.phase-op` and delegated to agent via config blocks.69</context>7071<process>72This command is a thin dispatch layer. It parses arguments and delegates to the workflow.7374Execute the code-review-fix workflow from @/home/delorenj/code/bhappy/.codex/get-shit-done/workflows/code-review-fix.md end-to-end.7576The workflow (not this command) enforces these gates:77- Phase validation (before config gate)78- Config gate check (workflow.code_review)79- REVIEW.md existence check (error if missing)80- REVIEW.md status check (skip if clean/skipped)81- Agent spawning (gsd-code-fixer)82- Iteration loop (if --auto, capped at 3 iterations)83- Result presentation (inline summary + next steps)84</process>