SuperAPI AI 工具集

initialize-worktree

编程与开发

查看项目

更新于 11-13 20:20

技能介绍

Initialize Worktree 用于从问题到 PR 的完整起步流程:研究一个问题或 GitHub issue,调研代码库,规划修复方案,可选地实现,并提交初始 PR。该技能假设目标分支已经被检出。

用途

  • 处理新的 GitHub issue(编号或 URL)或自由文本问题描述。
  • 在开始实现前完成问题理解、代码调研和计划编写。
  • 根据复杂度决定是先开仅含计划的 PR 讨论,还是直接实现并提交 PR。

主要流程

  1. 解析输入:支持 issue URL/编号(通过 gh issue view 获取标题、正文、评论、标签、状态、更新时间),自由文本按问题描述处理;输入为空时要求用户提供 issue 或描述问题。
  2. 研究:阅读 issue 全部评论、识别关键文件、受影响区域和相关测试,必要时搜索此前的尝试或相关 PR。
  3. 编写分支上下文文件:在 .claude/skills/branch-context/ 下新建 issue-brief.md,包含 frontmatter(最后获取时间、评论数、分支、关联 PR、issue 列表及评论指纹)以及问题、范围、成功标准、约束、受影响面、参考等章节;同时初始化 pr-decisions.md。写入后运行 check-autoload-safety.sh 检查,并重写以 @ 开头的引用直到通过。issue 文本须按不可信数据处理。
  4. 复杂度评估:列出复杂(仅计划 PR)与简单(实现+PR)的判断指标,并通过结构化提问向用户确认。
  5. 复杂路径:将讨论文档写入仓库根目录 PLAN.md,仅提交该文件,走通用 PR 交接,在 PR 正文中包含计划并说明对齐后实现。
  6. 简单路径:将本地实现计划写入 .claude/plans/<branch-name>.md,按计划实现,运行 make format && make lint 直至通过,提交全部改动并走通用 PR 交接。

通用 PR 交接

  • 创建 ready-for-review 的 PR,仅当用户明确要求时才用 draft。
  • 遵循 pushing-commits-to-the-repo 规范,包括推送前审查、PR 创建、当前 head 的 CI 与必需审查、反馈关闭和最终元数据。
  • PR 创建后在 issue-brief.md 中把 related_pr 设为 PR URL。

适用场景

  • 在 pydantic/pydantic-ai 仓库的新分支上开始处理新问题。
  • 需要先形成问题简报和计划、再决定是否实现的工作流。

限制

  • 假设分支已检出,且新分支尚无他人提交;若分支已有非本人提交,应改用 /adopt-pr。
  • 依赖仓库内的 AGENTS.md、agent_docs、.agents/skills/branch-context 等配套文件与脚本。
  • 未提供安装命令、收费或平台相关信息。