create-github-issues-for-unmet-specification-requirements

关于 create-github-issues-for-unmet-specification-requirements

此技能自动化创建 GitHub 问题，用于处理规范文件中尚未在代码库中实现的需求。它通过系统地将未满足的需求转化为可跟踪、可操作的问题，弥合了书面规范与交付代码之间的差距，从而降低了文档化需求被无声忽略的可能性。

工作流程紧凑：分析规范文件以提取所有需求，检查代码库以确定每个需求的实现状态，通过 search_issues 搜索现有问题以避免重复，并通过 create_issue 使用仓库的 feature_request.yml 模板为每个未实现的需求创建一个新问题（若该模板不存在则回退到默认模板）。每个问题预计都包含清晰的需求 ID 和描述映射、实施指南以及验收标准，并根据需要添加 feature 或 enhancement 等标签。实现状态检查包括在代码库中搜索相关模式、检查 /spec/ 目录下的相关规范文件，以及验证需求是否已部分实现。

该技能面向从规范文档工作并希望使问题跟踪器与未满足的需求保持同步的开发者、技术负责人和项目维护者。典型用例包括从新规范启动积压工作列表、将规范与现有代码库进行核对，以及确保每个需求都有可追溯的问题。这是一个轻量级的“读取并创建”工作流：它读取规范和代码，并通过标准工具写入 GitHub 问题，不涉及破坏性操作、凭据处理或代码执行，因此风险较低。

常见问题解答

此技能生成什么？

针对规范中发现的每个未实现的需求生成一个 GitHub 问题，每个问题均包含需求 ID 和描述、实施指南、验收标准以及适当的标签（如 feature 或 enhancement）。

它是如何避免创建重复问题的？

在创建问题之前，它会搜索现有问题（使用 search_issues），并验证每个需求在代码库中是否尚未实现或部分实现。

它使用什么问题模板？

它使用仓库的 feature_request.yml 模板，如果该模板不可用，则回退到默认模板。

它是如何确定需求是否已实现的？

它在代码库中搜索相关代码模式，并检查 /spec/ 目录下的相关规范文件，以评估实现状态。

我需要提供规范文件吗？

是的。该技能作用于您指定的规范文件，在检查实现状态之前，会从中提取所有需求。