GitHub Issue Quality Checker

Overview

GitHubリポジトリのOpen状態のIssueを自動で分析し、品質が低い・内容が曖昧なIssueを検出するスキル。タイトルの曖昧さ、本文の情報不足、環境情報の欠如などを総合評価し、開発者が対応すべき優先度の高いIssueを特定します。

Quick Start

環境設定

# GitHub Personal Access Tokenを設定
export GITHUB_TOKEN="ghp_your_token_here"

# 対象リポジトリを設定
export GITHUB_REPOSITORY="owner/repository-name"

基本実行

# テキスト形式で結果出力（デフォルト）
python scripts/main.py

# JSON形式で結果出力
python scripts/main.py --output-format json

# コマンドライン引数で直接指定
python scripts/main.py --repository owner/repo --output-format text

Core Capabilities

1. Issue品質評価アルゴリズム

評価項目

• タイトル評価（40点満点）：文字数、曖昧さパターン
• 本文評価（60点満点）：文字数、情報量
• 情報量ボーナス：環境情報、再現手順、エラー情報などの有無
• その他：ラベルの有無、コードブロックの有無

スコアリング方式

• 満点100点から減点方式
• 低いスコアほど品質が低い
• 詳細な評価基準は references/quality_criteria.md を参照

2. 出力形式

テキスト形式

• Issue詳細情報
• 品質スコアと評価理由
• タイトル・本文のプレビュー
• 対応すべき理由の明示

JSON形式

• 機械処理可能な構造化データ
• CI/CDパイプラインでの利用に適した形式

3. GitHub API連携

• GitHub REST API v3使用
• 認証済みリクエスト（5,000 req/hour）
• レート制限対応
• エラーハンドリング実装

使用例

基本的な利用シーン

# リポジトリのIssue品質をチェック
python scripts/main.py

CI/CDでの活用

- name: Check Issue Quality
  run: |
    python .claude/skills/github-issue-quality-checker/scripts/main.py --output-format json > quality_report.json
    # レポートを解析してアクション

定期メンテナンス

# 毎週のIssue品質チェック
echo "Weekly Issue Quality Report:"
python scripts/main.py

Resources

scripts/

main.py - メイン実行スクリプト

• GitHub API連携
• Issue品質評価ロジック
• 結果出力とフォーマット
• コマンドライン引数処理

references/

quality_criteria.md - 品質評価基準の詳細

• スコアリングアルゴリズム
• 評価項目と配点
• 具体的な計算例
• 品質判断の目安

github_api_usage.md - GitHub API使用ガイド

• APIエンドポイント詳細
• 認証方法と権限
• レート制限情報
• セキュリティ考慮事項

api_reference.md - クイックリファレンス

• 環境変数一覧
• コマンドライン使用法
• 出力形式仕様

assets/

output_template.md - 結果出力テンプレート

• テキスト形式の出力フォーマット
• Markdownレポートのテンプレート構造

Quality Criteria Reference

詳細な品質評価基準は references/quality_criteria.md を参照してください。

GitHub API Usage

GitHub APIの詳細な使用方法は references/github_api_usage.md を参照してください。

Dependencies: Python 3.7+, requests library