@k2works/claude-code-booster 0.8.0 → 0.9.0

package/lib/assets/.claude/commands/update-dart-doc.md

@@ -1,202 +0,0 @@
-## Update Dart Doc
-
-Dart ファイルの DartDoc コメントを体系的に管理し、高品質な日本語ドキュメントを維持します。
-
-### 使い方
-
-```bash
-# 新規追加と更新を同時に実行
-「DartDoc コメントがないクラスに追加し、基準を満たさないコメントを更新してください」
-
-# PR の変更ファイルを確認
-「PR #4308 で変更されたファイルの DartDoc に Claude マーカーがあるか確認してください」
-
-# 特定ディレクトリのドキュメント整備
-「packages/app/lib/ui/screen/ 配下の Widget クラスに DartDoc を追加してください」
-
-# マーカーなしで実行
-/update-dart-doc --marker false
-「既存プロジェクトの DartDoc を改善（Claude マーカーは付けない）」
-```
-
-### オプション
-
-- `--marker <true|false>` : Claude マーカーを付与するか（デフォルト: true）
-
-### 基本例
-
-```bash
-# 1. 対象ファイルの分析
-find . -name "*.dart" -not -path "*/.*" | grep -v "_test.dart" | grep -v "_vrt.dart"
-「DartDoc が不足しているクラス（コメント行数 0 または 30 文字未満）を特定してください」
-
-# 2. ドキュメント追加
-「特定されたクラスに必須要素を含む DartDoc コメントを追加してください」
-
-# 3. マーカー確認
-「追加・更新したすべての DartDoc に Claude マーカーがあることを確認してください」
-```
-
-### 実行手順
-
-#### 1. 対象要素の優先順位
-
-1. 🔴 **最優先**: DartDoc コメントがない要素（コメント行数 0）
-2. 🟡 **次優先**: 基準を満たさない要素（30 文字未満または必須要素欠如）
-3. 🟢 **確認対象**: Claude マーカーがない既存コメント
-
-**対象要素**:
-
-- Class（すべてのクラス定義）
-- Enum（列挙型）
-- Extension（拡張メソッド）
-- 重要な関数（トップレベル関数、オプション）
-
-#### 2. DartDoc 記述ルール
-
-**基本構造**:
-
-```dart
-/// {要素の概要説明}（30-60 文字、必須）
-///
-/// {詳細説明}（役割、使用コンテキスト、注意点を必ず含む、50-200 文字）
-///
-/// Generated by Claude 🤖
-@アノテーション  // 既存アノテーションは変更しない
-class クラス名 {
-```
-
-**文章スタイル**:
-
-- 丁寧語（ですます調）: 「表示します」「管理するクラスです」
-- 句読点は「。」「、」を使用
-- 日本語と半角英数字の間に半角スペース
-- 技術用語は英語表記: 「Authentication 状態」
-- 各行は 80 文字以内
-
-#### 3. クラスカテゴリ別の記述例
-
-**状態管理クラス（Riverpod）**:
-
-```dart
-/// 水平スワイプジェスチャーの無効化状態を管理する State です。
-///
-/// 特定の画面や操作中に水平スワイプを無効化する必要がある場合に
-/// 使用します。例えば、カルーセル表示中や特定の入力中など。
-///
-/// Generated by Claude 🤖
-@Riverpod(keepAlive: true, dependencies: [])
-class HorizontalDragGestureIgnoreState extends _$HorizontalDragGestureIgnoreState {
-```
-
-**Widget クラス**:
-
-```dart
-/// ユーザープロフィールを表示する Widget です。
-///
-/// アバター画像、ユーザー名、ステータス情報を縦に配置し、
-/// タップ時にプロフィール詳細画面へ遷移します。
-///
-/// Generated by Claude 🤖
-class UserProfileWidget extends HookConsumerWidget {
-```
-
-#### 4. 既存コンテンツ保持ルール
-
-1. **既存コメントが基準を満たす場合**: そのまま保持（新規追加しない）
-   - 基準: 30 文字以上かつ必須要素（概要・詳細・マーカー）を含む
-2. **既存コメントが基準を満たさない場合**: 完全に置き換え（重複させない）
-3. **既存コメントがない場合**: 新しいコメントを追加
-
-**保持すべき重要情報**:
-
-- URL やリンク: `See also:` で始まる参照
-- TODO コメント: `TODO(user_name):` 形式
-- 注意事項: `注意:` や `Warning:` などの警告
-- 使用例: `例:` や `Example:` で始まるコード
-- 技術的制約: パフォーマンスや制限の記述
-
-### Claude マーカー管理
-
-```bash
-# マーカー形式
-/// Generated by Claude 🤖
-
-# PR の変更ファイルでマーカー確認
-gh pr diff 4308 --name-only | grep "\.dart$" | xargs grep -l "Generated by Claude"
-「マーカーがないファイルに追加してください」
-```
-
-### 品質チェックリスト
-
-- ✅ **文字数**: 概要 30-60 文字、詳細 50-200 文字を厳守
-- ✅ **必須要素**: 概要・詳細説明・ Claude マーカーの 3 要素を必ず含む
-- ✅ **完全性**: 役割・使用コンテキスト・注意点を記載
-- ✅ **一貫性**: 文体を丁寧語（ですます調）で統一
-- ✅ **書式**: 日本語と英語の間に半角スペース
-- ✅ **正確性**: 実装を分析し、事実に基づいた記述のみ
-- ✅ **構造**: アノテーションを保持、コメントは上に配置
-- ✅ **長さ**: 各行を 80 文字以内
-- ✅ **マーカー**: Claude による変更には必ずマーカー付与
-
-### 注意事項
-
-**🔴 絶対禁止事項**:
-
-- ❌ ドキュメントコメント以外のコード変更
-- ❌ 実装詳細に関する推測（事実のみ記載）
-- ❌ 英語と日本語の不自然な混在
-- ❌ 既存アノテーションの削除・変更
-- ❌ 既存コメントとの重複
-- ❌ テストファイル（`*_test.dart`）への文字数基準未満のコメント
-- ❌ VRT ファイル（`*_vrt.dart`）への文字数基準未満のコメント
-
-**静的解析とコミット**:
-
-```bash
-# 実行結果の記録
-ADDED_COMMENTS=0
-UPDATED_COMMENTS=0
-ERRORS=0
-
-# 変更後の確認
-melos analyze
-if [ $? -ne 0 ]; then
-  echo "🔴 エラー: 静的解析が失敗しました"
-  exit 1
-fi
-
-# 実行サマリーの出力
-echo "📊 実行結果:"
-echo "- 追加したコメント: $ADDED_COMMENTS 件"
-echo "- 更新したコメント: $UPDATED_COMMENTS 件"
-echo "- エラー発生数: $ERRORS 件"
-
-# コミット例
-git commit -m "docs: DartDoc コメントを追加・更新
-
-- 基準を満たさないクラス、enum、extension に DartDoc を追加
-- 30 文字未満のコメントを基準に沿って更新
-- Claude マーカーを統一的に付与
-
-実行結果:
-- 追加: $ADDED_COMMENTS 件
-- 更新: $UPDATED_COMMENTS 件
-
-Generated by Claude 🤖"
-```
-
-### 実行成功基準
-
-1. **完了判定**: 以下をすべて満たす場合に成功
-   - `melos analyze` が PASSED
-   - エラー発生数が 0
-   - 追加・更新したコメントがすべて基準を満たす
-
-2. **部分成功**: 以下の場合
-   - エラー発生数が 5 件未満
-   - 全体の 90% 以上が基準を満たす
-
-3. **失敗**: 以下の場合
-   - `melos analyze` が FAILED
-   - エラー発生数が 5 件以上

