关于 plan-it
plan-it 是面向团队的工作流编排技能,可将仓库工作转为已发布的规格说明和获批工单。它协调 spec-it 与 ticket-it,并在阶段间设置验证和用户审批。
主要功能
- 01协调 spec-it 与 ticket-it
- 02检查仓库和跟踪器配置
- 03验证已发布的规格说明议题
- 04要求审批工单拆分方案
- 05支持暂停并等待用户输入
- 06报告阻塞项和议题链接
适用场景
- 01根据仓库上下文拟定规格说明
- 02将已批准的规格说明拆分为工单
- 03收到用户反馈后恢复工单处理
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ goncalvesjoao/ ship-it --skill plan-it安装后在 Claude Code 中输入/plan-it确认已加载。
详细介绍
规划
用户问题
在提出或转述任何用户问题之前,请阅读并遵循用户问题规则。
需要 spec-it、ticket-it、它们的前置条件以及子 Agent 支持。
调用此技能即表示授权通过这些技能发布规格和已批准的工单。请保留其中的用户确认和审批步骤。创建或编辑此技能不会启动发布。
编排
- 阅读仓库说明,并确定仓库的绝对路径、目标 GitHub 仓库、跟踪器配置以及两个本地技能路径。在发布之前,解决缺失的前置条件或目标不明确的问题。
- 在父级聊天中直接阅读并遵循
spec-it及其上游依赖;如有可用的 Skill 工具,请使用它。这样可让to-spec获取当前讨论和对代码库的了解。保留其测试接缝确认步骤,并等待发布成功,同时获取经过验证的问题 URL 和标签。 - 独立获取返回的问题,并验证其目标仓库正确、它是问题而非拉取请求,且带有
spec和一个status/标签。只有在spec-it报告成功且此验证通过后,才能开始下一阶段。 - 为
ticket-it启动一个全新的工作线程,并禁用对话继承;如支持,可使用fork_turns="none"。向其提供绝对技能路径、仓库路径、已验证的父问题 URL、跟踪器配置,以及已发布规格中未包含的任何用户约束或决定。要求其阅读并遵循该技能及其上游依赖,并获取父问题的完整正文和评论。除非用户已批准完全相同的拆分方案,否则在发布前必须先让用户批准提议的拆分方案。按照下文所述处理输入,并等待其报告经验证的完成情况。 - 返回父问题和子问题的 URL,并说明阻碍因素和验证结果。只有在两个阶段都成功且每个已批准的切片都有经过验证的工单时,才能声称已完成。
用户输入
向工单工作线程说明:如果委派的技能需要用户回答或批准,请返回父级并提供问题、相关草案或选项、当前进度以及现有产物的 URL。在父级提供用户答复之前,暂停依赖该答复的工作。
通过用户问题流程在父级聊天中提出问题,并等待用户答复。将实际答复及其适用范围转达给同一工作线程,并使用可用的后续工具恢复其工作。后续如有问题或修订,重复此流程。保留 to-tickets 的拆分方案审查;委派不会免除这一步。用户要求运行 plan-it 并不代表其批准了尚未看到的拆分方案。
恢复
如果需要更换工作线程,请连同已保存的进度和产物指针,一并传递用户已累积的决定、约束和批准,并注明其确切适用范围。不要将对早期草案的批准视为对修订草案的批准。
如果失败、中断或结果无法验证,请将工作流标记为未完成,并报告已完成的阶段、现有问题 URL、未完成的操作以及剩余工作。在用户轮次之间保留工单工作线程标识符和产物指针。尽可能在父级聊天中恢复规格阶段,或在现有工单工作线程中恢复;如果工作线程不可用,请向替代工作线程提供已记录的进度,并让其在继续之前检查 GitHub 状态。根据相关技能复用已发布的问题并修复未完成的操作,不要创建重复项。规格阶段通过验证后,直接针对该父问题恢复工单处理。