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/ 目錄下的相關規範檔案，以評估實現狀態。

我需要提供規範檔案嗎？

是的。該技能作用於您指定的規範檔案，在檢查實現狀態之前，會從中提取所有需求。