@k2works/claude-code-booster 1.13.0 → 2.0.0

package/lib/assets/.claude/skills/orchestrating-project/SKILL.md

@@ -1,72 +1,29 @@
 ---
 name: orchestrating-project
-description: 計画・進捗管理フェーズ全体のワークフローをオーケストレーション。リリース計画、GitHub Project 同期、進捗追跡の実行順序を案内。プロジェクト管理の開始や全体像の把握時に使用。
+description: 計画・進捗管理フェーズ全体のワークフローをオーケストレーション。リリース計画→GitHub Project 同期→進捗追跡の実行順序を案内し、イテレーションのライフサイクルを管理する。「プロジェクト管理を始めたい」「イテレーションの進め方を知りたい」「計画と GitHub を同期したい」「プロジェクトの全体像を把握したい」といった場面で発動する。計画・実行・振り返りのサイクルを標準化することで、プロジェクトの予測可能性を高める。
 ---
 
 # 計画・進捗管理オーケストレーション
 
-計画・進捗管理フェーズ全体の作業を支援します。リリース計画の策定から GitHub Project への同期、進捗追跡まで包括的なプロジェクト管理ワークフローを提供します。
+計画・進捗管理フェーズ全体のワークフローを案内する。リリース計画の策定から GitHub Project への同期、進捗追跡まで包括的なプロジェクト管理サイクルを提供する。
 
-## Instructions
+## オプション
 
-### 1. オプション
+| オプション | 説明 |
+|-----------|------|
+| なし | 計画・進捗管理フェーズ全体のワークフローを表示 |
+| `--init` | プロジェクト管理の初期セットアップ（リリース計画→GitHub 同期） |
+| `--iteration <番号>` | 特定イテレーションのライフサイクル管理（計画→実行→振り返り→報告） |
+| `--sync` | 計画ドキュメントと GitHub Project の同期 |
+| `--status` | プロジェクト全体の状態サマリーを表示 |
 
-- なし : 計画・進捗管理フェーズ全体のワークフローを表示
-- `--init` : プロジェクト管理の初期セットアップ（リリース計画作成 → GitHub 同期）
-- `--iteration <番号>` : 特定イテレーションのライフサイクル管理（計画 → 実行 → 振り返り → 報告）
-- `--sync` : 計画ドキュメントと GitHub Project の同期
-- `--status` : プロジェクト全体の状態サマリーを表示
+## フェーズの全体像
 
-### 2. 基本例
+1. **リリース計画の策定** (Skill: `planning-releases`) — スコープ・スケジュール・リソースの定義、ベロシティ管理
+2. **GitHub Project 同期** (Skill: `syncing-github-project`) — Issue 作成、カスタムフィールド設定、Milestone 管理
+3. **進捗追跡** (Skill: `tracking-progress`) — 達成度分析、品質メトリクス、ドキュメント更新
 
-```bash
-# 計画・進捗管理フェーズ全体のワークフロー表示
-# 「プロジェクト管理の全体的な進め方を説明して」
-
-# プロジェクト管理の初期セットアップ
-# --init
-# 「リリース計画を作成して GitHub Project に同期して」
-
-# イテレーション 1 のライフサイクル管理
-# --iteration 1
-# 「イテレーション 1 の計画から振り返りまで案内して」
-
-# 計画と GitHub の同期
-# --sync
-# 「リリース計画と GitHub Project を同期して」
-
-# プロジェクト全体の状態確認
-# --status
-# 「プロジェクトの現在の状態をサマリー表示して」
-```
-
-### 3. 計画・進捗管理フェーズの全体像
-
-計画・進捗管理フェーズは以下の工程で構成されます:
-
-1. **リリース計画の策定** (Skill: `planning-releases`)
-
-   - リリース計画の作成（スコープ・スケジュール・リソース）
-   - イテレーション計画の作成（2 週間の詳細計画）
-   - ベロシティ管理と予測
-   - ふりかえりの実施と記録
-   - イテレーション完了報告書の作成
-
-2. **GitHub Project 同期** (Skill: `syncing-github-project`)
-
-   - GitHub Project の作成とカスタムフィールド設定
-   - Issue の作成と Project への紐付け
-   - Milestone の作成と Issue への割り当て
-   - 計画ドキュメントと GitHub の差異確認・同期
-
-3. **進捗追跡** (Skill: `tracking-progress`)
-
-   - イテレーション達成度の分析
-   - 技術実装状況の確認
-   - 品質メトリクスの取得
-   - 進捗ドキュメントの自動更新
-
-### 4. プロジェクト管理ワークフロー
+## プロジェクト管理ワークフロー
 
 ```mermaid
 graph TD
@@ -85,49 +42,51 @@ graph TD
     K -->|なし| L[プロジェクト完了]
 ```
 
