create-github-issues-for-unmet-specification-requirements 是做什么的?
根据规范文件,为未实现的需求创建 GitHub Issue,并使用 feature_request.yml 模板。
此技能会自动解析规范文件(如 .md、.yaml 或 .json),将其中的每个独立需求与当前代码或项目状态进行对比。对于标记为“未实现”或“待办”的需求,它会为每一个需求在指定的 GitHub 仓库中创建一个新的 Issue。Issue 的标题和内容遵循仓库中定义的 feature_request.yml 模板,确保格式统一。
使用此技能可以自动将规范中的未完成工作项转换为可追踪的任务,适合用于敏捷开发、文档驱动开发或符合性检查的场景。它依赖于 GitHub API 和本地文件系统,无需额外环境变量配置即可运行。
使用方法
- 确保当前工作目录是包含规范文件的仓库。
- 运行技能命令以扫描规范文件并创建 Issue。
# 示例命令
create-issues --spec-file requirements.md --repo owner/repo
支持的文件格式
- Markdown(
.md):使用标题层级或列表表示需求。 - YAML(
.yaml/.yml):使用结构化字段表示需求。 - JSON(
.json):使用数组或对象表示需求。
每个需求必须包含唯一标识符(如 # 或 id 字段)以及状态(如 status: unimplemented)。
模板配置
确保仓库的 .github/ISSUE_TEMPLATE/feature_request.yml 存在,且包含 name、description 和 title 字段。技能会自动匹配该模板生成 Issue。
限制
- 只能处理当前已检出分支中的规范文件。
- 需要有效的 GitHub 认证(如 GitHub CLI 已登录)。
- 不会自动删除已关闭的 Issue。
贡献
欢迎提交 Pull Request 或 Issue 以改进此技能。