@k2works/claude-code-booster 4.12.0 → 4.14.0

package/lib/assets/.claude/skills/syncing-github-project/SKILL.md

@@ -1,151 +1,151 @@
----
-name: syncing-github-project
-description: リリース計画を GitHub Project・Issue・Milestone に反映し一元管理。初回の一括同期から差異検出・自動同期まで対応する。「GitHub Project に同期したい」「Issue を作成したい」「計画と GitHub の差異を確認したい」「Milestone を設定したい」といった場面で発動する。計画ドキュメントを Single Source of Truth とし GitHub に自動反映することで、二重管理の手間と不整合を排除する。
----
-
-# GitHub Project 同期
-
-リリース計画を GitHub Project・Issue・Milestone に反映し、プロジェクト管理を GitHub 上で一元化する。
-
-`docs/development/release_plan.md` を正とし、GitHub は同期先として扱う。手動で GitHub を直接更新するのではなく、計画ドキュメントを更新してから `--sync` で反映する。
-
-## オプション
-
-| オプション | 説明 |
-|-----------|------|
-| なし | 全体の同期を実行（Project・Issue・フィールド・Milestone） |
-| `--project` | GitHub Project のみを作成 |
-| `--issues` | Issue のみを作成（Project 存在が前提） |
-| `--fields` | 各 Issue に対して Project フィールド値を設定 |
-| `--milestones` | Milestone のみを作成し Issue に割り当て |
-| `--sync` | release_plan.md と GitHub の差異を確認し同期 |
-| `--status` | 現在の GitHub Project 状態を表示 |
-
-## GitHub Project の作成
-
-release_plan.md に基づいて Project を作成し、カスタムフィールドを設定する。
-
-**標準フィールド構成**:
-
-| フィールド | タイプ | 説明 |
-|-----------|--------|------|
-| Status | Single Select | Todo / In Progress / Done |
-| リリース | Single Select | release_plan.md のリリースフェーズに対応 |
-| 優先度 | Single Select | ストーリーの優先度 |
-| SP | Number | ストーリーポイント |
-| イテレーション | Iteration | スプリント期間（開始日・期間付き） |
-
-```bash
-# Single Select フィールドの作成
-gh project field-create <PROJECT_NUMBER> --owner <OWNER> \
-  --name "<フィールド名>" --data-type "SINGLE_SELECT" \
-  --single-select-options "<選択肢1>,<選択肢2>"
-
-# Number フィールドの作成
-gh project field-create <PROJECT_NUMBER> --owner <OWNER> \
-  --name "SP" --data-type "NUMBER"
-```
-
-## Issue の作成
-
-ユーザーストーリーを GitHub Issue として作成し、Project に追加する。
-
-- **タイトル**: `[ストーリーID] ストーリー名`
-- **本文**: ユーザーストーリー、サブタスク、受入条件、見積もり情報
-- **Milestone**: リリースフェーズに対応する Milestone に割り当て
-
-```bash
-gh issue create --repo <OWNER>/<REPO> \
-  --title "<ストーリーID>: <ストーリー名>" \
-  --milestone "<Milestone 名>" --body "..."
-
-gh project item-add <PROJECT_NUMBER> --owner <OWNER> \
-  --url "https://github.com/<OWNER>/<REPO>/issues/<NUMBER>"
-```
-
-## Iteration フィールドの作成と設定
-
-Iteration フィールドは Single Select ではなく **Iteration 型** で作成する。GraphQL API で `iterationConfiguration` を含めることで、フィールド作成と同時にイテレーション期間を設定できる。
-
-```bash
-# Iteration フィールドの作成
-gh api graphql -f query='
-mutation {
-  createProjectV2Field(input: {
-    projectId: "<PROJECT_ID>"
-    dataType: ITERATION
-    name: "イテレーション"
-    iterationConfiguration: {
-      startDate: "<開始日 YYYY-MM-DD>"
-      duration: <デフォルト期間（日数）>
-      iterations: [
-        { title: "<IT名>", startDate: "<開始日>", duration: <日数> }
-      ]
-    }
-  }) { projectV2Field { ... on ProjectV2IterationField { id } } }
-}'
-
-# 各 Issue への Iteration 値の設定
-gh api graphql -f query='
-mutation {
-  updateProjectV2ItemFieldValue(input: {
-    projectId: "<PROJECT_ID>"
-    itemId: "<ITEM_ID>"
-    fieldId: "<ITERATION_FIELD_ID>"
-    value: { iterationId: "<ITERATION_ID>" }
-  }) { projectV2Item { id } }
-}'
-```
-
-## 差異確認と同期（--sync）
-
-release_plan.md と GitHub の整合性を確認し、差異があれば同期を実行する。
-
-**確認項目**: ストーリー数、SP、リリース/Milestone 割り当て、優先度、イテレーション割り当て、Status
-
-**同期動作**:
-
-- **新規ストーリー**: Issue を作成し Project に追加する
-- **変更されたストーリー**: Issue のフィールド値を更新する
-- **削除されたストーリー**: Issue をクローズする（削除はしない）
-
-## 同期フロー
-
-```mermaid
-graph TD
-    A[release_plan.md] --> B{同期開始}
-    B --> C[GitHub Project 作成]
-    C --> D[カスタムフィールド設定]
-    D --> E[Issue 作成]
-    E --> F[Project に Item 追加]
-    F --> G[フィールド値設定]
-    G --> H[Milestone 作成・割当]
-    H --> I[同期完了]
-```
-
-## 途中から再開
-
-同期作業の途中から再開する場合は、まず現在の GitHub 状態を確認する。
-
-**Example:**
-
-```
-ユーザー: 「Project と Issue は作成済み。フィールド値を設定したい」
-回答: --status で現在の GitHub 状態を確認する。
-      --fields でフィールド値を一括設定する。
-      設定後に --sync で release_plan.md との整合性を検証する。
-```
-
-## 注意事項
-
-- `docs/development/release_plan.md` が存在すること、`gh` CLI がインストールされ認証済みであること、Project API スコープが有効であること（前提条件）
-- 既存の Project/Issue がある場合は重複作成に注意する
-- Iteration フィールドの期間変更は GraphQL API または Web UI で実施する
-- 初回は `--sync` で差異確認してから同期する。大規模変更前にはバックアップを推奨する
-
-## 関連スキル
-
-- `planning-releases` — リリース計画とイテレーション計画の作成
-- `tracking-progress` — 進捗状況の確認と更新
-- `orchestrating-project` — 計画・進捗管理フェーズ全体のオーケストレーション
-- `git-commit` — 変更のコミット
+---
+name: syncing-github-project
+description: リリース計画を GitHub Project・Issue・Milestone に反映し一元管理。初回の一括同期から差異検出・自動同期まで対応する。「GitHub Project に同期したい」「Issue を作成したい」「計画と GitHub の差異を確認したい」「Milestone を設定したい」といった場面で発動する。計画ドキュメントを Single Source of Truth とし GitHub に自動反映することで、二重管理の手間と不整合を排除する。
+---
+
+# GitHub Project 同期
+
+リリース計画を GitHub Project・Issue・Milestone に反映し、プロジェクト管理を GitHub 上で一元化する。
+
+`docs/development/release_plan.md` を正とし、GitHub は同期先として扱う。手動で GitHub を直接更新するのではなく、計画ドキュメントを更新してから `--sync` で反映する。
+
+## オプション
+
+| オプション | 説明 |
+|-----------|------|
+| なし | 全体の同期を実行（Project・Issue・フィールド・Milestone） |
+| `--project` | GitHub Project のみを作成 |
+| `--issues` | Issue のみを作成（Project 存在が前提） |
+| `--fields` | 各 Issue に対して Project フィールド値を設定 |
+| `--milestones` | Milestone のみを作成し Issue に割り当て |
+| `--sync` | release_plan.md と GitHub の差異を確認し同期 |
+| `--status` | 現在の GitHub Project 状態を表示 |
+
+## GitHub Project の作成
+
+release_plan.md に基づいて Project を作成し、カスタムフィールドを設定する。
+
+**標準フィールド構成**:
+
+| フィールド | タイプ | 説明 |
+|-----------|--------|------|
+| Status | Single Select | Todo / In Progress / Done |
+| リリース | Single Select | release_plan.md のリリースフェーズに対応 |
+| 優先度 | Single Select | ストーリーの優先度 |
+| SP | Number | ストーリーポイント |
+| イテレーション | Iteration | スプリント期間（開始日・期間付き） |
+
+```bash
+# Single Select フィールドの作成
+gh project field-create <PROJECT_NUMBER> --owner <OWNER> \
+  --name "<フィールド名>" --data-type "SINGLE_SELECT" \
+  --single-select-options "<選択肢1>,<選択肢2>"
+
+# Number フィールドの作成
+gh project field-create <PROJECT_NUMBER> --owner <OWNER> \
+  --name "SP" --data-type "NUMBER"
+```
+
+## Issue の作成
+
+ユーザーストーリーを GitHub Issue として作成し、Project に追加する。
+
+- **タイトル**: `[ストーリーID] ストーリー名`
+- **本文**: ユーザーストーリー、サブタスク、受入条件、見積もり情報
+- **Milestone**: リリースフェーズに対応する Milestone に割り当て
+
+```bash
+gh issue create --repo <OWNER>/<REPO> \
+  --title "<ストーリーID>: <ストーリー名>" \
+  --milestone "<Milestone 名>" --body "..."
+
+gh project item-add <PROJECT_NUMBER> --owner <OWNER> \
+  --url "https://github.com/<OWNER>/<REPO>/issues/<NUMBER>"
+```
+
+## Iteration フィールドの作成と設定
+
+Iteration フィールドは Single Select ではなく **Iteration 型** で作成する。GraphQL API で `iterationConfiguration` を含めることで、フィールド作成と同時にイテレーション期間を設定できる。
+
+```bash
+# Iteration フィールドの作成
+gh api graphql -f query='
+mutation {
+  createProjectV2Field(input: {
+    projectId: "<PROJECT_ID>"
+    dataType: ITERATION
+    name: "イテレーション"
+    iterationConfiguration: {
+      startDate: "<開始日 YYYY-MM-DD>"
+      duration: <デフォルト期間（日数）>
+      iterations: [
+        { title: "<IT名>", startDate: "<開始日>", duration: <日数> }
+      ]
+    }
+  }) { projectV2Field { ... on ProjectV2IterationField { id } } }
+}'
+
+# 各 Issue への Iteration 値の設定
+gh api graphql -f query='
+mutation {
+  updateProjectV2ItemFieldValue(input: {
+    projectId: "<PROJECT_ID>"
+    itemId: "<ITEM_ID>"
+    fieldId: "<ITERATION_FIELD_ID>"
+    value: { iterationId: "<ITERATION_ID>" }
+  }) { projectV2Item { id } }
+}'
+```
+
+## 差異確認と同期（--sync）
+
+release_plan.md と GitHub の整合性を確認し、差異があれば同期を実行する。
+
+**確認項目**: ストーリー数、SP、リリース/Milestone 割り当て、優先度、イテレーション割り当て、Status
+
+**同期動作**:
+
+- **新規ストーリー**: Issue を作成し Project に追加する
+- **変更されたストーリー**: Issue のフィールド値を更新する
+- **削除されたストーリー**: Issue をクローズする（削除はしない）
+
+## 同期フロー
+
+```mermaid
+graph TD
+    A[release_plan.md] --> B{同期開始}
+    B --> C[GitHub Project 作成]
+    C --> D[カスタムフィールド設定]
+    D --> E[Issue 作成]
+    E --> F[Project に Item 追加]
+    F --> G[フィールド値設定]
+    G --> H[Milestone 作成・割当]
+    H --> I[同期完了]
+```
+
+## 途中から再開
+
+同期作業の途中から再開する場合は、まず現在の GitHub 状態を確認する。
+
+**Example:**
+
+```
+ユーザー: 「Project と Issue は作成済み。フィールド値を設定したい」
+回答: --status で現在の GitHub 状態を確認する。
+      --fields でフィールド値を一括設定する。
+      設定後に --sync で release_plan.md との整合性を検証する。
+```
+
+## 注意事項
+
+- `docs/development/release_plan.md` が存在すること、`gh` CLI がインストールされ認証済みであること、Project API スコープが有効であること（前提条件）
+- 既存の Project/Issue がある場合は重複作成に注意する
+- Iteration フィールドの期間変更は GraphQL API または Web UI で実施する
+- 初回は `--sync` で差異確認してから同期する。大規模変更前にはバックアップを推奨する
+
+## 関連スキル
+
+- `planning-releases` — リリース計画とイテレーション計画の作成
+- `tracking-progress` — 進捗状況の確認と更新
+- `orchestrating-project` — 計画・進捗管理フェーズ全体のオーケストレーション
+- `git-commit` — 変更のコミット

