用途
gsd-review 用于从外部 AI CLI 请求对阶段计划(phase plans)的跨 AI 同行评审。该技能通过提及 $gsd-review 来调用,其后跟随的所有用户文本会被视为 {{GSD_ARGS}};若无参数,则 {{GSD_ARGS}} 视为空。
主要能力
技能流程为:检测 CLI → 构建评审提示词 → 调用每个 CLI → 收集响应 → 写入 REVIEWS.md。
支持的标志(Flags):
- --gemini:纳入 Gemini CLI 评审
- --claude:纳入 agent CLI 评审(使用独立会话)
- --codex:纳入 Codex CLI 评审
- --all:纳入所有可用 CLI
使用方式
通过提及 $gsd-review 调用该技能,并在其后附加参数。文档中包含 Codex 技能适配器(codex_skill_adapter)说明,用于在 Codex 环境中完成语法映射,主要包含以下映射关系:
AskUserQuestion → request_user_input 映射
GSD 工作流使用 AskUserQuestion(Claude Code 语法),需翻译为 Codex 的 request_user_input:
- 参数映射:header → header;question → question
- 选项格式由 "Label" — description 转换为 {label: "Label", description: "description"}
- 由 header 生成 id:转小写,空格替换为下划线
- 批量调用:AskUserQuestion([q1, q2]) → 单个 request_user_input,在 questions[] 中包含多个条目
- 多选变通:Codex 没有 multiSelect,改用连续的单选,或提供一个带编号的自由文本列表,要求用户输入以逗号分隔的数字
- 执行模式回退:当 request_user_input 被拒绝(Execute 模式)时,提供一个纯文本编号列表并选取一个合理的默认值
Task() → spawn_agent 映射
GSD 工作流使用 Task(...)(Claude Code 语法),需翻译为 Codex 协作工具:
- 直接映射:Task(subagent_type="X", prompt="Y") → spawn_agent(agent_type="X", message="Y")
- Task(model="...") → 省略(Codex 使用按角色配置,而非内联模型选择)
- fork_context:默认 false —— GSD agents 通过 <files_to_read> 块自行加载上下文
- 并行扇出:派生多个 agents → 收集 agent IDs → wait(ids) 等待全部完成
- 结果解析:在 agent 输出中查找结构化标记,例如 CHECKPOINT、PLAN COMPLETE、SUMMARY 等
- 从每个 agent 收集结果后调用 close_agent(id)
适用场景
需要在阶段计划上引入多个外部 AI CLI 进行同行评审的场景。可分别指定 Gemini、Claude、Codex,或使用 --all 纳入所有可用 CLI。
限制
关于计费、价格、支持平台、实际评审效果或更详细的使用步骤,资料中暂未提供。