mcpField
S
spec-it

spec-it

github.com/goncalvesjoao开发014 次安装2 周前更新
代码仓库

关于 spec-it

此技能调用 Matt Pocock 的 `to-spec` 技能，将规格发布为 GitHub issue，再补齐并验证所需标签。适用于需要发布规格并保留 issue 现有分诊状态的仓库工作流。

主要功能

  1. 01调用 `to-spec` 技能
  2. 02将规格发布为 GitHub issue
  3. 03仅添加缺失标签
  4. 04保留现有分诊标签
  5. 05验证 issue 标签与链接

适用场景

  1. 01向 GitHub 发布规格
  2. 02为已发布 issue 添加 `spec`
  3. 03缺少状态标签时添加 `status/todo`
  4. 04恢复标签操作且不重复创建 issue

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/goncalvesjoao/ship-it --skill spec-it

安装后在 Claude Code 中输入/spec-it确认已加载。

附带文件agents/openai.yaml

详细介绍

编写规格说明

用户问题

在提出或转述任何用户问题之前，请阅读并遵循用户问题规则。

需要 Matt Pocock 的 to-spec skill、其前置条件，以及已通过身份验证的 GitHub CLI (gh)。

  1. 定位并阅读已安装的 to-spec skill。可用时使用 Skill 工具调用；否则遵循其 SKILL.md。保留其探索、测试接缝确认、规格说明模板和分类标签，并将 GitHub 设为发布目标。如果缺少前置条件或目标仓库不明确，请在发布前报告阻碍。

  2. 保留已发布 issue 的 URL，并确定其仓库和 issue 编号。只有在 to-spec 已发布 GitHub issue 后才继续。在恢复添加标签的操作时，复用该 issue，而不是另行发布规格说明。

  3. 读取 issue 当前的标签：

    gh issue view <issue-number> --repo <owner/repo> --json url,labels

    仅当缺少 spec 时才添加。仅当当前标签中没有任何以 status/ 开头的标签时，才添加 status/todo。保留所有现有标签，包括已有的状态标签和上游分类标签。

  4. 对于每个需要添加的标签，检查仓库中是否已存在。使用 gh label create <label> --repo <owner/repo> 创建缺少的仓库标签，并保留现有标签设置。使用 gh issue edit <issue-number> --repo <owner/repo> --add-label <label> 仅添加缺少的 issue 标签。显式指定仓库参数，并安全地引用值。

  5. 再次获取 issue 标签。确认 spec 已存在，且至少有一个标签以 status/ 开头。仅在验证成功后返回 issue URL 和最终标签。

如果添加标签或验证失败，请报告 issue URL 和未完成的操作。重试前检查当前标签，确保恢复操作会更新现有 issue，而不替换其状态或创建重复项。

评论

支持 Markdown