@k2works/claude-code-booster 0.8.0 → 0.9.0

package/lib/assets/.claude/commands/pr-auto-update.md

@@ -1,460 +0,0 @@
-## PR Auto Update
-
-## 概要
-
-Pull Request の説明とラベルを自動的に更新するコマンドです。Git の変更内容を分析して、適切な説明文とラベルを生成・設定します。
-
-## 使い方
-
-```bash
-/pr-auto-update [オプション] [PR 番号]
-```
-
-### オプション
-
-- `--pr <番号>` : 対象の PR 番号を指定（省略時は現在のブランチから自動検出）
-- `--description-only` : 説明文のみ更新（ラベルは変更しない）
-- `--labels-only` : ラベルのみ更新（説明文は変更しない）
-- `--dry-run` : 実際の更新は行わず、生成される内容のみ表示
-- `--lang <言語>` : 言語を指定（ja, en）
-
-### 基本例
-
-```bash
-# 現在のブランチの PR を自動更新
-/pr-auto-update
-
-# 特定の PR を更新
-/pr-auto-update --pr 1234
-
-# 説明文のみ更新
-/pr-auto-update --description-only
-
-# ドライランで確認
-/pr-auto-update --dry-run
-```
-
-## 機能詳細
-
-### 1. PR の自動検出
-
-現在のブランチから対応する PR を自動検出：
-
-```bash
-# ブランチから PR を検索
-gh pr list --head $(git branch --show-current) --json number,title,url
-```
-
-### 2. 変更内容の分析
-
-以下の情報を収集・分析：
-
-- **ファイル変更**: 追加・削除・変更されたファイル
-- **コード分析**: import 文、関数定義、クラス定義の変更
-- **テスト**: テストファイルの有無と内容
-- **ドキュメント**: README、docs の更新
-- **設定**: package.json、pubspec.yaml、設定ファイルの変更
-- **CI/CD**: GitHub Actions、workflow の変更
-
-### 3. 説明文の自動生成
-
-#### テンプレート処理の優先順位
-
-1. **既存の PR 説明**: 既に記述されている内容を**完全に踏襲**
-2. **プロジェクトテンプレート**: `.github/PULL_REQUEST_TEMPLATE.md` から構造を取得
-3. **デフォルトテンプレート**: 上記が存在しない場合のフォールバック
-
-#### 既存内容の保持ルール
-
-**重要**: 既存の内容は変更しない
-
-- 書かれているセクションは保持
-- 空のセクションのみ補完
-- 機能的なコメント（Copilot review rule など）は保持
-
-#### プロジェクトテンプレートの使用
-
-```bash
-# .github/PULL_REQUEST_TEMPLATE.md の構造を解析
-parse_template_structure() {
-  local template_file="$1"
-  
-  if [ -f "$template_file" ]; then
-    # セクション構造を抽出
-    grep -E '^##|^###' "$template_file"
-    
-    # コメントプレースホルダーを特定
-    grep -E '<!--.*-->' "$template_file"
-    
-    # 既存のテンプレート構造を完全に踏襲
-    cat "$template_file"
-  fi
-}
-```
-
-### 4. ラベルの自動設定
-
-#### ラベル取得の仕組み
-
-**優先順位**:
-
-1. **`.github/labels.yml`**: プロジェクト固有のラベル定義から取得
-2. **GitHub API**: `gh api repos/{OWNER}/{REPO}/labels --jq '.[].name'` で既存ラベルを取得
-
-#### 自動判定ルール
-
-**ファイルパターンベース**:
-
-- ドキュメント: `*.md`, `README`, `docs/` → `documentation|docs|doc` を含むラベル
-- テスト: `test`, `spec` → `test|testing` を含むラベル  
-- CI/CD: `.github/`, `*.yml`, `Dockerfile` → `ci|build|infra|ops` を含むラベル
-- 依存関係: `package.json`, `pubspec.yaml`, `requirements.txt` → `dependencies|deps` を含むラベル
-
-**変更内容ベース**:
-
-- バグ修正: `fix|bug|error|crash|修正` → `bug|fix` を含むラベル
-- 新機能: `feat|feature|add|implement|新機能|実装` → `feature|enhancement|feat` を含むラベル
-- リファクタリング: `refactor|clean|リファクタ` → `refactor|cleanup|clean` を含むラベル
-- パフォーマンス: `performance|perf|optimize|パフォーマンス` → `performance|perf` を含むラベル
-- セキュリティ: `security|secure|セキュリティ` → `security` を含むラベル
-
-#### 制約
-
-- **最大 3 個まで**: 自動選択されるラベル数の上限
-- **既存ラベルのみ**: 新しいラベルの作成は禁止
-- **部分マッチ**: ラベル名にキーワードが含まれているかで判定
-
-#### 実際の使用例
-
-**`.github/labels.yml` が存在する場合**:
-
-```bash
-# ラベル定義から自動取得
-grep "^- name:" .github/labels.yml | sed "s/^- name: '\?\([^']*\)'\?/\1/"
-
-# 例: プロジェクト固有のラベル体系を使用
-```
-
-**GitHub API から取得する場合**:
-
-```bash
-# 既存ラベルの一覧取得
-gh api repos/{OWNER}/{REPO}/labels --jq '.[].name'
-
-# 例: bug, enhancement, documentation などの標準的なラベルを使用
-```
-
-### 5. 実行フロー
-
-```bash
-#!/bin/bash
-
-# 1. PR の検出・取得
-detect_pr() {
-  if [ -n "$PR_NUMBER" ]; then
-    echo $PR_NUMBER
-  else
-    gh pr list --head $(git branch --show-current) --json number --jq '.[0].number'
-  fi
-}
-
-# 2. 変更内容の分析
-analyze_changes() {
-  local pr_number=$1
-  
-  # ファイル変更の取得
-  gh pr diff $pr_number --name-only
-  
-  # 内容分析
-  gh pr diff $pr_number | head -1000
-}
-
-# 3. 説明文の生成
-generate_description() {
-  local pr_number=$1
-  local changes=$2
-  
-  # 現在の PR 説明を取得
-  local current_body=$(gh pr view $pr_number --json body --jq -r .body)
-  
-  # 既存内容があればそのまま使用
-  if [ -n "$current_body" ]; then
-    echo "$current_body"
-  else
-    # テンプレートから新規生成
-    local template_file=".github/PULL_REQUEST_TEMPLATE.md"
-    if [ -f "$template_file" ]; then
-      generate_from_template "$(cat "$template_file")" "$changes"
-    else
-      generate_from_template "" "$changes"
-    fi
-  fi
-}
-
-# テンプレートからの生成
-generate_from_template() {
-  local template="$1"
-  local changes="$2"
-  
-  if [ -n "$template" ]; then
-    # テンプレートをそのまま使用（HTML コメント保持）
-    echo "$template"
-  else
-    # デフォルトフォーマットで生成
-    echo "## What does this change?"
-    echo ""
-    echo "$changes"
-  fi
-}
-
-# 4. ラベルの決定
-determine_labels() {
-  local changes=$1
-  local file_list=$2
-  local pr_number=$3
-  
-  # 利用可能なラベルを取得
-  local available_labels=()
-  if [ -f ".github/labels.yml" ]; then
-    # labels.yml からラベル名を抽出
-    available_labels=($(grep "^- name:" .github/labels.yml | sed "s/^- name: '\?\([^']*\)'\?/\1/"))
-  else
-    # GitHub API からラベルを取得
-    local repo_info=$(gh repo view --json owner,name)
-    local owner=$(echo "$repo_info" | jq -r .owner.login)
-    local repo=$(echo "$repo_info" | jq -r .name)
-    available_labels=($(gh api "repos/$owner/$repo/labels" --jq '.[].name'))
-  fi
-  
-  local suggested_labels=()
-  
-  # 汎用的なパターンマッチング
-  analyze_change_patterns "$file_list" "$changes" available_labels suggested_labels
-  
-  # 最大 3 個に制限
-  echo "${suggested_labels[@]:0:3}"
-}
-
-# 変更パターンからラベルを決定
-analyze_change_patterns() {
-  local file_list="$1"
-  local changes="$2"
-  local -n available_ref=$3
-  local -n suggested_ref=$4
-  
-  # ファイルタイプによる判定
-  if echo "$file_list" | grep -q "\.md$\|README\|docs/"; then
-    add_matching_label "documentation\|docs\|doc" available_ref suggested_ref
-  fi
-  
-  if echo "$file_list" | grep -q "test\|spec"; then
-    add_matching_label "test\|testing" available_ref suggested_ref
-  fi
-  
-  # 変更内容による判定
-  if echo "$changes" | grep -iq "fix\|bug\|error\|crash\|修正"; then
-    add_matching_label "bug\|fix" available_ref suggested_ref
-  fi
-  
-  if echo "$changes" | grep -iq "feat\|feature\|add\|implement\|新機能\|実装"; then
-    add_matching_label "feature\|enhancement\|feat" available_ref suggested_ref
-  fi
-}
-
-# マッチするラベルを追加
-add_matching_label() {
-  local pattern="$1"
-  local -n available_ref=$2
-  local -n suggested_ref=$3
-  
-  # すでに 3 個ある場合はスキップ
-  if [ ${#suggested_ref[@]} -ge 3 ]; then
-    return
-  fi
-  
-  # パターンにマッチする最初のラベルを追加
-  for available_label in "${available_ref[@]}"; do
-    if echo "$available_label" | grep -iq "$pattern"; then
-      # 重複チェック
-      local already_exists=false
-      for existing in "${suggested_ref[@]}"; do
-        if [ "$existing" = "$available_label" ]; then
-          already_exists=true
-          break
-        fi
-      done
-      
-      if [ "$already_exists" = false ]; then
-        suggested_ref+=("$available_label")
-        return
-      fi
-    fi
-  done
-}
-
-# 旧関数の互換性のため残しておく
-find_and_add_label() {
-  add_matching_label "$@"
-}
-
-# 5. PR の更新
-update_pr() {
-  local pr_number=$1
-  local description="$2"
-  local labels="$3"
-  
-  if [ "$DRY_RUN" = "true" ]; then
-    echo "=== DRY RUN ==="
-    echo "Description:"
-    echo "$description"
-    echo "Labels: $labels"
-  else
-    # リポジトリ情報を取得
-    local repo_info=$(gh repo view --json owner,name)
-    local owner=$(echo "$repo_info" | jq -r .owner.login)
-    local repo=$(echo "$repo_info" | jq -r .name)
-    
-    # GitHub API を使用して本文を更新（HTML コメント保持）
-    # JSON エスケープを適切に処理
-    local escaped_body=$(echo "$description" | jq -R -s .)
-    gh api \
-      --method PATCH \
-      "/repos/$owner/$repo/pulls/$pr_number" \
-      --field body="$description"
-    
-    # ラベルは通常の gh コマンドで問題なし
-    if [ -n "$labels" ]; then
-      gh pr edit $pr_number --add-label "$labels"
-    fi
-  fi
-}
-```
-
-## 設定ファイル（今後の拡張用）
-
-`~/.claude/pr-auto-update.config`:
-
-```json
-{
-  "language": "ja",
-  "max_labels": 3
-}
-```
-
-## よくあるパターン
-
-### Flutter プロジェクト
-
-```markdown
-## What does this change?
-
-{機能名}を実装しました。ユーザーの{課題}を解決します。
-
-### 主な変更内容
-
-- **UI 実装**: {画面名}を新規作成
-- **状態管理**: Riverpod プロバイダーを追加
-- **API 統合**: GraphQL クエリ・ミューテーションを実装
-- **テスト**: ウィジェットテスト・ユニットテストを追加
-
-### 技術仕様
-
-- **アーキテクチャ**: {使用パターン}
-- **依存関係**: {新規追加したパッケージ}
-- **パフォーマンス**: {最適化内容}
-```
-
-### Node.js プロジェクト
-
-```markdown
-## What does this change?
-
-{API 名}エンドポイントを実装しました。{ユースケース}に対応します。
-
-### 主な変更内容
-
-- **API 実装**: {エンドポイント}を新規作成
-- **バリデーション**: リクエスト検証ロジックを追加
-- **データベース**: {テーブル名}への操作を実装
-- **テスト**: 統合テスト・ユニットテストを追加
-
-### セキュリティ
-
-- **認証**: JWT トークン検証
-- **認可**: ロールベースアクセス制御
-- **入力検証**: SQL インジェクション対策
-```
-
-### CI/CD 改善
-
-```markdown
-## What does this change?
-
-GitHub Actions ワークフローを改善しました。{効果}を実現します。
-
-### 改善内容
-
-- **パフォーマンス**: ビルド時間を{時間}短縮
-- **信頼性**: エラーハンドリングを強化
-- **セキュリティ**: シークレット管理を改善
-
-### 技術詳細
-
-- **並列化**: {ジョブ名}を並列実行
-- **キャッシュ**: {キャッシュ対象}のキャッシュ戦略を最適化
-- **モニタリング**: {メトリクス}の監視を追加
-```
-
-## 注意事項
-
-1. **既存内容の完全保持**:
-   - 既に記述されている内容は**一文字も変更しない**
-   - 空のコメント部分とプレースホルダーのみ補完
-   - ユーザーが意図的に書いた内容を尊重
-
-2. **テンプレート優先順位**:
-   - 既存の PR 説明 > `.github/PULL_REQUEST_TEMPLATE.md` > デフォルト
-   - プロジェクト固有のテンプレート構造を完全踏襲
-
-3. **ラベル制約**:
-   - `.github/labels.yml` が存在すれば優先使用
-   - 存在しない場合は GitHub API から既存ラベルを取得
-   - 新しいラベルの作成は禁止
-   - 最大 3 個まで自動選択
-
-4. **安全な更新**:
-   - `--dry-run` で事前確認を推奨
-   - 機密情報を含む変更の場合は警告表示
-   - バックアップとして元の説明を保存
-
-5. **一貫性の維持**:
-   - プロジェクトの既存 PR スタイルに合わせる
-   - 言語（日本語/英語）の統一
-   - ラベリング規則の継承
-
-## トラブルシューティング
-
-### よくある問題
-
-1. **PR が見つからない**: ブランチ名と PR の関連付けを確認
-2. **権限エラー**: GitHub CLI の認証状態を確認
-3. **ラベルが設定できない**: リポジトリの権限を確認
-4. **HTML コメントがエスケープされる**: GitHub CLI の仕様により `<!-- -->` が `&lt;!-- --&gt;` に変換される
-
-### GitHub CLI の HTML コメントエスケープ問題
-
-**重要**: GitHub CLI (`gh pr edit`) は HTML コメントを自動エスケープします。また、シェルのリダイレクト処理で `EOF < /dev/null` などの不正な文字列が混入する場合があります。
-
-#### 根本的解決策
-
-1. **GitHub API の --field オプション使用**: `--field` を使用して適切なエスケープ処理
-2. **シェル処理の簡素化**: 複雑なリダイレクトやパイプ処理を避ける
-3. **テンプレート処理の単純化**: HTML コメント除去処理を廃止し、完全保持
-4. **JSON エスケープの適切な処理**: 特殊文字を正しく処理
-
-### デバッグオプション
-
-```bash
-# 詳細ログ出力（実装時に追加）
-/pr-auto-update --verbose
-```