-### 5. 初期セットアップフロー（--init）
+## 初期セットアップフロー（--init）
 
-プロジェクト管理の初期セットアップを段階的に実行します:
+プロジェクト管理の初期セットアップを段階的に実行する。
 
-1. **リリース計画作成**: `planning-releases --release` でマクロ計画を策定
-2. **GitHub Project 同期**: `syncing-github-project` で GitHub に反映
-3. **イテレーション 1 計画**: `planning-releases --iteration 1` で初回イテレーション計画を作成
-4. **状態確認**: `tracking-progress --brief` で初期状態を確認
+1. **リリース計画作成**: `planning-releases --release` でマクロ計画を策定する
+2. **GitHub Project 同期**: `syncing-github-project` で GitHub に反映する
+3. **イテレーション 1 計画**: `planning-releases --iteration 1` で初回イテレーション計画を作成する
+4. **状態確認**: `tracking-progress --brief` で初期状態を確認する
 
-### 6. イテレーションライフサイクル（--iteration）
+## イテレーションライフサイクル（--iteration）
 
-各イテレーションのライフサイクルを管理します:
+各イテレーションのライフサイクルを 3 フェーズで管理する。
 
-#### 開始時
+### 開始時
 
-1. `planning-releases --iteration <N>` でイテレーション計画を作成
-2. `syncing-github-project --sync` で GitHub に反映
-3. `tracking-progress --iteration <N>` で初期状態を確認
+1. `planning-releases --iteration <N>` でイテレーション計画を作成する
+2. `syncing-github-project --sync` で GitHub に反映する
+3. `tracking-progress --iteration <N>` で初期状態を確認する
 
-#### 実行中
+### 実行中
 
-1. `tracking-progress --brief` で進捗を定期確認
-2. `syncing-github-project --status` で GitHub の状態を確認
+1. `tracking-progress --brief` で進捗を定期確認する
+2. `syncing-github-project --status` で GitHub の状態を確認する
 
-#### 終了時
+### 終了時
 
-1. `tracking-progress --update` で進捗ドキュメントを更新
-2. `planning-releases --retrospective` でふりかえりを実施
-3. `planning-releases --report` で完了報告書を作成
-4. `syncing-github-project --sync` で GitHub に最終同期
+1. `tracking-progress --update` で進捗ドキュメントを更新する
+2. `planning-releases --retrospective` でふりかえりを実施する
+3. `planning-releases --report` で完了報告書を作成する
+4. `syncing-github-project --sync` で GitHub に最終同期する
 
-### 7. 連携シナリオ
+## 途中から再開
 
-```bash
-# プロジェクト情報の確認後に計画開始
-ls -la docs/development/
-cat docs/development/release_plan.md
+プロジェクト管理の途中から再開する場合は、まず現在の状態を確認する。
 
-# GitHub Project の状態確認
-gh project list --owner <OWNER>
+**Example:**
+
+```
+ユーザー: 「イテレーション 2 の開発が終わった。振り返りをしたい」
+回答: docs/development/iteration_plan-2.md の完了状況を確認し、
+      tracking-progress --update で進捗を更新してから
+      planning-releases --retrospective でふりかえりを実施する。
 ```
 
-### 8. 出力例
+## 出力例
 
 ```
 プロジェクト管理状態