package/lib/assets/.claude/skills/tracking-progress/SKILL.md

@@ -1,91 +1,91 @@
----
-name: tracking-progress
-description: プロジェクトの開発進捗を多角的に分析しレポートを生成。イテレーション達成度、技術実装状況、品質メトリクスを確認し、計画ドキュメントを自動更新する。「進捗を確認したい」「プロジェクトの状態を知りたい」「イテレーションの達成度を分析したい」「進捗ドキュメントを更新したい」といった場面で発動する。定期的な進捗可視化により、遅延や品質低下を早期に発見しプロジェクトの透明性を確保する。
----
-
-# 進捗追跡
-
-プロジェクトの開発進捗を多角的に分析し、現在の状況を定量的に報告する。Git 履歴・テスト結果・ドキュメントを総合的に分析して進捗を可視化する。
-
-## オプション
-
-| オプション | 説明 |
-|-----------|------|
-| なし | 全体的な進捗確認（デフォルト） |
-| `--brief` | 簡潔な進捗サマリー表示 |
-| `--detailed` | 詳細な進捗レポート生成 |
-| `--iteration <番号>` | 特定イテレーションの進捗確認 |
-| `--technical` | 技術的な実装状況に焦点 |
-| `--docs` | ドキュメント更新状況の確認 |
-| `--update` | `docs/development/` 内のドキュメントを現在の進捗に合わせて更新 |
-
-## 分析の観点
-
-- **イテレーション達成度**: 計画 vs 実績の比較分析（SP、ストーリー数、期間）
-- **技術実装状況**: 機能完成度・テスト結果・ビルド状態
-- **品質メトリクス**: テストカバレッジ、静的解析結果、コード複雑度
-- **ドキュメント整備**: 計画書・仕様書・手順書の最新性
-
-## --update オプションの詳細
-
-`docs/development/` 内のドキュメントを現在の進捗に合わせて自動更新する。
-
-**更新対象**:
-
-- `docs/development/release_plan.md` — 進捗状況テーブル、リリース条件チェック、バーンダウン実績値
-- `docs/development/iteration_plan-*.md` — 成功基準チェック、タスク状態、完了条件（DoD）、メトリクス実績値
-
-**更新判定の情報源**:
-
-```bash
-git log --oneline --since="2 weeks ago"   # 実装状況の分析
-dotnet test --logger trx                  # テスト結果の取得
-npm test -- --coverage                    # カバレッジの取得
-```
-
-## 出力例
-
-```
-プロジェクト進捗レポート
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Overall Status: フルスタック実装完成 (MVP 準備段階)
-
-Iteration Progress:
-├─ Iteration 1 (認証・閲覧): 完了 (計画 10 日→実績 4 日)
-├─ Iteration 2 (予約機能): 計画済み
-├─ Iteration 3 (キャンセル): 待機中
-└─ Iteration 4 (運用準備): 待機中
-
-Technical Implementation:
-├─ Backend (.NET 9): 完全実装 (181 テスト全通過)
-├─ Frontend (React TS): 完全実装
-└─ API Integration: フルスタック連携確認
-```
-
-## 途中から再開
-
-進捗追跡の途中から再開する場合は、前回の追跡結果を確認する。
-
-**Example:**
-
-```
-ユーザー: 「イテレーション 2 の中間進捗を確認したい」
-回答: --iteration 2 で現在の達成状況を分析する。
-      計画 SP と完了 SP を比較し、残りの期間で完了可能か評価する。
-      遅延リスクがあれば早期に報告する。
-```
-
-## 注意事項
-
-- Git リポジトリ内で実行し、プロジェクト構造を理解していること（前提条件）
-- 実行時点での動的な状況を総合的に分析する
-- `--update` 使用時は更新前に Git でコミットしておくことを推奨する（ロールバック用）
-- イテレーション開始・終了時の定期実行を推奨する
-- `--update` 実行後、KPT セクションは手動で記入して振り返りを完了する
-
-## 関連スキル
-
-- `managing-docs` — ドキュメント一覧と進捗状況の確認
-- `git-commit` — 進捗に合わせた適切なコミット実行
-- `planning-releases` — イテレーション計画の作成・更新
+---
+name: tracking-progress
+description: プロジェクトの開発進捗を多角的に分析しレポートを生成。イテレーション達成度、技術実装状況、品質メトリクスを確認し、計画ドキュメントを自動更新する。「進捗を確認したい」「プロジェクトの状態を知りたい」「イテレーションの達成度を分析したい」「進捗ドキュメントを更新したい」といった場面で発動する。定期的な進捗可視化により、遅延や品質低下を早期に発見しプロジェクトの透明性を確保する。
+---
+
+# 進捗追跡
+
+プロジェクトの開発進捗を多角的に分析し、現在の状況を定量的に報告する。Git 履歴・テスト結果・ドキュメントを総合的に分析して進捗を可視化する。
+
+## オプション
+
+| オプション | 説明 |
+|-----------|------|
+| なし | 全体的な進捗確認（デフォルト） |
+| `--brief` | 簡潔な進捗サマリー表示 |
+| `--detailed` | 詳細な進捗レポート生成 |
+| `--iteration <番号>` | 特定イテレーションの進捗確認 |
+| `--technical` | 技術的な実装状況に焦点 |
+| `--docs` | ドキュメント更新状況の確認 |
+| `--update` | `docs/development/` 内のドキュメントを現在の進捗に合わせて更新 |
+
+## 分析の観点
+
+- **イテレーション達成度**: 計画 vs 実績の比較分析（SP、ストーリー数、期間）
+- **技術実装状況**: 機能完成度・テスト結果・ビルド状態
+- **品質メトリクス**: テストカバレッジ、静的解析結果、コード複雑度
+- **ドキュメント整備**: 計画書・仕様書・手順書の最新性
+
+## --update オプションの詳細
+
+`docs/development/` 内のドキュメントを現在の進捗に合わせて自動更新する。
+
+**更新対象**:
+
+- `docs/development/release_plan.md` — 進捗状況テーブル、リリース条件チェック、バーンダウン実績値
+- `docs/development/iteration_plan-*.md` — 成功基準チェック、タスク状態、完了条件（DoD）、メトリクス実績値
+
+**更新判定の情報源**:
+
+```bash
+git log --oneline --since="2 weeks ago"   # 実装状況の分析
+dotnet test --logger trx                  # テスト結果の取得
+npm test -- --coverage                    # カバレッジの取得
+```
+
+## 出力例
+
+```
+プロジェクト進捗レポート
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Overall Status: フルスタック実装完成 (MVP 準備段階)
+
+Iteration Progress:
+├─ Iteration 1 (認証・閲覧): 完了 (計画 10 日→実績 4 日)
+├─ Iteration 2 (予約機能): 計画済み
+├─ Iteration 3 (キャンセル): 待機中
+└─ Iteration 4 (運用準備): 待機中
+
+Technical Implementation:
+├─ Backend (.NET 9): 完全実装 (181 テスト全通過)
+├─ Frontend (React TS): 完全実装
+└─ API Integration: フルスタック連携確認
+```
+
+## 途中から再開
+
+進捗追跡の途中から再開する場合は、前回の追跡結果を確認する。
+
+**Example:**
+
+```
+ユーザー: 「イテレーション 2 の中間進捗を確認したい」
+回答: --iteration 2 で現在の達成状況を分析する。
+      計画 SP と完了 SP を比較し、残りの期間で完了可能か評価する。
+      遅延リスクがあれば早期に報告する。
+```
+
+## 注意事項
+
+- Git リポジトリ内で実行し、プロジェクト構造を理解していること（前提条件）
+- 実行時点での動的な状況を総合的に分析する
+- `--update` 使用時は更新前に Git でコミットしておくことを推奨する（ロールバック用）
+- イテレーション開始・終了時の定期実行を推奨する
+- `--update` 実行後、KPT セクションは手動で記入して振り返りを完了する
+
+## 関連スキル
+
+- `managing-docs` — ドキュメント一覧と進捗状況の確認
+- `git-commit` — 進捗に合わせた適切なコミット実行
+- `planning-releases` — イテレーション計画の作成・更新