package/lib/assets/.claude/commands/pr-create.md

@@ -1,249 +0,0 @@
-## PR Create
-
-Git 変更分析に基づく自動 PR 作成で効率的な Pull Request ワークフローを実現します。
-
-### 使い方
-
-```bash
-# 変更分析による自動 PR 作成
-git add . && git commit -m "feat: ユーザー認証機能の実装"
-「変更内容を分析して適切な説明文とラベルで Draft PR を作成してください」
-
-# 既存テンプレート保持での更新
-cp .github/PULL_REQUEST_TEMPLATE.md pr_body.md
-「テンプレート構造を完全に保持して変更内容を補完してください」
-
-# 段階的品質向上
-gh pr ready
-「品質確認完了後、Ready for Review に変更してください」
-```
-
-### 基本例
-
-```bash
-# 1. ブランチ作成とコミット
-git checkout main && git pull
-git checkout -b feat-user-profile
-git add . && git commit -m "feat: ユーザー プロフィール機能の実装"
-git push -u origin feat-user-profile
-
-# 2. PR 作成
-「以下の手順で PR を作成してください：
-1. git diff --cached で変更内容を確認
-2. .github/PULL_REQUEST_TEMPLATE.md を使用して説明文を作成
-3. 変更内容から適切なラベルを最大 3 個選択
-4. Draft PR として作成（HTML コメント保持）」
-
-# 3. CI 確認後に Ready 化
-「CI が通ったら PR を Ready for Review に変更してください」
-```
-
-### 実行手順
-
-#### 1. ブランチ作成
-
-```bash
-# ガイドラインに従った命名規則: {type}-{subject}
-git checkout main
-git pull
-git checkout -b feat-user-authentication
-
-# ブランチ確認（現在のブランチ名を表示）
-git branch --show-current
-```
-
-#### 2. コミット
-
-```bash
-# 変更をステージング
-git add .
-
-# ガイドラインに従ったコミットメッセージ
-git commit -m "feat: ユーザー認証 API の実装"
-```
-
-#### 3. リモートに Push
-
-```bash
-# 初回 Push（upstream 設定）
-git push -u origin feat-user-authentication
-
-# 2 回目以降
-git push
-```
-
-#### 4. 自動分析による Draft PR 作成
-
-**Step 1: 変更内容の分析**
-
-```bash
-# ファイル変更の取得（ステージ済み変更を確認）
-git diff --cached --name-only
-
-# 内容分析（最大 1000 行）
-git diff --cached | head -1000
-```
-
-**Step 2: 説明文の自動生成**
-
-```bash
-# テンプレート処理の優先順位
-# 1. 既存 PR 説明（完全保持）
-# 2. .github/PULL_REQUEST_TEMPLATE.md
-# 3. デフォルトテンプレート
-
-cp .github/PULL_REQUEST_TEMPLATE.md pr_body.md
-# HTML コメント・区切り線を保持したまま空セクションのみ補完
-```
-
-**Step 3: ラベルの自動選択**
-
-```bash
-# 利用可能ラベルの取得（非インタラクティブ）
-「.github/labels.yml または GitHub リポジトリから利用可能なラベルを取得して、変更内容に基づいて適切なラベルを自動選択してください」
-
-# パターンマッチングによる自動選択（最大 3 個）
-# - ドキュメント: *.md, docs/ → documentation|docs
-# - テスト: test, spec → test|testing
-# - バグ修正: fix|bug → bug|fix
-# - 新機能: feat|feature → feature|enhancement
-```
-
-**Step 4: GitHub API での PR 作成（HTML コメント保持）**
-
-```bash
-# PR 作成
-「以下の情報で Draft PR を作成してください：
-- タイトル: コミットメッセージから自動生成
-- 説明文: .github/PULL_REQUEST_TEMPLATE.md を使用して適切に記入
-- ラベル: 変更内容から自動選択（最大 3 個）
-- ベースブランチ: main
-- HTML コメントは完全に保持」
-```
-
-**方法 B: GitHub MCP（フォールバック）**
-
-```javascript
-// HTML コメント保持での PR 作成
-mcp_github_create_pull_request({
-  owner: 'organization',
-  repo: 'repository',
-  base: 'main',
-  head: 'feat-user-authentication',
-  title: 'feat: ユーザー認証の実装',
-  body: prBodyContent, // HTML コメントを含む完全な内容
-  draft: true,
-  maintainer_can_modify: true,
-});
-```
-
-### 自動ラベル選択システム
-
-#### ファイルパターンベース判定
-
-- **ドキュメント**: `*.md`, `README`, `docs/` → `documentation|docs|doc`
-- **テスト**: `test`, `spec` → `test|testing`
-- **CI/CD**: `.github/`, `*.yml`, `Dockerfile` → `ci|build|infra|ops`
-- **依存関係**: `package.json`, `pubspec.yaml` → `dependencies|deps`
-
-#### 変更内容ベース判定
-
-- **バグ修正**: `fix|bug|error|crash|修正` → `bug|fix`
-- **新機能**: `feat|feature|add|implement|新機能|実装` → `feature|enhancement|feat`
-- **リファクタリング**: `refactor|clean|リファクタ` → `refactor|cleanup|clean`
-- **パフォーマンス**: `performance|perf|optimize` → `performance|perf`
-- **セキュリティ**: `security|secure` → `security`
-
-#### 制約事項
-
-- **最大 3 個まで**: 自動選択の上限
-- **既存ラベルのみ**: 新規作成禁止
-- **部分マッチ**: キーワード含有による判定
-
-### プロジェクトガイドライン
-
-#### 基本姿勢
-
-1. **必ず Draft で開始**: すべての PR は Draft 状態で作成
-2. **段階的品質向上**: Phase 1（基本実装）→ Phase 2（テスト追加）→ Phase 3（ドキュメント更新）
-3. **適切なラベル**: 最大 3 種類のラベルを必ず付与
-4. **テンプレート使用**: `.github/PULL_REQUEST_TEMPLATE.md` を必ず使用
-5. **日本語スペース**: 日本語と半角英数字間に必ず半角スペース
-
-#### ブランチ命名規則
-
-```text
-{type}-{subject}
-
-例:
-- feat-user-profile
-- fix-login-error
-- refactor-api-client
-```
-
-#### コミットメッセージ
-
-```text
-{type}: {description}
-
-例:
-- feat: ユーザー認証 API の実装
-- fix: ログイン エラーの修正
-- docs: README の更新
-```
-
-### テンプレート処理システム
-
-#### 処理優先順位
-
-1. **既存 PR 説明**: 既に記述されている内容を**完全に踏襲**
-2. **プロジェクトテンプレート**: `.github/PULL_REQUEST_TEMPLATE.md` 構造を維持
-3. **デフォルトテンプレート**: 上記が存在しない場合
-
-#### 既存内容保持ルール
-
-- **一文字も変更しない**: 既に記述されている内容
-- **空セクションのみ補完**: プレースホルダー部分を変更内容で埋める
-- **機能的コメント保持**: `<!-- Copilot review rule -->` などを維持
-- **HTML コメント保持**: `<!-- ... -->` を完全に保持
-- **区切り線保持**: `---` などの構造を維持
-
-#### HTML コメント保持の対処法
-
-**重要**: GitHub CLI (`gh pr edit`) は HTML コメントを自動エスケープし、シェル処理で `EOF < /dev/null` などの不正な文字列が混入する場合があります。
-
-**根本的解決策**:
-
-1. **GitHub API の --field オプション使用**: 適切なエスケープ処理で HTML コメント保持
-2. **テンプレート処理の簡素化**: 複雑なパイプ処理やリダイレクトを避ける
-3. **完全保持アプローチ**: HTML コメント削除処理を廃止し、テンプレートを完全保持
-
-### レビューコメント対応
-
-```bash
-# 変更後の再コミット
-git add .
-git commit -m "fix: レビュー フィードバックに基づく修正"
-git push
-```
-
-### 注意事項
-
-#### HTML コメント保持の重要性
-
-- **GitHub CLI 制限**: `gh pr edit` は HTML コメントをエスケープ、不正文字列混入
-- **根本的回避策**: GitHub API の `--field` オプションで適切なエスケープ処理
-- **テンプレート完全保持**: HTML コメント削除処理を廃止し、構造を完全維持
-
-#### 自動化の制約
-
-- **新規ラベル禁止**: `.github/labels.yml` 定義外のラベル作成不可
-- **最大 3 ラベル**: 自動選択の上限
-- **既存内容優先**: 手動で記述された内容は一切変更しない
-
-#### 段階的品質向上
-
-- **Draft 必須**: すべての PR は Draft で開始
-- **CI 確認**: `gh pr checks` で状態確認
-- **Ready 移行**: 品質確認完了後に `gh pr ready`
-- **テンプレート完全遵守**: プロジェクト固有の構造を維持