SuperAPI AI 工具集

gsd-pr-branch

编程与开发

查看项目

更新于 10-16 06:27

技能介绍

gsd-pr-branch 是一个用于生成整洁 PR 分支的技能,主要用途是解决 PR diff 中混入与代码审查无关的规划文件变更的问题。根据资料描述,它通过过滤掉 .planning/ 目录下的提交(例如 PLAN.md、SUMMARY.md、STATE.md 等),让 PR 分支保持“干净”,从而更适合代码审查。

调用方式:通过提及 $gsd-pr-branch 来触发该技能;触发之后出现的所有用户文本会被视为 {{GSD_ARGS}},作为参数传入。如果没有任何参数,则将 {{GSD_ARGS}} 视为空。

资料中还包含一段 <codex_skill_adapter> 说明,用于将该技能从 Claude Code 语法适配到 Codex 环境,主要包括三部分映射约定:

  1. Skill Invocation:由 $gsd-pr-branch 触发,后续文本作为 {{GSD_ARGS}}。

  2. AskUserQuestion → request_user_input 映射:header 映射到 header,question 映射到 question;选项的 “Label” — description 转换为 {label: "Label", description: "description"};id 由 header 生成,规则为小写并将空格替换为下划线。批量调用 AskUserQuestion([q1, q2]) 映射为单个 request_user_input,并在 questions[] 中包含多个条目。多选变通方案:Codex 没有 multiSelect,因此改用顺序单选,或给出编号的自由文本列表,请用户输入以逗号分隔的编号。执行模式回退:当 request_user_input 被拒绝(Execute mode)时,改为展示纯文本编号列表并选取一个合理的默认值。

  3. Task() → spawn_agent 映射:直接映射为 Task(subagent_type="X", prompt="Y") → spawn_agent(agent_type="X", message="Y");Task(model="...") 省略,因为 Codex 使用按角色配置而非内联模型选择;fork_context 默认 false,GSD 代理通过 <files_to_read> 块自行加载上下文。并行扇出:启动多个代理,收集代理 ID,然后用 wait(ids) 等待全部完成。结果解析:在代理输出中查找结构化标记,例如 CHECKPOINT、PLAN COMPLETE、SUMMARY 等;在每个代理的结果收集完成后调用 close_agent(id)。

执行上下文:资料给出 @/mnt/local-analysis/workspace-hub/.codex/get-shit-done/workflows/pr-branch.md 作为执行上下文引用。

适用场景:需要提交代码审查、且仓库中同时存在 .planning/ 规划类提交,希望 PR 分支只包含与代码相关的变更时。

限制与暂未提供:资料未说明该技能的具体过滤命令、分支命名规则、对已有分支的处理方式、冲突处理、是否支持自定义过滤路径、是否支持除 .planning/ 之外的目录,也未说明其依赖的环境、兼容的代码托管平台、收费情况。这些细节暂未提供。