@@ -152,42 +111,24 @@ GitHub Project
 └─ ベロシティ（前回）: 10SP
 ```
 
-### 9. コンテキスト管理
-
-長時間のプロジェクト管理セッションでは Context limit reached エラーを回避するため、タスクの区切りごとに `/compact` を実施してコンテキストを圧縮する。
-
-**`/compact` を実施するタイミング**:
-
-- リリース計画・イテレーション計画の作成が完了したとき
-- GitHub Project との同期処理が完了したとき
-- 進捗追跡レポートの生成が完了したとき
-- ふりかえり・完了報告書の作成が完了したとき
-- コミット完了後、次の管理タスクに着手する前
-
-**運用ルール**:
-
-1. `/compact` 実施前に、現在の作業状態と次のタスクをメモとして出力する
-2. `/compact` 実施後、次のタスクの作業を継続する
-3. イテレーションライフサイクル管理では、各フェーズ（開始・実行中・終了）の間に `/compact` を検討する
+## コンテキスト管理
 
-### 10. 注意事項
+タスクの区切りごとに `/compact` を実施して Context limit reached エラーを回避する。
 
-- **前提条件**: 要件定義書またはユーザーストーリーが存在すること。`gh` CLI がインストールされ認証済みであること
-- **制限事項**: 初回ベロシティは推測値のため、3 イテレーション後に再調整推奨
-- **推奨事項**: リリース計画を Single Source of Truth として管理し、GitHub への同期を定期的に実施
+- リリース計画・イテレーション計画の作成完了時、GitHub 同期完了時、ふりかえり・報告書作成完了時に実施する
+- `/compact` 前に現在の作業状態と次のタスクをメモとして出力する
 
-### 11. ベストプラクティス
+## 注意事項
 
-1. **Single Source of Truth**: `docs/development/release_plan.md` を計画の正とし、GitHub は `--sync` で自動反映
-2. **定期的な同期**: イテレーション開始・終了時に GitHub との同期を実施
-3. **データドリブン**: ベロシティ実績に基づいて計画を継続的に調整
-4. **振り返りの習慣化**: 各イテレーション終了時に必ずふりかえりを実施し改善を記録
-5. **段階的詳細化**: リリース計画は概要レベル、イテレーション計画で詳細化
+- 要件定義書またはユーザーストーリーが存在すること、`gh` CLI がインストールされ認証済みであること（前提条件）
+- 初回ベロシティは推測値のため、3 イテレーション後に再調整を推奨する
+- `docs/development/release_plan.md` を Single Source of Truth として管理し、GitHub への同期を定期的に実施する
+- データドリブンにベロシティ実績に基づいて計画を継続的に調整する
 
-### 関連スキル
+## 関連スキル
 
-- `planning-releases` : リリース・イテレーション計画の作成と管理
-- `syncing-github-project` : GitHub Project への同期と一元管理
-- `tracking-progress` : 進捗分析・レポート生成
-- `orchestrating-analysis` : 分析フェーズのオーケストレーション
-- `orchestrating-development` : 開発フェーズのオーケストレーション
+- `planning-releases` — リリース・イテレーション計画の作成と管理
+- `syncing-github-project` — GitHub Project への同期と一元管理
+- `tracking-progress` — 進捗分析・レポート生成
+- `orchestrating-analysis` — 分析フェーズのオーケストレーション
+- `orchestrating-development` — 開発フェーズのオーケストレーション

package/lib/assets/.claude/skills/planning-releases/SKILL.md

@@ -1,175 +1,78 @@
 ---
 name: planning-releases
-description: アジャイルなリリース計画とイテレーション計画を作成し進捗を管理。ベロシティ分析、バーンダウンチャート、ふりかえり、完了報告書の作成。計画策定やイテレーション管理時に使用。
+description: アジャイルなリリース計画とイテレーション計画を作成し進捗を管理。ベロシティ分析、ふりかえり、完了報告書まで一貫してサポートする。「リリース計画を作りたい」「イテレーション計画を作成したい」「ベロシティを分析したい」「ふりかえりを実施したい」「完了報告書を作りたい」といった場面で発動する。計画を生きた文書として管理し、実績データに基づいて継続的に調整することで、プロジェクトの予測可能性を高める。
 ---
 
-# リリース・イテレーション計画ガイド
+# リリース・イテレーション計画
 
-アジャイルなリリース計画とイテレーション計画を作成し、プロジェクトの進捗を管理します。
+アジャイルなリリース計画とイテレーション計画を作成し、ベロシティに基づいてプロジェクトの進捗を管理する。
 
-## Instructions
+計画の価値は「正確に予測すること」ではなく「実績と計画のズレを早期に検知し調整すること」。ベロシティの安定に 3 イテレーションかかるため、初期は粗く後から精緻化する。
 
-### 1. オプション
+## オプション
 
-- なし : 全体のリリース計画を作成または更新
-- `--release` : リリース計画のみを作成（3-6 ヶ月のマクロ計画）
-- `--iteration <番号>` : 特定のイテレーション計画を作成（2 週間の詳細計画）
-- `--velocity` : ベロシティ分析と予測を実行
-- `--burndown` : バーンダウンチャートを生成
-- `--retrospective` : ふりかえり結果を記録し次イテレーション計画に反映
-- `--report` : イテレーション完了報告書を作成
-- `--status` : 現在の進捗状況をサマリー表示
+| オプション | 説明 |
+|-----------|------|
+| なし | 全体のリリース計画を作成または更新 |
+| `--release` | リリース計画のみを作成（3-6 ヶ月のマクロ計画） |
+| `--iteration <番号>` | 特定のイテレーション計画を作成（2 週間の詳細計画） |
+| `--velocity` | ベロシティ分析と予測を実行 |
+| `--burndown` | バーンダウンチャートを生成 |
+| `--retrospective` | ふりかえり結果を記録し次イテレーション計画に反映 |
+| `--report` | イテレーション完了報告書を作成 |
+| `--status` | 現在の進捗状況をサマリー表示 |
 
-### 2. 基本例
+## リリース計画の作成
 
-```bash
-# 初回のリリース計画作成
-# 「要件定義書とユーザーストーリーからリリース計画を作成して」
-
-# イテレーション 1 の詳細計画作成
-# --iteration 1
-# 「リリース計画に基づいてイテレーション 1 の詳細計画を作成して」
-
-# ふりかえり結果の反映
-# --retrospective
-# 「イテレーション 1 のふりかえり結果を記録して次の計画に反映して」
-
-# イテレーション完了報告書の作成
-# --report
-# 「最新イテレーションの完了報告書を作成して」
-```
-
-### 3. リリース計画の作成
-
-リリース・イテレーション計画ガイドに準拠した包括的なリリース計画を作成します。
+リリース・イテレーション計画ガイドに準拠した包括的なリリース計画を作成する。
 
 **テンプレート**: @docs/template/リリース計画.md
 
 **作成される内容**:
 
-- **満足条件**: スコープ・スケジュール・リソースの定義
-- **ベロシティ見積もり**: 基準ストーリー分析に基づく初期見積もり
-- **優先順位マトリックス**: 4 軸評価（金銭価値・コスト・知識習得・リスク軽減）
-- **段階的リリース戦略**: MVP → 機能拡張版 → 完成版
-- **バッファ戦略**: フィーチャバッファ 30%、スケジュールバッファ計算
-- **スケジュール概要**: mermaid.js のガントチャート
+- 満足条件（スコープ・スケジュール・リソース）
+- ベロシティ見積もり（基準ストーリー分析に基づく）
+- 優先順位マトリックス（金銭価値・コスト・知識習得・リスク軽減の 4 軸）
+- 段階的リリース戦略（MVP→機能拡張版→完成版）
+- バッファ戦略（フィーチャバッファ 30%、スケジュールバッファ）
+- mermaid.js ガントチャートによるスケジュール概要
 
-成果物は @docs/development/release_plan.md に保存する
-@docs/index.md と @mkdocs.yml を更新してドキュメントを最新にする
+成果物は `docs/development/release_plan.md` に保存する。`docs/index.md` と `mkdocs.yml` も更新する。
 
-### 4. イテレーション計画の作成
+## イテレーション計画の作成
 
-コミットメント駆動方式で実行可能な 2 週間のイテレーション計画を作成します。
+コミットメント駆動方式で実行可能な 2 週間の詳細計画を作成する。
 
 **テンプレート**: @docs/template/イテレーション計画.md
 
 **作成される内容**:
 
-- **イテレーションゴール**: 1-2 行で表現される明確な目標
-- **ストーリー選択**: リリース計画に基づく優先順位付け
-- **タスク分解**: 各ストーリーを 4-16 理想時間のタスクに分解
-- **担当者割り当て**: チームメンバーへのタスク配分
-- **詳細スケジュール**: mermaid.js ガントチャートによる視覚化
-- **コミットメント確認**: チーム全員の合意形成
-
-成果物は @docs/development/iteration_plan-N.md に保存する
-@docs/development/release_plan.md の進捗を更新する
-@docs/index.md と @mkdocs.yml を更新してドキュメントを最新にする
+- イテレーションゴール（1-2 行の明確な目標）
+- ストーリー選択（リリース計画に基づく優先順位付け）
+- タスク分解（各ストーリーを 4-16 理想時間のタスクに分解）
+- mermaid.js ガントチャートによる詳細スケジュール
 
-### 5. ベロシティ管理
+成果物は `docs/development/iteration_plan-N.md` に保存する。`release_plan.md`、`docs/index.md`、`mkdocs.yml` も更新する。
 
-チームの開発速度を継続的に測定・分析・予測します。
+## ふりかえりの実施
 
-**分析内容**:
+KPT（Keep・Problem・Try）分析を中心に、イテレーションの振り返りを記録する。
 
-- **実績ベロシティ**: 完了ストーリーポイントの集計
-- **平均ベロシティ**: 過去 3-8 イテレーションの平均
-- **予測精度**: 見積もりと実績の差分分析
-- **改善提案**: ベロシティ向上のための提案
+- **Keep**: 技術的成功事項、プロセス的成功事項
+- **Problem**: 未完了項目、見積もり精度の課題
+- **Try**: 具体的改善アクション（責任者・期限・期待効果付き）
 
-### 6. ふりかえりの実施
+成果物は `docs/development/retrospective-N.md` に保存する。`iteration_plan-N.md` と `release_plan.md` の進捗も更新する。
 
-ふりかえり結果を記録し次イテレーション計画に反映します。
-
-**作成される内容**:
-
-- **イテレーション情報**: イテレーション番号、期間、実施日、参加者、フォーマット
-- **実績サマリー**: 完了状況（計画/実績理想時間、コミット数、テスト結果、ビルド状態）、主要成果物
-- **KPT 分析**:
-    - **Keep（続けること）**: 技術的成功事項、プロセス的成功事項、チームワーク
-    - **Problem（問題点・課題）**: 未完了項目、見積もり精度の課題、プロセス課題
-    - **Try（次に試すこと）**: 具体的改善アクション（責任者、期限、内容、期待効果）
-- **次イテレーションへの引き継ぎ事項**: 必須対応事項、技術検証タスク、ドキュメント整備タスク
-- **メトリクス**: 開発メトリクス、品質メトリクス、プロセスメトリクス
-- **学び（Lessons Learned）**: 技術的学び、プロセス的学び
-
-成果物は @docs/development/retrospective-N.md に保存する
-対象のイテレーション @docs/development/iteration_plan-N.md の進捗を更新する
-@docs/development/release_plan.md の進捗を更新する
-@docs/index.md と @mkdocs.yml を更新してドキュメントを最新にする
-
-### 7. イテレーション完了報告書の作成
-
-イテレーション完了時に、実績と成果を記録する公式な完了報告書を作成します。
+## イテレーション完了報告書の作成
 
 **テンプレート**: @docs/template/イテレーション完了報告書.md
 
-**作成される内容**:
-
-- **プロジェクト概要**: 日程（開始日・終了日・作業日数）、要員（予定/実績作業日数）
-- **指標**:
-
-    - **ナイトリービルド結果**: 作業期間中の日次ビルド結果一覧
-    - **リリースバーンダウン**: 計画 vs 実績の残 SP 推移（mermaid xychart-beta）
-    - **イテレーションバーンダウン**: 日次の残 SP 推移（mermaid xychart-beta）
-    - **ベロシティ**: イテレーション別ベロシティ棒グラフ + 平均線（mermaid xychart-beta）
-
-- **実施内容と評価**:
+git log、テスト結果、イテレーション計画からデータを収集し、バーンダウンチャート・ベロシティ・品質メトリクスを含む公式な完了報告書を作成する。
 
-    - **完了ストーリー一覧**: ストーリー ID、名称、結果、予定/完了 SP
-    - **達成率**: SP・ストーリー数の計画 vs 実績
+成果物は `docs/development/iteration_report-N.md` に保存する。
 
-- **成果物詳細**: 各ストーリーの具体的な実装内容（API、UI、モデル等）
-- **品質メトリクス**:
-
-    - **テストカバレッジ**: フロントエンド・バックエンドの目標 vs 実績
-    - **テスト数**: 種類別テスト数と推移
-    - **コード品質**: ESLint/TypeScript エラー数、コミット数、追加/削除行数
-
-- **イテレーションレビュー**: 成功した点、技術的課題と解決策、アクションアイテム
-- **リリース状況**: リリース達成条件の充足状態、全体リリース進捗
-
-**データ収集方法**:
-
-- `git log` からコミット履歴・コミット数・分類を収集
-- `git diff --stat` から追加/削除行数を収集
-- 対象イテレーションの @docs/development/iteration_plan-N.md から計画情報を取得
-- 対象イテレーションの @docs/development/retrospective-N.md から KPT 分析結果を取得
-- @docs/development/release_plan.md から全体進捗を取得
-
-成果物は @docs/development/iteration_report-N.md に保存する
-@docs/development/release_plan.md の進捗を更新する
-@mkdocs.yml を更新してドキュメントを最新にする
-
-### 8. 出力例
-
-```
-リリース計画サマリー
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-リリース 1.0 MVP（8 週間）
-├─ 目標: 基本的な会議室予約機能
-├─ ストーリー: 10 個（41SP）
-├─ ベロシティ: 10-11SP/イテレーション
-└─ 進捗: 25% 完了（イテレーション 1/4 完了）
-
-ベロシティ推移
-├─ イテレーション 1: 10SP（計画通り）
-├─ 平均: 10SP
-└─ 予測: リリース 1.0 は予定通り完了見込み
-```
-
-### 9. 計画作成の流れ
+## 計画作成の流れ
 
 ```mermaid
 graph TD
