SuperAPI AI 工具集

ship-ponytail-ticket

编程与开发

查看项目

更新于 10-16 04:38

技能介绍

用途

Ship Ponytail Ticket 用于驱动一个工作项——一个已跟踪的工单,或对话中提供的需求——最终产出一个经过审查的草稿拉取请求(draft pull request)。它把父智能体定位为编排者,将实现、每一项审查以及每一次修复都交给独立的全新子智能体完成。

前置依赖

该技能要求三个工作流依赖技能:ponytail、ponytail-review、code-review。它会在仓库本地/项目级与全局/用户级安装的技能目录或目录清单中取并集,并按技能 frontmatter 中的名称(而非仅目录名)匹配。若任一缺失,会报告所有缺失名称及其来源分组并停止。对于 code-review,会引导用户执行 npx skills@latest add mattpocock/skills;对于 Ponytail 技能,会引导用户查看官方安装说明。安装后需重启 harness 并再次调用 $ship-ponytail-ticket。只有在刷新后的本地加全局并集包含全部三个技能时才继续。

主要能力与流程

  1. 固定工作项与分支:从调用参数或当前对话解析工作项。已跟踪工单会通过其跟踪器获取完整正文、评论、验收标准和关联上下文;若工单含糊、检索失败、被阻塞或需求细节不足以安全实现则停止。纯提示模式使用提供的需求和相关对话作为规格,说明范围与可检查的验收标准,不添加需求。随后读取仓库说明、检查相关代码路径、保留无关工作,记录当前分支为 <base-branch>、其 HEAD 为 <work-base>,并据此创建专用分支(命名遵循仓库或 harness 规则,否则已跟踪工单用 feat/<ticket-id>-<short-slug>,纯提示用 feat/<short-slug>)。定义提交主题格式 <type>(<scope>): <terse imperative summary>。

  2. 实现:在实现前从仓库说明、根与工作区清单、任务运行器、脚本和 CI 配置中发现完整验证工作流,清点所有可用验证命令(测试、linter、格式化、类型检查、构建等),据此定义 <validation-contract> 并逐字包含在每个实现与修复子智能体提示中。随后生成全新子智能体,加载并以全强度应用 ponytail,以现有接缝处最小正确改动实现全部需求与验收标准,运行聚焦检查并通过验证契约后提交。

  3. 审查与修复:记录 HEAD 为 <reviewed-head>,针对完整的 <work-base>...<reviewed-head> 差异按顺序运行只读审查。先运行 Ponytail 审查(加载 ponytail-review,检查不必要的复杂度,仅在 Lean already. Ship. 时通过),再运行正确性审查(加载 code-review,使用其独立的 Standards 与 Spec 子智能体分别返回两个轴的结果)。任一审查报告问题时,生成全新修复子智能体,仅修复所报告问题,单独提交并返回证据。任何后续工作项改动都会使两项审查结果失效,需重新从 Ponytail 审查开始。

  4. 推送并创建草稿 PR:审查门通过后,在最终 HEAD 运行完整验证、核对提交格式与归属、确认审查门仍通过,然后推送工作分支并通过仓库宿主原生机制创建以 <base-branch> 为目标的草稿 PR。PR 标题使用提交主题格式,正文仅限 1–3 句简短摘要。已跟踪工单在草稿 PR 创建成功后保持 <executor> 分配并转换到 <review-handoff-state>。PR 保持草稿,不合并。

  5. 完成:仅当每个需求都有证据、最终 HEAD 通过完整验证、工作树已核对、审查门在最终 HEAD 通过、所有工作项提交已推送、草稿 PR 已针对 <base-branch> 打开,且已跟踪工单仍分配给 <executor> 并处于 <review-handoff-state> 时,才声明完成。报告工作项、分支、提交范围、验证结果、两项审查结果和草稿 PR 链接。

适用场景

适用于需要把单个工单或明确需求以受控、可审查方式落地的 AI 编程工作流,尤其是希望将实现与审查分离、并强制完整验证门禁的团队。

限制

必须已安装 ponytail、ponytail-review、code-review 三个技能,否则停止。已跟踪工单模式需要可用的跟踪器、认证身份与原生生命周期;纯提示模式则不需要工单、跟踪器配置或跟踪器操作。工单含糊、检索失败、被阻塞或需求不足时会停止。该技能只创建草稿 PR,不合并。