Analyze Issue

NeoLabHQ/context-engineering-kit/antigravity/skills/analyze-issue

作者 NeoLabHQ23e2428e809d77717f8acc9659c374a3a1fcb93e無授權條款收錄於 2026年10月9日更新於 2026年10月9日

Analyze a GitHub issue and create a detailed technical specification

AI 產生的概覽

分析 GitHub issue 並產出已儲存的技術規格,包含方案、計畫與測試。

功能
接收 GitHub issue 編號,載入或取得 issue 詳細內容,並檢視相關程式碼與專案結構。接著撰寫技術規格,涵蓋 issue 摘要、問題陳述、技術方案、實作計畫、測試計畫、需修改與新增的檔案、可沿用的現有工具、成功標準以及不在範圍內的項目。規格會以編號加短橫線命名的檔名儲存到 ./specs/issues/,並向使用者回報簡短摘要。
適用情境
適用於在實作前需要把 GitHub issue 轉成可執行技術規格的情境。適合希望從 issue 取得包含測試涵蓋範圍與檔案層級變更的結構化計畫的團隊。也適用於需要先從 GitHub 載入或取得 issue 詳細內容的情況。
執行需求
需要存取 GitHub issue 資料,可來自 ./specs/issues/ 下的本機檔案,或依 .claude/commands/load-issues.md 從 GitHub 取得。需要讀取專案程式碼與結構,並具備 ./specs/issues/ 的寫入權限。不附帶指令碼,僅為指示。

Please analyze GitHub issue #$ARGUMENTS and create a technical specification.

Follow these steps:

  1. Check if the issue is already loaded:

    • Look for the issue file in ./specs/issues/ folder
    • File naming pattern: <number-padded-to-3-digits>-<kebab-case-title>.md
    • If not found, fetch the issue details from GitHub (see step 2)
  2. Fetch the issue details (if not already loaded):

    • Read .claude/commands/load-issues.md to understand how to fetch issue details
    • Save the issue file following the load-issues.md format
  3. Understand the requirements thoroughly

  4. Review related code and project structure

  5. Create a technical specification with the format below

Technical Specification for Issue #$ARGUMENTS

Issue Summary

  • Title: [Issue title from GitHub]
  • Description: [Brief description from issue]
  • Labels: [Labels from issue]
  • Priority: [High/Medium/Low based on issue content]

Problem Statement

[1-2 paragraphs explaining the problem]

Technical Approach

[Detailed technical approach]

Implementation Plan

  1. [Step 1]
  2. [Step 2]
  3. [Step 3]

Test Plan

  1. Unit Tests:
    • [test scenario]
  2. Component Tests:
    • [test scenario]
  3. Integration Tests:
    • [test scenario]

Files to Modify

Files to Create

Existing Utilities to Leverage

Success Criteria

  • [criterion 1]
  • [criterion 2]

Out of Scope

  • [item 1]
  • [item 2]

Remember to follow our strict TDD principles, KISS approach, and 300-line file limit.

IMPORTANT: After completing your analysis, SAVE the full technical specification to: ./specs/issues/<number-padded-to-3-digits>-<kebab-case-title>.specs.md

For example, for issue #7 with title "Make code review trigger on any *.SQL and .sh file changes", save to: ./specs/issues/007-make-code-review-trigger-on-sql-sh-changes.specs.md

After saving, provide a brief summary to the user confirming:

  • Issue number and title analyzed
  • File path where the specification was saved
  • Key highlights from the specification (2-3 bullet points)

來源與署名

來源:NeoLabHQ/context-engineering-kit位於antigravity/skills/analyze-issue提交23e2428

授權條款: 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架