@@ -183,40 +86,32 @@ graph TD
     F --> B
 ```
 
-### 10. 注意事項
-
-- **前提条件**: 要件定義書またはユーザーストーリーが存在すること
-- **制限事項**: 初回ベロシティは推測値のため、3 イテレーション後に再調整推奨
-- **推奨事項**: 各イテレーション終了時に計画を更新し、生きた文書として管理
-- 以下の記述ルールに従うこと:
-
-  - タスク項目などは一行開けて記述する
+## 途中から再開
 
-  - NG:
+既存の計画ドキュメントがある場合は、まず現在の状態を確認する。
 
-  ```markdown
-  **受入条件**:
-  - [ ] ログアウトボタンをクリックするとログアウトできる
-  ```
+**Example:**
 
-  - OK:
-
-  ```markdown
-  **受入条件**:
-
-  - [ ] ログアウトボタンをクリックするとログアウトできる
-  ```
+```
+ユーザー: 「イテレーション 1 が終わった。次の計画を作りたい」
+回答: docs/development/iteration_plan-1.md の完了状況を確認する。
+      --retrospective でふりかえりを実施し、
+      --report で完了報告書を作成してから、
+      --iteration 2 で次のイテレーション計画を作成する。
+      イテレーション 1 のベロシティ実績を反映する。
+```
 
-### 11. ベストプラクティス
+## 注意事項
 
-1. **段階的詳細化**: リリース計画は概要レベル、イテレーション計画で詳細化
-2. **継続的調整**: 実績に基づいてベロシティと計画を継続的に調整
-3. **バッファ確保**: フィーチャバッファ 30%、スケジュールバッファを必ず設定
-4. **チームコミットメント**: イテレーション計画は必ずチーム全員で合意形成
-5. **データドリブン**: 感覚ではなく実績データに基づいて計画調整
+- 要件定義書またはユーザーストーリーが存在すること（前提条件）
+- 初回ベロシティは推測値のため、3 イテレーション後に再調整を推奨する
+- 各イテレーション終了時に計画を更新し、生きた文書として管理する
+- タスク項目（リスト）の前には空行を入れる（Markdown Lint 準拠）
+- バッファ確保: フィーチャバッファ 30%、スケジュールバッファを必ず設定する
+- 感覚ではなく実績データに基づいて計画を調整する
 
-### 関連スキル
+## 関連スキル
 
-- `syncing-github-project` : GitHub Project への同期
-- `tracking-progress` : 進捗確認
-- `managing-docs` : ドキュメント管理
+- `syncing-github-project` — GitHub Project への同期
+- `tracking-progress` — 進捗確認
+- `managing-docs` — ドキュメント管理