package/lib/assets/.claude/commands/update-doc-string.md

@@ -1,306 +0,0 @@
-## Update Doc String
-
-多言語対応の docstring/コメントを体系的に管理し、高品質なドキュメントを維持します。
-
-### 使い方
-
-```bash
-# 言語を自動検出して実行
-「docstring がないクラス・関数に追加し、基準を満たさないコメントを更新してください」
-
-# 言語を指定して実行
-/update-doc-string --lang python
-「Python ファイルの docstring を PEP 257 準拠で更新してください」
-
-# 特定ディレクトリのドキュメント整備
-「src/components/ 配下の関数に JSDoc を追加してください」
-```
-
-### オプション
-
-- `--lang <en|ja>` : ドキュメントの記述言語（デフォルト: 既存コメントから自動判定、なければ en）
-- `--style <スタイル>` : ドキュメントスタイルを指定（言語固有のデフォルトあり）
-- `--marker <true|false>` : Claude マーカーを付与するか（デフォルト: true）
-
-### 基本例
-
-```bash
-# 1. 対象ファイルの分析（プログラミング言語は自動検出）
-find . -type f \( -name "*.py" -o -name "*.js" -o -name "*.ts" -o -name "*.dart" -o -name "*.go" -o -name "*.rs" \) | grep -v test
-「docstring が不足している要素（コメント行数 0 または 30 文字未満）を特定してください」
-
-# 2. ドキュメント追加（言語自動判定）
-「特定された要素に言語固有の必須要素を含む docstring を追加してください」
-# → 既存コメントに日本語があれば日本語で、なければ英語で記述
-
-# 3. ドキュメント追加（明示的に英語指定）
-/update-doc-string --lang en
-「Add docstrings with required elements to the identified elements」
-
-# 4. マーカー確認
-「追加・更新したすべての docstring に Claude マーカーがあることを確認してください」
-```
-
-### 実行手順
-
-#### 1. 対象要素の優先順位
-
-1. 🔴 **最優先**: docstring/コメントがない要素（コメント行数 0）
-2. 🟡 **次優先**: 基準を満たさない要素（30 文字未満または必須要素欠如）
-3. 🟢 **確認対象**: Claude マーカーがない既存コメント
-
-**対象要素（言語共通）**:
-
-- Class/クラス定義
-- Function/関数・メソッド
-- Module/モジュール（Python, Go）
-- Enum/列挙型
-- Interface/インターフェース（TypeScript, Go）
-
-#### 2. 言語別記述ルール
-
-**Python (PEP 257)**:
-
-```python
-# 日本語版（デフォルト）
-def calculate_total(items: List[Item]) -> float:
-    """アイテムリストの合計金額を計算します。（30-60 文字）
-
-    各アイテムの価格と数量を掛け合わせ、税込み合計を返します。
-    空のリストの場合は 0.0 を返します。（50-200 文字）
-
-    Args:
-        items: 計算対象のアイテムリスト
-
-    Returns:
-        税込み合計金額
-
-    Generated by Claude 🤖
-    """
-
-# 英語版（--lang en）
-def calculate_total(items: List[Item]) -> float:
-    """Calculate the total amount for a list of items. (30-60 chars)
-
-    Multiplies the price and quantity of each item and returns
-    the total with tax. Returns 0.0 for empty lists. (50-200 chars)
-
-    Args:
-        items: List of items to calculate
-
-    Returns:
-        Total amount with tax
-
-    Generated by Claude 🤖
-    """
-```
-
-**JavaScript/TypeScript (JSDoc)**:
-
-```javascript
-/**
- * ユーザープロフィールを表示するコンポーネントです。（30-60 文字）
- *
- * アバター画像、ユーザー名、ステータス情報を表示し、
- * クリック時にプロフィール詳細画面へ遷移します。（50-200 文字）
- *
- * @param {Object} props - コンポーネントのプロパティ
- * @param {string} props.userId - ユーザー ID
- * @param {boolean} [props.showStatus=true] - ステータス表示フラグ
- * @returns {JSX.Element} レンダリングされたコンポーネント
- *
- * @generated by Claude 🤖
- */
-const UserProfile = ({ userId, showStatus = true }) => {
-```
-
-**Go**:
-
-```go
-// CalculateTotal はアイテムリストの合計金額を計算します。（30-60 文字）
-//
-// 各アイテムの価格と数量を掛け合わせ、税込み合計を返します。
-// 空のスライスの場合は 0.0 を返します。（50-200 文字）
-//
-// Generated by Claude 🤖
-func CalculateTotal(items []Item) float64 {
-```
-
-**Rust**:
-
-```rust
-/// アイテムリストの合計金額を計算します。（30-60 文字）
-///
-/// 各アイテムの価格と数量を掛け合わせ、税込み合計を返します。
-/// 空のベクタの場合は 0.0 を返します。（50-200 文字）
-///
-/// Generated by Claude 🤖
-pub fn calculate_total(items: &[Item]) -> f64 {
-```
-
-**Dart (DartDoc)**:
-
-```dart
-/// ユーザープロフィールを表示する Widget です。（30-60 文字）
-///
-/// アバター画像、ユーザー名、ステータス情報を縦に配置し、
-/// タップ時にプロフィール詳細画面へ遷移します。（50-200 文字）
-///
-/// Generated by Claude 🤖
-class UserProfileWidget extends StatelessWidget {
-```
-
-#### 3. 既存コンテンツ保持ルール
-
-1. **既存コメントが基準を満たす場合**: そのまま保持（新規追加しない）
-   - 基準: 30 文字以上かつ必須要素（概要・詳細・マーカー）を含む
-2. **既存コメントが基準を満たさない場合**: 完全に置き換え（重複させない）
-3. **既存コメントがない場合**: 新しいコメントを追加
-
-**保持すべき重要情報**:
-
-- URL やリンク: `See also:`, `@see`, `参照:` など
-- TODO コメント: `TODO:`, `FIXME:`, `XXX:` 形式
-- 注意事項: `Note:`, `Warning:`, `注意:` など
-- 使用例: `Example:`, `例:`, `# Examples` など
-- 既存のパラメータ・戻り値説明
-
-### 言語別設定
-
-```yaml
-# 言語別デフォルト設定
-languages:
-  python:
-    style: "google"  # google, numpy, sphinx
-    indent: 4
-    quotes: '"""'
-
-  javascript:
-    style: "jsdoc"
-    indent: 2
-    prefix: "/**"
-    suffix: "*/"
-
-  typescript:
-    style: "tsdoc"
-    indent: 2
-    prefix: "/**"
-    suffix: "*/"
-
-  go:
-    style: "godoc"
-    indent: 0
-    prefix: "//"
-
-  rust:
-    style: "rustdoc"
-    indent: 0
-    prefix: "///"
-
-  dart:
-    style: "dartdoc"
-    indent: 0
-    prefix: "///"
-```
-
-### 品質チェックリスト
-
-- ✅ **文字数**: 概要 30-60 文字、詳細 50-200 文字を厳守
-- ✅ **必須要素**: 概要・詳細説明・ Claude マーカーの 3 要素を必ず含む
-- ✅ **完全性**: 役割・使用コンテキスト・注意点を記載
-- ✅ **言語規約**: 各言語の公式スタイルガイドに準拠
-- ✅ **例外**: エラー・例外の説明（該当する場合）
-- ✅ **正確性**: 実装を分析し、事実に基づいた記述のみ
-
-### 注意事項
-
-**🔴 絶対禁止事項**:
-
-- ❌ ドキュメントコメント以外のコード変更
-- ❌ 実装詳細に関する推測（事実のみ記載）
-- ❌ 言語規約に反するフォーマット
-- ❌ 既存の型アノテーションの削除・変更
-- ❌ 既存コメントとの重複
-- ❌ テストファイルへの文字数基準未満のコメント
-
-**実行と検証**:
-
-```bash
-# 実行結果の記録
-ADDED_COMMENTS=0
-UPDATED_COMMENTS=0
-ERRORS=0
-
-# 既存コメントから言語を自動判定
-# 日本語文字（ひらがな・カタカナ・漢字）を検出したら ja、それ以外は en
-DOC_LANGUAGE="en"  # デフォルト
-if grep -r '[ぁ-んァ-ヶー一-龠]' --include="*.py" --include="*.js" --include="*.ts" --include="*.dart" --include="*.go" --include="*.rs" . 2>/dev/null | head -n 1; then
-  DOC_LANGUAGE="ja"
-fi
-
-# プログラミング言語の自動検出と静的解析
-if [ -f "*.py" ]; then
-  pylint --disable=all --enable=missing-docstring .
-elif [ -f "*.js" ] || [ -f "*.ts" ]; then
-  eslint . --rule 'jsdoc/require-jsdoc: error'
-elif [ -f "*.go" ]; then
-  golint ./...
-elif [ -f "*.rs" ]; then
-  cargo doc --no-deps
-elif [ -f "*.dart" ]; then
-  melos analyze
-fi
-
-if [ $? -ne 0 ]; then
-  echo "🔴 エラー: 静的解析が失敗しました"
-  exit 1
-fi
-
-# 実行サマリーの出力
-echo "📊 実行結果:"
-echo "- ドキュメント言語: $DOC_LANGUAGE"
-echo "- 追加したコメント: $ADDED_COMMENTS 件"
-echo "- 更新したコメント: $UPDATED_COMMENTS 件"
-echo "- エラー発生数: $ERRORS 件"
-```
-
-### 実行成功基準
-
-1. **完了判定**: 以下をすべて満たす場合に成功
-   - 言語固有の静的解析が PASSED
-   - エラー発生数が 0
-   - 追加・更新したコメントがすべて基準を満たす
-
-2. **部分成功**: 以下の場合
-   - エラー発生数が 5 件未満
-   - 全体の 90% 以上が基準を満たす
-
-3. **失敗**: 以下の場合
-   - 静的解析が FAILED
-   - エラー発生数が 5 件以上
-
-### Claude との連携
-
-```bash
-# プロジェクト全体の分析（言語自動判定）
-find . -type f \( -name "*.py" -o -name "*.js" -o -name "*.ts" \)
-/update-doc-string
-「このプロジェクトの docstring を言語別のベストプラクティスに従って更新して」
-# → 既存コメントに日本語があれば ja、なければ en で実行
-
-# 明示的に英語ドキュメントで実行
-/update-doc-string --lang en
-"Update docstrings following language-specific best practices"
-
-# 明示的に日本語ドキュメントで実行
-/update-doc-string --lang ja
-「このプロジェクトの docstring を言語別のベストプラクティスに従って更新して」
-
-# マーカーなしで実行（言語自動判定）
-/update-doc-string --marker false
-"Improve existing docstrings without adding Claude markers"
-
-# 英語ドキュメント、マーカーなし
-/update-doc-string --lang en --marker false
-"Improve existing docstrings without adding Claude markers"
-```

