SuperAPI AI 工具集

spec-to-issue

设计与创作

查看项目

更新于 10-15 16:51

技能介绍

用途:将规格目录中的文档自动转成结构化的 GitHub Feature Issue,减少人工整理。

主要能力:定位 .specs/{feature}/ 规格目录(无参数时列出并让用户选择);校验文件(requirement.md 必需,design.md、tasks.md 建议提供);从规格中提取标题、问题与完成状态、当前与预期行为、包含与排除范围、验收标准、受约束的决策与开放问题;先检查仓库 Issue 表单、模板、贡献规则和必填字段,优先套用项目模板;通过 gh issue create 创建 Issue。语言规则:自动检测输入语言并以同语言输出,英文对应 references/issue-template.md,日文对应 references/issue-template.ja.md,显式指定优先。

使用方式:/spec-to-issue auth-feature 指定规格;/spec-to-issue 自动检测选择;--preview 先显示正文确认;--label、--project、--branch、--assignee 分别设置标签、GitHub Project、规格链接基分支和指派者。默认值优先级为命令行参数 > .specs/.config.yml > CLAUDE.md > 内置默认。可与 spec-generator 衔接,在其完成全部阶段后询问是否转成 Issue。

限制:requirement.md 缺失则报错;若缺少具体范围与验收标准则停止,不编造通用完成标准;.specs/ 不存在报错;gh CLI 未认证时引导 gh auth login。收费标准、定价、平台范围等暂未提供。