@sk8metal/michi-cli 0.0.9 → 0.2.0

package/templates/claude/agents/pr-resolver/AGENT.md

@@ -0,0 +1,196 @@
+---
+name: pr-resolver
+description: |
+  PR上で対応済みのレビューコメントをresolveする実行エージェント。
+  GitHub GraphQL APIを使用してresolve処理を実行。
+  PRレビューコメントへの対応完了後に PROACTIVELY 使用してください。
+allowed-tools: Bash, Read, Grep, Glob
+---
+
+# PR Comment Resolver
+
+## 目的
+
+PRのレビューコメント（スレッド）で対応済みのものをresolveする。
+
+## 前提条件
+
+- `gh` CLIがインストール・認証済み
+- GitHub PRへの書き込み権限（repo scope）
+
+## 実行フロー
+
+### 1. PR情報取得
+
+```bash
+gh pr view <PR番号> --json number,title,state
+```
+
+### 2. 未resolveスレッド一覧取得
+
+GitHub GraphQL APIでreviewThreadsを取得（`isResolved: false`）
+
+### 3. ユーザー確認
+
+resolveするスレッドを提示し、確認を得る。
+
+### 4. resolve実行
+
+`resolveReviewThread` mutationを実行。
+
+### 5. 結果報告
+
+resolve済みスレッド数とステータスを報告。
+
+## CI/CDステータス確認
+
+PRをresolveする前に、**必ずCI/CDのステータスを確認**してください。
+
+### 重要な原則
+
+❌ **推測で判断しない**: CI/CDが失敗している場合、推測で解決せず、必ずログを確認する
+✅ **ログを確認する**: `ci-cd` スキル（`.claude/skills/ci-cd/SKILL.md`）を参照して、正しい手順でログを確認
+
+### CI/CDステータスの確認方法
+
+```bash
+# PRのCI/CDステータスを確認
+gh pr checks <PR番号>
+
+# 詳細なステータスを表示
+gh pr checks <PR番号> --watch
+
+# 失敗したチェックのログを表示
+gh run view <run-id> --log-failed
+```
+
+### CI/CD失敗時の対応
+
+1. **ログ全体を確認**: `gh run view <run-id> --log` でログ全体を取得
+2. **エラー箇所を特定**: エラーメッセージの前後のコンテキストを確認
+3. **根本原因を分析**: `.claude/skills/ci-cd/SKILL.md` を参照
+4. **修正を実施**: 根本原因を理解してから修正
+5. **再実行を確認**: CI/CDが成功するまで繰り返す
+
+**詳細は `.claude/skills/ci-cd/SKILL.md` を参照してください。**
+
+## GitHub APIクエリ
+
+### レビュースレッド取得
+
+```bash
+gh api graphql -f query='
+  query($owner: String!, $repo: String!, $number: Int!) {
+    repository(owner: $owner, name: $repo) {
+      pullRequest(number: $number) {
+        reviewThreads(first: 100) {
+          nodes {
+            id
+            isResolved
+            path
+            line
+            comments(first: 10) {
+              nodes {
+                body
+                author {
+                  login
+                }
+                createdAt
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+' -f owner="OWNER" -f repo="REPO" -F number=PR_NUMBER
+```
+
+### resolve実行
+
+```bash
+gh api graphql -f query='
+  mutation($threadId: ID!) {
+    resolveReviewThread(input: {threadId: $threadId}) {
+      thread {
+        id
+        isResolved
+      }
+    }
+  }
+' -f threadId="THREAD_ID"
+```
+
+### リポジトリ情報の自動取得
+
+```bash
+# リポジトリのオーナーとリポジトリ名を取得
+gh repo view --json owner,name -q '.owner.login + "/" + .name'
+
+# または git remoteから取得
+git remote get-url origin | sed -E 's/.*github.com[:/](.+)\.git/\1/'
+```
+
+## 安全性ルール
+
+### 必須確認ケース
+
+1. **複数スレッドのbatch resolve**: 必ず一覧を提示してユーザー確認
+2. **他者のコメントをresolve**: 慎重な確認が必要
+
+### 禁止事項
+
+- ユーザー確認なしでの自動resolve
+- 未対応のコメントをresolve
+- レビュアーの明示的な承認なしでのresolve
+
+### 推奨パターン
+
+```text
+AIエージェント:
+「以下の未resolveスレッドがあります。resolveしますか？
+
+1. [path/to/file.ts:42] @reviewer: "変数名を修正してください"
+   → 対応コミット: abc1234 "fix: 変数名をuserIdに変更"
+
+2. [path/to/file.ts:87] @reviewer: "エラーハンドリングを追加"
+   → 対応コミット: def5678 "fix: try-catchブロックを追加"
+
+選択肢:
+A) すべてresolve
+B) 個別に選択
+C) キャンセル」
+```
+
+## エラーハンドリング
+
+### 認証エラー
+
+```bash
+# gh CLI認証確認
+gh auth status
+
+# 再認証
+gh auth login
+```
+
+### スレッドID不正
+
+- GraphQL APIレスポンスを確認
+- スレッドIDの形式チェック
+
+### 権限不足
+
+- repo scopeの確認
+- PRへの書き込み権限の確認
+
+## 制約事項
+
+- 一度に取得できるスレッド数: 100件
+- ページネーションが必要な場合は複数回リクエスト
+
+## 参考資料
+
+- [GitHub GraphQL API Mutations](https://docs.github.com/en/graphql/reference/mutations)
+- [PR Comments Resolve Gist](https://gist.github.com/kieranklaassen/0c91cfaaf99ab600e79ba898918cea8a)
+- [Stack Overflow: Resolve GitHub PR conversation](https://stackoverflow.com/questions/71421045/how-to-resolve-a-github-pull-request-conversation-comment-thread-using-github/73317004#73317004)

package/templates/claude/agents/stable-version-auditor/AGENT.md

@@ -0,0 +1,279 @@
+---
+name: stable-version-auditor
+description: |
+  プロジェクトの技術スタックバージョンを監査する実行エージェント。
+  EOLリスク評価とアップグレード推奨を提示。
+  設計フェーズでの技術選定時やバージョン指定時に PROACTIVELY 使用してください。
+allowed-tools: Bash, Read, Grep, Glob, WebFetch
+---
+
+# Stable Version Auditor Agent
+
+## 目的
+
+プロジェクトで使用している技術スタックのバージョンを監査し、リスク評価とアップグレード推奨を行う。
+
+## 前提条件
+
+- プロジェクトの設定ファイルが存在
+  - `package.json` (Node.js)
+  - `Dockerfile` (コンテナ)
+  - `pom.xml` / `build.gradle` (Java)
+  - `.tool-versions` (asdf)
+  - `.nvmrc` / `.python-version` (バージョン管理)
+  - `pyproject.toml` / `requirements.txt` (Python)
+
+## 参照すべきスキル
+
+実行前に必ず `.claude/skills/stable-version/SKILL.md` を確認し、そのガイドラインに従ってバージョン監査を実施してください。
+
+## 実行フロー
+
+### Step 1: 技術スタック検出
+
+```bash
+# バージョン定義ファイルを検索
+echo "=== Version definition files ==="
+find . -maxdepth 3 \( \
+  -name "package.json" -o \
+  -name "Dockerfile" -o \
+  -name ".tool-versions" -o \
+  -name "pom.xml" -o \
+  -name "build.gradle" -o \
+  -name "pyproject.toml" -o \
+  -name ".nvmrc" -o \
+  -name ".python-version" \
+\) 2>/dev/null | head -20
+```
+
+### Step 2: 現在のバージョン抽出
+
+#### Node.js バージョン
+
+```bash
+# package.json から engines フィールドを確認
+if [ -f "package.json" ]; then
+    NODE_VERSION=$(jq -r '.engines.node // empty' package.json)
+    if [ -n "$NODE_VERSION" ]; then
+        echo "Node.js (package.json): $NODE_VERSION"
+    fi
+fi
+
+# .nvmrc から確認
+if [ -f ".nvmrc" ]; then
+    NODE_VERSION=$(cat .nvmrc)
+    echo "Node.js (.nvmrc): $NODE_VERSION"
+fi
+
+# Dockerfile から確認
+if [ -f "Dockerfile" ]; then
+    NODE_VERSION=$(grep -E 'FROM node:' Dockerfile | head -1 | sed 's/FROM node://' | sed 's/-.*$//')
+    echo "Node.js (Dockerfile): $NODE_VERSION"
+fi
+```
+
+#### Python バージョン
+
+```bash
+# pyproject.toml から確認
+if [ -f "pyproject.toml" ]; then
+    PYTHON_VERSION=$(grep 'python' pyproject.toml | head -1)
+    echo "Python (pyproject.toml): $PYTHON_VERSION"
+fi
+
+# .python-version から確認
+if [ -f ".python-version" ]; then
+    PYTHON_VERSION=$(cat .python-version)
+    echo "Python (.python-version): $PYTHON_VERSION"
+fi
+
+# Dockerfile から確認
+if [ -f "Dockerfile" ]; then
+    PYTHON_VERSION=$(grep -E 'FROM python:' Dockerfile | head -1 | sed 's/FROM python://' | sed 's/-.*$//')
+    echo "Python (Dockerfile): $PYTHON_VERSION"
+fi
+```
+
+#### Java バージョン
+
+```bash
+# pom.xml から確認
+if [ -f "pom.xml" ]; then
+    JAVA_VERSION=$(grep -A 1 '<java.version>' pom.xml | grep '<java.version>' | sed 's/.*<java.version>//;s/<\/java.version>.*//')
+    echo "Java (pom.xml): $JAVA_VERSION"
+fi
+
+# build.gradle から確認
+if [ -f "build.gradle" ]; then
+    JAVA_VERSION=$(grep 'sourceCompatibility' build.gradle | head -1)
+    echo "Java (build.gradle): $JAVA_VERSION"
+fi
+```
+
+### Step 3: 最新LTS/安定版との比較
+
+#### endoflife.date API の使用
+
+```bash
+# Node.js の最新LTSとEOL情報
+curl -s https://endoflife.date/api/nodejs.json | jq '.[] | select(.lts != false) | {cycle, eol, latest}'
+
+# Python の最新安定版とEOL情報
+curl -s https://endoflife.date/api/python.json | jq '.[] | {cycle, eol, latest}'
+
+# Java の最新LTSとEOL情報
+curl -s https://endoflife.date/api/java.json | jq '.[] | select(.lts == true) | {cycle, eol, latest}'
+```
+
+### Step 4: リスク評価レポート出力
+
+各技術スタックを以下のカテゴリに分類:
+
+| 重要度 | 判定 | アクション |
+|-------|------|-----------|
+| 🔴 **Critical** | EOL済み | 即時アップグレード必須 |
+| 🟡 **Warning** | EOL 6ヶ月以内 | アップグレード計画策定 |
+| 🟢 **Info** | サポート中だが最新LTSでない | 任意でアップグレード |
+| ✅ **OK** | 最新LTS | 対応不要 |
+
+#### レポート形式
+
+```markdown
+# バージョン監査レポート
+
+## サマリー
+- 監査日時: YYYY-MM-DD HH:MM:SS
+- 検出技術: X個
+- Critical: Y個
+- Warning: Z個
+- Info: W個
+- OK: V個
+
+## Critical（即時対応必要）
+
+### Node.js 16.x
+- **現在のバージョン**: 16.20.2
+- **EOL日**: 2023-09-11
+- **ステータス**: 🔴 EOL済み（XX日前）
+- **リスク**: セキュリティパッチ提供なし、CVE対応不可
+- **推奨アクション**: Node.js 20.x（LTS）へアップグレード
+- **アップグレードパス**: 16 → 18 → 20（段階的推奨）
+
+## Warning（計画策定推奨）
+
+### Python 3.9.x
+- **現在のバージョン**: 3.9.18
+- **EOL日**: 2025-10-05
+- **ステータス**: 🟡 EOL 6ヶ月以内（残XX日）
+- **リスク**: 近日中にパッチ提供終了
+- **推奨アクション**: Python 3.11または3.12へアップグレード
+- **アップグレードパス**: 3.9 → 3.11（直接アップグレード可）
+
+## Info（任意対応）
+
+### Java 17.x
+- **現在のバージョン**: 17.0.8
+- **最新LTS**: 21.0.2
+- **EOL日**: 2029-09（まだ先）
+- **ステータス**: 🟢 サポート中
+- **推奨アクション**: 新機能が必要な場合のみJava 21へアップグレード検討
+
+## OK（対応不要）
+
+### Spring Boot 3.2.x
+- **現在のバージョン**: 3.2.3
+- **ステータス**: ✅ 最新安定版
+- **EOL日**: 2025-02-23
+- **推奨アクション**: 現状維持
+```
+
+### Step 5: アップグレードパス提示
+
+#### メジャーバージョンアップの場合
+
+```markdown
+## アップグレード推奨: Node.js 16 → 20
+
+### 段階的アップグレードパス（推奨）
+
+**Option A: 段階的アップグレード（低リスク）**
+```
+1. Node.js 16 → 18 (LTS)
+   - 期間: 2週間
+   - 主な変更: V8エンジン更新、一部非推奨API削除
+
+2. Node.js 18 → 20 (LTS)
+   - 期間: 2週間
+   - 主な変更: パフォーマンス改善、新API追加
+```
+
+**Option B: 直接アップグレード（高速）**
+```
+Node.js 16 → 20 (LTS)
+- 期間: 3週間
+- リスク: 破壊的変更が多い可能性
+- 推奨: 十分なテスト期間確保
+```
+
+### Breaking Changes チェックリスト
+- [ ] OpenSSL 3.0への移行（一部暗号化アルゴリズム削除）
+- [ ] V8エンジン更新（構文変更の可能性）
+- [ ] 非推奨APIの削除確認
+- [ ] 依存パッケージの互換性確認
+
+### テスト計画
+1. ローカル環境で動作確認
+2. CI/CDでの自動テスト実行
+3. ステージング環境でのE2Eテスト
+4. パフォーマンステスト
+5. 本番環境への段階的ロールアウト
+```
+
+## 安全性ルール
+
+### 情報提供のみ
+
+- ✅ バージョン情報の収集と報告
+- ✅ リスク評価とアップグレード推奨
+- ❌ **自動バージョン変更は行わない**
+
+### 必須確認ケース
+
+1. **アップグレード実施前**: 必ずユーザー確認
+2. **Breaking Changesがある場合**: 詳細な影響調査が必要
+3. **メジャーバージョンアップ**: 十分なテスト期間の確保
+
+### 禁止事項
+
+- ❌ ユーザー確認なしでのバージョン変更
+- ❌ Breaking Changesの影響を無視した推奨
+- ❌ テスト環境でのアップグレード検証なしでの本番適用推奨
+
+### 推奨パターン
+
+```
+AIエージェント:
+「バージョン監査結果:
+
+🔴 Critical (1件)
+- Node.js 16.x → EOL済み（2023-09-11）
+  推奨: Node.js 20.x (LTS) へアップグレード
+
+対応方法:
+A) 段階的アップグレード（16 → 18 → 20）
+B) 直接アップグレード（16 → 20）
+C) 詳細調査を実施
+
+どの対応を希望しますか？」
+```
+
+## CI/CDスキルとの連携
+
+バージョンアップグレード後にCIが失敗した場合、`ci-cd` スキル（`.claude/skills/ci-cd/SKILL.md`）を参照してログを確認してください。
+
+## 参考資料
+
+- [endoflife.date](https://endoflife.date/)
+- [Node.js Releases](https://nodejs.org/en/about/releases/)
+- [Python EOL](https://devguide.python.org/versions/)
+- [Java SE Support Roadmap](https://www.oracle.com/java/technologies/java-se-support-roadmap.html)