package/lib/assets/.claude/commands/update-flutter-deps.md

@@ -1,105 +0,0 @@
-## Flutter Dependencies Update
-
-Flutter プロジェクトの依存関係を安全に更新します。
-
-### 使い方
-
-```bash
-# 依存関係の状態を確認して Claude に依頼
-flutter pub deps --style=compact
-「pubspec.yaml の依存関係を最新バージョンに更新して」
-```
-
-### 基本例
-
-```bash
-# 現在の依存関係を確認
-cat pubspec.yaml
-「この Flutter プロジェクトの依存関係を分析して更新可能なパッケージを教えて」
-
-# アップグレード後の確認
-flutter pub upgrade --dry-run
-「このアップグレード予定の内容から破壊的変更があるか確認して」
-```
-
-### Claude との連携
-
-```bash
-# 包括的な依存関係更新
-cat pubspec.yaml
-「Flutter の依存関係を分析し、以下を実行して：
-1. 各パッケージの最新バージョンを調査
-2. 破壊的変更の有無を確認
-3. 危険度を評価（安全・注意・危険）
-4. 必要なコード変更を提案
-5. 更新版 pubspec.yaml を生成」
-
-# 安全な段階的更新
-flutter pub outdated
-「メジャーバージョンアップを避けて、安全にアップデート可能なパッケージのみ更新して」
-
-# 特定パッケージの更新影響分析
-「provider を最新バージョンに更新した場合の影響と必要な変更を教えて」
-```
-
-### 詳細例
-
-```bash
-# Release Notes を含む詳細分析
-cat pubspec.yaml && flutter pub outdated
-「依存関係を分析し、各パッケージについて：
-1. 現在 → 最新バージョン
-2. 危険度評価（安全・注意・危険）
-3. 主な変更点（CHANGELOG から）
-4. 必要なコード修正
-をテーブル形式で提示して」
-
-# Null Safety 移行の分析
-cat pubspec.yaml
-「Null Safety に対応していないパッケージを特定し、移行計画を立てて」
-```
-
-### 危険度の基準
-
-```
-安全（🟢）：
-- パッチバージョンアップ（1.2.3 → 1.2.4）
-- バグ修正のみ
-- 後方互換性保証
-
-注意（🟡）：
-- マイナーバージョンアップ（1.2.3 → 1.3.0）
-- 新機能追加
-- 非推奨警告あり
-
-危険（🔴）：
-- メジャーバージョンアップ（1.2.3 → 2.0.0）
-- 破壊的変更
-- API の削除・変更
-```
-
-### 更新の実行
-
-```bash
-# バックアップ作成
-cp pubspec.yaml pubspec.yaml.backup
-cp pubspec.lock pubspec.lock.backup
-
-# 更新実行
-flutter pub upgrade
-
-# 更新後の確認
-flutter analyze
-flutter test
-flutter pub deps --style=compact
-```
-
-### 注意事項
-
-更新後は必ず動作確認を実施してください。問題が発生した場合は以下で復元：
-
-```bash
-cp pubspec.yaml.backup pubspec.yaml
-cp pubspec.lock.backup pubspec.lock
-flutter pub get
-```