@k2works/claude-code-booster 2.5.1 → 2.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -91,6 +91,8 @@ Claude Code をより効率的に使うための基本設定テンプレート
91
91
  | `generating-slides` | インセプションデッキから PowerPoint スライドを生成。 |
92
92
  | `git-commit` | 意味のある変更単位ごとにコミットを作成。Conventional Commits 準拠。 |
93
93
  | `creating-adr` | Architecture Decision Record の作成を支援。 |
94
+ | `creating-release-report` | リリース完了報告書を作成。release_plan・iteration_report・git log・CHANGELOG からデータ収集。 |
95
+ | `creating-iteration-report` | イテレーション完了報告書を作成。iteration_plan・release_plan・テスト結果からデータ収集。 |
94
96
 
95
97
  #### 共通
96
98
 
@@ -176,6 +178,8 @@ Claude Code をより効率的に使うための基本設定テンプレート
176
178
  │ ├── tracking-progress/SKILL.md
177
179
  │ ├── syncing-github-project/SKILL.md
178
180
  │ ├── planning-releases/SKILL.md
181
+ │ ├── creating-release-report/SKILL.md
182
+ │ ├── creating-iteration-report/SKILL.md
179
183
  │ ├── orchestrating-analysis/SKILL.md
180
184
  │ ├── orchestrating-development/SKILL.md
181
185
  │ ├── orchestrating-operation/SKILL.md
@@ -0,0 +1,210 @@
1
+ ---
2
+ name: creating-iteration-report
3
+ description: イテレーション完了報告書を作成。iteration_plan・release_plan・git log・テスト結果からデータを収集し、テンプレートに基づいて報告書を生成する。「イテレーション完了報告書を作りたい」「IT3 の報告書を作成して」「イテレーションレポートを書いて」「完了報告書を作成」「イテレーションの結果をまとめたい」といった場面で発動する。planning-releases --report が呼ばれた場合もこのスキルの手順に従う。各イテレーションの成果を定量的に記録し、ベロシティの実績データを蓄積することで計画の精度を高める。
4
+ ---
5
+
6
+ # イテレーション完了報告書の作成
7
+
8
+ イテレーション計画・リリース計画・git log・テスト結果からデータを収集し、公式な完了報告書を作成する。
9
+
10
+ 報告書の価値は「何をどれだけ達成したか」を定量的に記録すること。ベロシティ実績の蓄積はリリース計画の精度を高め、品質メトリクスの推移はプロジェクトの健全性を可視化する。
11
+
12
+ ## テンプレート
13
+
14
+ @docs/template/イテレーション完了報告書.md
15
+
16
+ ## オプション
17
+
18
+ | オプション | 説明 |
19
+ |-----------|------|
20
+ | なし | 最新のイテレーション番号を推定して報告書を作成 |
21
+ | `<番号>` | 指定番号のイテレーション完了報告書を作成 |
22
+
23
+ ## 前提条件
24
+
25
+ - `docs/development/iteration_plan-{N}.md` が存在し、タスクの完了状況が更新済みであること
26
+ - `docs/development/release_plan.md` が存在すること
27
+ - 対象イテレーションの開発が完了していること(テスト全パス)
28
+
29
+ ## 作成フロー
30
+
31
+ ```mermaid
32
+ graph TD
33
+ A[イテレーション番号の特定] --> B[データ収集]
34
+ B --> C[報告書作成]
35
+ C --> D[release_plan.md 更新]
36
+ D --> E[インデックス更新]
37
+ ```
38
+
39
+ ### Step 1: イテレーション番号の特定
40
+
41
+ 既存の `iteration_report-*.md` から最新の番号を推定する。指定がある場合はそれを使用する。
42
+
43
+ ### Step 2: データ収集
44
+
45
+ 4 つのデータソースから報告書に必要な情報を収集する。
46
+
47
+ #### 2.1 イテレーション計画(`docs/development/iteration_plan-{N}.md`)
48
+
49
+ - イテレーション番号、ゴール
50
+ - 計画期間(計画日付)
51
+ - ストーリー一覧と予定 SP
52
+ - タスクの完了状況
53
+ - 受入条件の達成状況
54
+
55
+ #### 2.2 リリース計画(`docs/development/release_plan.md`)
56
+
57
+ - 全体の SP(バーンダウン用)
58
+ - イテレーション別の計画 SP・実績 SP(前イテレーションまで)
59
+ - フェーズ別の進捗状況
60
+ - 計画スケジュール
61
+
62
+ #### 2.3 テスト結果
63
+
64
+ テストを実行して最新の結果を取得する。
65
+
66
+ ```bash
67
+ # Backend テスト
68
+ cd apps/backend && npm test 2>&1 | tail -20
69
+
70
+ # Frontend テスト
71
+ cd apps/frontend && npm test 2>&1 | tail -20
72
+
73
+ # E2E テスト
74
+ npx playwright test 2>&1 | tail -20
75
+ ```
76
+
77
+ 取得する情報:
78
+
79
+ - テストファイル数、テスト数(Backend / Frontend)
80
+ - E2E シナリオ数
81
+ - カバレッジ(利用可能な場合)
82
+
83
+ #### 2.4 前イテレーションの報告書(`docs/development/iteration_report-{N-1}.md`)
84
+
85
+ - 前イテレーションのテスト数(増分計算用)
86
+ - テスト累計推移(累計テーブル用)
87
+
88
+ ### Step 3: 報告書の作成
89
+
90
+ 以下のセクション構成で報告書を作成する。
91
+
92
+ **出力ファイル**: `docs/development/iteration_report-{N}.md`
93
+
94
+ #### セクション構成
95
+
96
+ ##### 1. プロジェクト概要
97
+
98
+ | 項目 | データソース |
99
+ |------|------------|
100
+ | イテレーション番号 | iteration_plan |
101
+ | 計画期間 | release_plan のガントチャート |
102
+ | 実績期間 | git log の実際のコミット日付 |
103
+ | ゴール | iteration_plan |
104
+ | 要員 | 計画日数 5 日、実績日数は実際の作業日数 |
105
+
106
+ ##### 2. 指標
107
+
108
+ **ベロシティテーブル**:
109
+
110
+ | 項目 | 値 |
111
+ |------|-----|
112
+ | 計画 SP | iteration_plan から |
113
+ | 実績 SP | 完了ストーリーの SP 合計 |
114
+ | 達成率 | 実績 / 計画 × 100 |
115
+
116
+ **バーンダウンチャート** (Mermaid `xychart-beta`):
117
+
118
+ - x 軸: "開始" + 全イテレーション名
119
+ - 計画線: release_plan の計画残 SP
120
+ - 実績線: 当該イテレーションまでの実績残 SP
121
+
122
+ **ベロシティチャート** (Mermaid `xychart-beta`):
123
+
124
+ - x 軸: 当該イテレーションまでの IT 名
125
+ - 棒グラフ: 各イテレーションの実績 SP
126
+ - 平均線: 実績 SP の平均値
127
+
128
+ ##### 3. テスト結果
129
+
130
+ | メトリクス | Backend | Frontend |
131
+ |-----------|---------|----------|
132
+ | テストファイル | X/X 通過 | X/X 通過 |
133
+ | テスト数 | X/X 通過 | X/X 通過 |
134
+ | カバレッジ | X% | X% |
135
+ | E2E テスト | - | X シナリオ全通過 |
136
+
137
+ **テスト増分テーブル**: 前イテレーションとの比較
138
+
139
+ **テスト累計推移テーブル**: IT1 からの累計
140
+
141
+ ##### 4. SonarQube Quality Gate(利用可能な場合)
142
+
143
+ | プロジェクト | カバレッジ | 重複率 | Violations | 結果 |
144
+ |------------|----------|--------|-----------|------|
145
+
146
+ ##### 5. 実施内容と評価
147
+
148
+ - ストーリー別の完了状況テーブル
149
+ - 各ストーリーの受入条件達成状況(チェックリスト)
150
+ - 実装内容の要約(レイヤー別: ドメイン→アプリケーション→インフラ→プレゼンテーション→フロントエンド)
151
+
152
+ ##### 6. 追加タスク(SP 外)
153
+
154
+ 技術的負債解消、XP レビュー対応、デモ環境同期など。
155
+
156
+ ##### 7. E2E テスト結果
157
+
158
+ - 新規追加分のシナリオ一覧と結果
159
+ - リグレッションテスト結果
160
+
161
+ ##### 8. フェーズ・累計進捗
162
+
163
+ - 現在のフェーズの進捗テーブル
164
+ - 全フェーズの累計進捗テーブル
165
+
166
+ ##### 9. ふりかえりへのリンク
167
+
168
+ ```markdown
169
+ 詳細は [イテレーション N ふりかえり](./retrospective-N.md) を参照。
170
+ ```
171
+
172
+ ##### 10. 更新履歴
173
+
174
+ ### Step 4: release_plan.md の更新
175
+
176
+ 報告書作成後、release_plan.md の進捗状況テーブルを更新する。
177
+
178
+ - 該当イテレーションの実績 SP・達成率・状態を更新
179
+ - バーンダウンチャートの実績線を更新
180
+
181
+ ### Step 5: インデックス更新
182
+
183
+ 1. `docs/development/index.md` — イテレーション計画テーブルの状態を更新
184
+ 2. `docs/index.md` — 開発セクションにエントリ追加(未登録の場合)
185
+ 3. `mkdocs.yml` — nav にエントリ追加(未登録の場合)
186
+
187
+ ## 途中から再開
188
+
189
+ **Example:**
190
+
191
+ ```
192
+ ユーザー: 「IT4 の完了報告書を作って」
193
+ 回答: docs/development/iteration_plan-4.md の完了状況を確認し、
194
+ テストを実行して結果を取得し、
195
+ 前イテレーション(iteration_report-3.md)からテスト推移データを収集して作成する。
196
+ ```
197
+
198
+ ## 注意事項
199
+
200
+ - テスト数・カバレッジは実測値を使用し、推測値を使わない
201
+ - Mermaid チャートの数値は release_plan.md と整合させる
202
+ - 受入条件の達成状況は iteration_plan のチェックリストと一致させる
203
+ - 前イテレーションの報告書がない場合(IT1)は、テスト増分の基準を 0 とする
204
+
205
+ ## 関連スキル
206
+
207
+ - `planning-releases` — リリース計画・イテレーション計画・ふりかえり
208
+ - `creating-release-report` — リリース完了報告書(複数イテレーションを集約)
209
+ - `tracking-progress` — 進捗分析・レポート生成
210
+ - `operating-docs` — ドキュメントインデックス更新
@@ -0,0 +1,161 @@
1
+ ---
2
+ name: creating-release-report
3
+ description: リリース完了報告書を作成。release_plan.md・iteration_report・git log・CHANGELOG・journal からデータを収集し、テンプレートに基づいて報告書を生成する。「リリース完了報告書を作りたい」「リリースレポートを作成して」「v0.1.0 の報告書を作成」「リリースの振り返りをまとめたい」「プロジェクト完了報告書を書きたい」といった場面で発動する。リリースごとの成果を定量的に可視化し、プロジェクトの透明性と説明責任を確保する。
4
+ ---
5
+
6
+ # リリース完了報告書の作成
7
+
8
+ リリース計画と開発ドキュメント群からデータを収集し、テンプレートに基づいてリリース完了報告書を作成する。
9
+
10
+ 報告書の価値は「何を達成したか」を定量的に示すこと。計画と実績の差異分析、品質メトリクス、コミットログ分析を通じて、プロジェクトの透明性を確保し、次のリリースへの知見を蓄積する。
11
+
12
+ ## テンプレート
13
+
14
+ @docs/template/リリース完了報告書.md
15
+
16
+ ## オプション
17
+
18
+ | オプション | 説明 |
19
+ |-----------|------|
20
+ | なし | 対話的にリリースバージョンを確認して報告書を作成 |
21
+ | `--version <バージョン>` | 指定バージョンのリリース完了報告書を作成 |
22
+ | `--all` | 未作成の全リリースの報告書を一括作成 |
23
+
24
+ ## 前提条件
25
+
26
+ 以下のファイルが存在すること:
27
+
28
+ - `docs/development/release_plan.md` — リリース計画(Single Source of Truth)
29
+ - `docs/development/iteration_report-{N}.md` — 対象イテレーションの完了報告書
30
+ - `CHANGELOG.md` — 対象バージョンのエントリ
31
+ - git タグ(`v{バージョン}`)が打たれていること
32
+
33
+ ## 作成フロー
34
+
35
+ ```mermaid
36
+ graph TD
37
+ A[バージョン特定] --> B[データ収集]
38
+ B --> C[ジャーナル生成]
39
+ C --> D[報告書作成]
40
+ D --> E[インデックス更新]
41
+ E --> F[完了]
42
+ ```
43
+
44
+ ### Step 1: バージョン特定
45
+
46
+ release_plan.md のリリース履歴と git タグから対象バージョンを特定する。
47
+
48
+ - リリースに含まれるイテレーション範囲を確認
49
+ - 対象ストーリーとフェーズを確認
50
+
51
+ ### Step 2: データ収集
52
+
53
+ 5 つのデータソースから報告書に必要な情報を収集する。
54
+
55
+ #### 2.1 リリース計画(`docs/development/release_plan.md`)
56
+
57
+ - プロジェクト情報(名称・目的・チーム規模)
58
+ - フェーズ別ストーリー一覧と SP
59
+ - イテレーション別の計画 SP・実績 SP・達成率
60
+ - 計画スケジュール(ガントチャート用の日付)
61
+ - リリース条件の達成状況
62
+
63
+ #### 2.2 イテレーション完了報告書(`docs/development/iteration_report-{N}.md`)
64
+
65
+ - 各イテレーションの日程(計画期間・実績期間・実績日数)
66
+ - テスト結果(Backend / Frontend / E2E のテスト数)
67
+ - テストカバレッジ
68
+ - SonarQube Quality Gate 結果
69
+ - ストーリー別の完了状況
70
+
71
+ #### 2.3 コミットログ(git)
72
+
73
+ ```bash
74
+ # 対象リリースまでのコミット数
75
+ git log --oneline --no-merges <TAG> | wc -l
76
+
77
+ # プリフィックス別内訳
78
+ git log --oneline --no-merges <TAG> --format="%s" | sed 's/(.*//' | sed 's/:.*//' | sort | uniq -c | sort -rn
79
+
80
+ # 開発期間
81
+ git log --oneline --no-merges <TAG> --format="%ai" | tail -1 # 最初のコミット
82
+ git log --oneline --no-merges <TAG> --format="%ai" | head -1 # 最後のコミット
83
+ ```
84
+
85
+ #### 2.4 CHANGELOG(`CHANGELOG.md`)
86
+
87
+ - 対象バージョンの Features / Bug Fixes / Documentation / Tests の内訳
88
+
89
+ #### 2.5 ジャーナル(`docs/journal/YYYYMMDD.md`)
90
+
91
+ - 日付ごとの詳細な作業内容
92
+
93
+ ジャーナルが未生成の場合は `npm run journal` を実行して生成する。
94
+
95
+ ### Step 3: 報告書作成
96
+
97
+ テンプレート(`docs/template/リリース完了報告書.md`)を基に、収集データでプレースホルダーを埋める。
98
+
99
+ **出力ファイル命名規則**:
100
+
101
+ ```
102
+ docs/development/release_report-{バージョン(ドットをアンダースコアに置換)}.md
103
+ ```
104
+
105
+ 例: `release_report-0_1_0.md`、`release_report-0_2_0.md`
106
+
107
+ **各セクションの作成ポイント**:
108
+
109
+ | セクション | データソース | ポイント |
110
+ |-----------|------------|---------|
111
+ | プロジェクトサマリー | release_plan.md + git log | 総コミット数・テスト数は実測値を使用 |
112
+ | イテレーション別達成状況 | release_plan.md 進捗状況テーブル | 計画 SP と実績 SP をそのまま転記 |
113
+ | 計画日程 vs 実績日数 | iteration_report-*.md | 計画期間と実績期間から短縮率を算出 |
114
+ | コミットログ分析 | git log | プリフィックス別の件数と割合を算出 |
115
+ | 品質メトリクス | iteration_report-*.md | リリース時点(最終 IT)のカバレッジを使用 |
116
+ | ベロシティ | release_plan.md | 平均・最大・最小を算出 |
117
+ | 主要な成果物 | CHANGELOG.md + user_story.md | ストーリー単位で実装内容をまとめる |
118
+ | 作業履歴 | docs/journal/ | 日付ごとの主要な作業を要約 |
119
+
120
+ **Mermaid チャート**:
121
+
122
+ - バーンダウンチャート: `xychart-beta` で計画 vs 実績の折れ線
123
+ - ガントチャート: `gantt` で計画 vs 実績のスケジュール比較
124
+ - ベロシティ: `xychart-beta` で棒グラフ + 平均線
125
+ - コミット内訳: `pie showData` でパイチャート
126
+ - テスト推移: `xychart-beta` で棒グラフ
127
+
128
+ ### Step 4: インデックス更新
129
+
130
+ 作成した報告書を以下の 3 ファイルに登録する:
131
+
132
+ 1. `docs/development/index.md` — リリース完了報告書セクションにエントリ追加
133
+ 2. `docs/index.md` — 開発セクションにエントリ追加
134
+ 3. `mkdocs.yml` — nav の開発セクションにエントリ追加
135
+
136
+ ## 途中から再開
137
+
138
+ 報告書作成の途中から再開する場合は、既存の報告書ファイルを確認する。
139
+
140
+ **Example:**
141
+
142
+ ```
143
+ ユーザー: 「v0.2.0 のリリース完了報告書を作って」
144
+ 回答: docs/development/release_report-0_2_0.md の存在を確認し、
145
+ なければ release_plan.md から IT4-5 のデータを収集して作成する。
146
+ ```
147
+
148
+ ## 注意事項
149
+
150
+ - release_plan.md を Single Source of Truth として扱い、データの不整合がある場合は release_plan.md を優先する
151
+ - コミット数・テスト数は git log や iteration_report の実測値を使用し、推測値を使わない
152
+ - Mermaid チャートの数値は必ずデータソースと照合する
153
+ - 工期短縮率の算出は「(計画日数 - 実績日数) / 計画日数 × 100」で統一する
154
+
155
+ ## 関連スキル
156
+
157
+ - `planning-releases` — リリース計画の作成と管理
158
+ - `tracking-progress` — 進捗分析・レポート生成
159
+ - `developing-release` — リリースワークフロー(品質ゲート→バージョンバンプ→タグ)
160
+ - `operating-docs` — ドキュメントインデックス更新
161
+ - `orchestrating-project` — 計画・進捗管理フェーズ全体のオーケストレーション
@@ -0,0 +1,207 @@
1
+ ---
2
+ name: developing-uiux-review
3
+ description: UI/UX 成果物のマルチパースペクティブレビューを実施。XP エージェント(インタラクションデザイナー、ユーザー代表)を並列起動し、デザイン品質・ユーザビリティ・アクセシビリティ・業務適合性・モダンデザインシステム準拠(Material Design 3 等)の観点からフィードバックを収集・統合する。「UI をレビューして」「画面設計をチェックして」「UX を評価して」「画面遷移をレビュー」「ワイヤーフレームを確認して」「デザインのフィードバックがほしい」「この画面の使い勝手を評価して」「アクセシビリティをチェック」「Material Design に準拠しているか確認して」「デザインシステムとの整合性をチェック」といった場面で発動する。UI/UX に関するレビュー依頼があれば積極的に使用すること。
4
+ ---
5
+
6
+ # UI/UX 成果物レビュー
7
+
8
+ 開発フェーズの UI/UX 成果物(画面設計、画面遷移図、ワイヤーフレーム、コンポーネント設計、フロントエンド実装など)を XP エージェントで並列レビューし、デザイン品質とユーザー価値の両面からフィードバックを統合する。
9
+
10
+ ## レビューの価値
11
+
12
+ UI/UX のレビューは見た目の良し悪しを判断する活動ではない。システムメタファーとの整合性、ユーザーの心理モデルへの適合、業務フローとの自然さ、アクセシビリティを同時に検証することで、「ユーザーの問題を本当に解決する」インターフェースを実現する。デザイナーの視点とユーザーの視点を同時に当てることで、設計者のバイアスを早期に発見できる。
13
+
14
+ 加えて、Material Design 3 をはじめとするモダンデザインシステムの原則に照らし合わせることで、業界標準のユーザー体験を担保する。ユーザーは日常的にモダンなアプリケーションに触れており、その操作感覚からの逸脱は学習コストと離脱率の上昇に直結する。
15
+
16
+ ## モダンデザイン評価基準
17
+
18
+ レビュー時に以下のモダンデザイン原則への準拠を評価する。プロジェクトが採用するデザインシステムに応じて適用する。
19
+
20
+ ### Material Design 3(M3)
21
+
22
+ - **Dynamic Color**: カラーシステムが一貫しているか、セマンティックカラー(primary / secondary / tertiary / error)の使い分けが適切か
23
+ - **Typography**: Type Scale(Display / Headline / Title / Body / Label)の使い分けが情報階層を正しく表現しているか
24
+ - **Elevation & Surface**: 要素間の階層関係が Elevation(影 / overlay)で明確に表現されているか
25
+ - **Shape**: 角丸やコンテナの形状がコンポーネントの役割を反映しているか(FAB: Full / Card: Medium / Chip: Small)
26
+ - **Motion**: アニメーションとトランジションが意味を持ち、ユーザーの注意を適切に誘導しているか
27
+ - **Adaptive Layout**: 画面サイズに応じた適応的レイアウト(Compact / Medium / Expanded)が実装されているか
28
+
29
+ ### 共通のモダンデザイン原則
30
+
31
+ - **デザイントークン**: 色・サイズ・間隔がトークンとして体系化されているか(マジックナンバーの排除)
32
+ - **コンポーネント一貫性**: 同じ役割のコンポーネントが同じ見た目・振る舞いをしているか
33
+ - **空白とリズム**: 8px グリッドシステム等のスペーシングルールに従っているか
34
+ - **ダークモード対応**: ライト / ダーク両テーマで可読性とコントラストが確保されているか
35
+ - **マイクロインタラクション**: ホバー、フォーカス、プレスなどの状態変化が明確にフィードバックされているか
36
+ - **レスポンシブデザイン**: ブレークポイントでのレイアウト切り替えが自然で情報の優先順位が保たれているか
37
+ - **空状態・ローディング・エラー状態**: 各状態が設計されており、ユーザーが次に何をすべきか分かるか
38
+
39
+ ## レビューエージェント
40
+
41
+ | エージェント | 視点 | 着眼点 |
42
+ |:---|:---|:---|
43
+ | `xp-interaction-designer` | デザイン品質 | システムメタファーとの整合、情報設計、画面遷移の論理性、レイアウト・視覚的階層、アクセシビリティ(WCAG 2.1 AA)、レスポンシブ対応、インタラクションパターンの一貫性、**モダンデザインシステムへの準拠**(Material Design 3 / デザイントークン / Adaptive Layout / Motion) |
44
+ | `xp-user-representative` | 業務適合性 | 実際の業務フローとの自然さ、操作の直感性、学習コスト、エラー時のリカバリ、業務効率、例外ケースへの対応、ユーザーが本当に求めている体験、**モダンなアプリとの操作感の一貫性**(他アプリで慣れた操作パターンとの整合) |
45
+
46
+ ## レビュー対象の判定
47
+
48
+ ユーザーのリクエストに応じてレビュー範囲を決定する。
49
+
50
+ | リクエスト | レビュー範囲 |
51
+ |:---|:---|
52
+ | 「画面設計をレビュー」 | UI 設計ドキュメント(PlantUML salt 図、画面遷移図) |
53
+ | 「コンポーネントをレビュー」 | フロントエンドコンポーネントの実装 |
54
+ | 「画面遷移をレビュー」 | 画面遷移図と遷移ロジック |
55
+ | 「UX をレビュー」 | ユーザーフロー全体(設計 + 実装) |
56
+ | 「アクセシビリティをチェック」 | WCAG 2.1 AA 準拠の観点で全体評価 |
57
+ | 「ワイヤーフレームをレビュー」 | ワイヤーフレーム / モックアップ |
58
+
59
+ ## レビューワークフロー
60
+
61
+ ### 1. レビュー対象の収集
62
+
63
+ レビュー対象の UI/UX 成果物を特定し、内容を把握する。
64
+
65
+ - 画面設計の場合: 関連する PlantUML ファイル、salt 図、画面遷移図を収集
66
+ - フロントエンド実装の場合: コンポーネントファイルとスタイルシートを収集
67
+ - 関連するユーザーストーリー、ドメインモデル、業務フローも収集する
68
+
69
+ ### 2. エージェントの並列起動
70
+
71
+ Agent ツールを使い、2 つのエージェントを **同一メッセージで並列起動** する。各エージェントには以下を指示する。
72
+
73
+ ```
74
+ あなたは {エージェント名} です。
75
+ .claude/agents/{エージェント名}.md の定義に従ってレビューしてください。
76
+
77
+ ## レビュー対象
78
+ {画面設計 / コンポーネント / 画面遷移図}
79
+
80
+ ## 関連コンテキスト
81
+ {ユーザーストーリー、業務フロー、ドメインモデル、システムメタファー}
82
+
83
+ ## レビュー観点
84
+ {エージェント固有の着眼点}
85
+
86
+ ## モダンデザイン評価基準
87
+ このスキルの「モダンデザイン評価基準」セクションに基づき、
88
+ Material Design 3 および共通のモダンデザイン原則への準拠も評価してください。
89
+
90
+ ## 出力形式
91
+ 以下の形式でフィードバックを返してください:
92
+
93
+ ### 評価サマリー
94
+ (1-2 文で全体評価)
95
+
96
+ ### 良い点
97
+ - (具体的に)
98
+
99
+ ### モダンデザイン準拠状況
100
+ - (Material Design 3 / デザイントークン / レスポンシブ等の準拠状況)
101
+
102
+ ### 改善提案
103
+ - 【重要度: 高/中/低】(対象箇所)(具体的な改善提案と理由)
104
+
105
+ ### 懸念事項
106
+ - (ユーザビリティリスク、アクセシビリティ問題、業務フローとの不整合、デザインシステムとの乖離など)
107
+
108
+ ### スコープ外の発見
109
+ - (レビュー対象外だが報告すべき問題)
110
+ ```
111
+
112
+ #### Agent ツールが利用できない場合のフォールバック
113
+
114
+ Agent ツールが利用できない環境では、2 つの視点を逐次的にシミュレートする。各エージェントの定義ファイル(`.claude/agents/{エージェント名}.md`)を読み、その視点でレビューを順次実施する。出力形式は同一のテンプレートに従う。
115
+
116
+ ### 3. フィードバックの統合
117
+
118
+ 全エージェントのフィードバックを受け取った後、以下の形式で統合レポートを作成する。
119
+
120
+ ```markdown
121
+ ## UI/UX レビュー結果
122
+
123
+ ### レビュー対象
124
+ - {画面名 / コンポーネント名 / 画面遷移}
125
+
126
+ ### 総合評価
127
+ (全エージェントの評価を統合した 2-3 文の評価)
128
+
129
+ ### モダンデザイン準拠サマリー
130
+ | 評価項目 | 状態 | 備考 |
131
+ |---|---|---|
132
+ | カラーシステム | OK / 要改善 | |
133
+ | タイポグラフィ | OK / 要改善 | |
134
+ | Elevation & Surface | OK / 要改善 | |
135
+ | コンポーネント一貫性 | OK / 要改善 | |
136
+ | スペーシング | OK / 要改善 | |
137
+ | レスポンシブ / Adaptive | OK / 要改善 | |
138
+ | ダークモード | OK / 要改善 / 未対応 | |
139
+ | 状態デザイン(空 / Loading / Error) | OK / 要改善 | |
140
+
141
+ ### 改善提案(重要度順)
142
+
143
+ #### 高(リリース前に対応すべき)
144
+ | # | 提案 | 箇所 | 指摘元 | 理由 |
145
+ |---|------|------|--------|------|
146
+
147
+ #### 中(対応推奨)
148
+ | # | 提案 | 箇所 | 指摘元 | 理由 |
149
+ |---|------|------|--------|------|
150
+
151
+ #### 低(改善の余地あり)
152
+ | # | 提案 | 箇所 | 指摘元 | 理由 |
153
+ |---|------|------|--------|------|
154
+
155
+ ### 矛盾事項
156
+
157
+ デザイナー視点とユーザー視点が相反する場合、ここに記載する。
158
+
159
+ | # | 視点 A | 視点 B | 論点 | 推奨判断 |
160
+ |---|--------|--------|------|----------|
161
+
162
+ ### エージェント別フィードバック詳細
163
+
164
+ <details>
165
+ <summary>xp-interaction-designer(高: N / 中: N / 低: N)</summary>
166
+ (フィードバック全文)
167
+ </details>
168
+
169
+ <details>
170
+ <summary>xp-user-representative(高: N / 中: N / 低: N)</summary>
171
+ (フィードバック全文)
172
+ </details>
173
+ ```
174
+
175
+ ### 4. 改善アクションの提案
176
+
177
+ 重要度「高」の指摘については具体的な改善案を提案する。
178
+
179
+ - デザイン改善: 修正後の PlantUML salt 図や画面遷移図を提示
180
+ - 実装改善: 修正後のコンポーネントコードを提示
181
+ - 改善を適用するかはユーザーの判断に委ねる
182
+
183
+ ### 5. レビュー結果の保存
184
+
185
+ 統合レポートを `docs/review/{対象名}_uiux_review_{YYYYMMDD}.md` に保存する。過去のレビュー結果と比較できるようにし、改善のトレーサビリティを確保する。
186
+
187
+ ## レビュー完了条件
188
+
189
+ 以下をすべて満たした場合にレビュー完了とする。
190
+
191
+ - 全エージェントのフィードバックが収集済み
192
+ - 統合レポートが作成済み
193
+ - 重要度「高」の指摘について対応方針(修正する / 許容する / 保留する)が決定済み
194
+ - レビュー結果がドキュメントとして保存済み
195
+
196
+ ## 注意事項
197
+
198
+ - UI/UX レビューは「ユーザーの問題を本当に解決する」インターフェースを実現するための協調的な活動
199
+ - アクセシビリティに関する指摘は重要度「高」として扱う
200
+ - デザイナー視点(理想)とユーザー視点(現実)の間にある緊張関係を活かし、より良い解を導く
201
+
202
+ ## 関連スキル
203
+
204
+ - `analyzing-ui-design` -- UI 設計(画面遷移図・salt 図の作成)
205
+ - `developing-frontend` -- フロントエンド TDD 開発
206
+ - `developing-review` -- 開発成果物の総合レビュー(コード品質中心)
207
+ - `analyzing-review` -- 分析成果物のレビュー
@@ -11,16 +11,17 @@ description: アジャイルなリリース計画とイテレーション計画
11
11
 
12
12
  ## オプション
13
13
 
14
- | オプション | 説明 |
15
- |-----------|------|
16
- | なし | 全体のリリース計画を作成または更新 |
17
- | `--release` | リリース計画のみを作成(3-6 ヶ月のマクロ計画) |
18
- | `--iteration <番号>` | 特定のイテレーション計画を作成(2 週間の詳細計画) |
19
- | `--velocity` | ベロシティ分析と予測を実行 |
20
- | `--burndown` | バーンダウンチャートを生成 |
21
- | `--retrospective` | ふりかえり結果を記録し次イテレーション計画に反映 |
22
- | `--report` | イテレーション完了報告書を作成 |
23
- | `--status` | 現在の進捗状況をサマリー表示 |
14
+ | オプション | 説明 |
15
+ |----------------------|------|
16
+ | なし | 全体のリリース計画を作成または更新 |
17
+ | `--release` | リリース計画のみを作成(3-6 ヶ月のマクロ計画) |
18
+ | `--iteration <番号>` | 特定のイテレーション計画を作成(2 週間の詳細計画) |
19
+ | `--velocity` | ベロシティ分析と予測を実行 |
20
+ | `--burndown` | バーンダウンチャートを生成 |
21
+ | `--retrospective` | ふりかえり結果を記録し次イテレーション計画に反映 |
22
+ | `--iteration-report` | イテレーション完了報告書を作成(`creating-iteration-report` に委譲) |
23
+ | `--release-report` | リリース完了報告書を作成(`creating-release-report` に委譲) |
24
+ | `--status` | 現在の進捗状況をサマリー表示 |
24
25
 
25
26
  ## リリース計画の作成
26
27
 
@@ -64,13 +65,12 @@ KPT(Keep・Problem・Try)分析を中心に、イテレーションの振り
64
65
 
65
66
  成果物は `docs/development/retrospective-N.md` に保存する。`iteration_plan-N.md` と `release_plan.md` の進捗も更新する。
66
67
 
67
- ## イテレーション完了報告書の作成
68
+ ## 完了報告書の作成
68
69
 
69
- **テンプレート**: @docs/template/イテレーション完了報告書.md
70
+ 報告書の作成は専用スキルに委譲する。
70
71
 
71
- git log、テスト結果、イテレーション計画からデータを収集し、バーンダウンチャート・ベロシティ・品質メトリクスを含む公式な完了報告書を作成する。
72
-
73
- 成果物は `docs/development/iteration_report-N.md` に保存する。
72
+ - **イテレーション完了報告書**(`--report`): `creating-iteration-report` スキルを参照
73
+ - **リリース完了報告書**: `creating-release-report` スキルを参照
74
74
 
75
75
  ## 計画作成の流れ
76
76
 
@@ -112,6 +112,8 @@ graph TD
112
112
 
113
113
  ## 関連スキル
114
114
 
115
+ - `creating-iteration-report` — イテレーション完了報告書の作成
116
+ - `creating-release-report` — リリース完了報告書の作成
115
117
  - `syncing-github-project` — GitHub Project への同期
116
118
  - `tracking-progress` — 進捗確認
117
- - `managing-docs` — ドキュメント管理
119
+ - `operating-docs` — ドキュメント管理
@@ -55,6 +55,7 @@
55
55
  | :--- | :--- |
56
56
  | `analyzing-review` | 分析成果物のマルチパースペクティブレビュー |
57
57
  | `developing-review` | 開発成果物のマルチパースペクティブレビュー |
58
+ | `developing-uiux-review` | UI/UX 成果物のマルチパースペクティブレビュー |
58
59
  | `operating-review` | 運用成果物のマルチパースペクティブレビュー |
59
60
 
60
61
  ### 計画・進捗
@@ -86,6 +87,8 @@
86
87
  | `generating-slides` | インセプションデッキのスライド生成 |
87
88
  | `git-commit` | Conventional Commits 準拠のコミット |
88
89
  | `creating-adr` | ADR 作成 |
90
+ | `creating-release-report` | リリース完了報告書作成 |
91
+ | `creating-iteration-report` | イテレーション完了報告書作成 |
89
92
 
90
93
  ### 共通
91
94
 
@@ -14,4 +14,5 @@
14
14
  - [イテレーション計画](./イテレーション計画.md)
15
15
  - [イテレーション完了報告書](./イテレーション完了報告書.md)
16
16
  - [リリース計画](./リリース計画.md)
17
+ - [リリース完了報告書](./リリース完了報告書.md)
17
18
  - [README](./README.md)
@@ -0,0 +1,273 @@
1
+ # リリース完了報告書 {{バージョン}} - {{プロジェクト名}}
2
+
3
+ **報告書作成日**: {{YYYY-MM-DD}}
4
+
5
+ ## 概要
6
+
7
+ {{プロジェクト名}} v{{バージョン}} のリリース完了報告書です。全 {{イテレーション数}} イテレーション、{{総 SP}} ストーリーポイントを {{達成率}}% 達成し、{{完了状態の説明}}。
8
+
9
+ ---
10
+
11
+ ## プロジェクトサマリー
12
+
13
+ | 項目 | 値 |
14
+ |------|-----|
15
+ | **プロジェクト期間** | {{開始日}} 〜 {{終了日}} (約 {{期間}} 週間) |
16
+ | **総イテレーション数** | {{イテレーション数}} |
17
+ | **総ストーリーポイント** | {{総 SP}} SP |
18
+ | **総コミット数** | {{コミット数}} |
19
+ | **総テスト数** | {{テスト数}} |
20
+ | **ユーザーストーリー数** | {{ストーリー数}} |
21
+
22
+ ---
23
+
24
+ ## 計画と実績の差異分析
25
+
26
+ ### イテレーション別達成状況
27
+
28
+ | イテレーション | リリース | 計画 SP | 実績 SP | 達成率 | 差異 |
29
+ |---------------|---------|---------|---------|--------|------|
30
+ | IT1 | {{リリース名}} | {{計画 SP}} | {{実績 SP}} | {{達成率}}% | {{差異}} |
31
+ | IT2 | {{リリース名}} | {{計画 SP}} | {{実績 SP}} | {{達成率}}% | {{差異}} |
32
+ | ... | | | | | |
33
+ | **合計** | | **{{計画合計}}** | **{{実績合計}}** | **{{全体達成率}}%** | **{{全体差異}}** |
34
+
35
+ ### リリース別達成状況
36
+
37
+ | リリース | 内容 | 計画 SP | 実績 SP | 達成率 |
38
+ |---------|------|---------|---------|--------|
39
+ | Release {{X}}.0 {{名称}} | {{内容}} | {{計画 SP}} | {{実績 SP}} | {{達成率}}% |
40
+ | ... | | | | |
41
+
42
+ ### リリースバーンダウン
43
+
44
+ ```mermaid
45
+ xychart-beta
46
+ title "リリースバーンダウン(計画 vs 実績)"
47
+ x-axis ["開始", "IT1", "IT2", "..."]
48
+ y-axis "残 SP" 0 --> {{総 SP}}
49
+ line "計画" [{{計画値のカンマ区切り}}]
50
+ line "実績" [{{実績値のカンマ区切り}}]
51
+ ```
52
+
53
+ **分析結果**: {{バーンダウンの傾向分析}}
54
+
55
+ ---
56
+
57
+ ## 計画日程 vs 実績日数の差異分析
58
+
59
+ ### イテレーション別日程比較
60
+
61
+ | IT | 計画期間 | 計画日数 | 実績期間 | 実績日数 | 短縮日数 | 短縮率 |
62
+ |----|---------|---------|----------|---------|---------|--------|
63
+ | 1 | {{計画期間}} | {{計画日数}} 日 | {{実績期間}} | **{{実績日数}} 日** | {{短縮日数}} 日 | {{短縮率}}% |
64
+ | ... | | | | | | |
65
+ | **合計** | **{{計画総期間}}** | **{{計画総日数}} 日** | **{{実績総期間}}** | **{{実績総日数}} 日** | **{{短縮合計}} 日** | **{{短縮率合計}}%** |
66
+
67
+ ### 工期短縮の可視化
68
+
69
+ ```mermaid
70
+ xychart-beta
71
+ title "計画日数 vs 実績日数"
72
+ x-axis ["IT1", "IT2", "..."]
73
+ y-axis "日数" 0 --> {{最大日数}}
74
+ bar "計画" [{{計画日数のカンマ区切り}}]
75
+ bar "実績" [{{実績日数のカンマ区切り}}]
76
+ ```
77
+
78
+ ### 計画 vs 実績ガントチャート
79
+
80
+ #### 当初計画スケジュール
81
+
82
+ ```mermaid
83
+ gantt
84
+ title 当初計画スケジュール
85
+ dateFormat YYYY-MM-DD
86
+
87
+ section Release {{X}}.0
88
+ IT1 {{ゴール}} :p1, {{開始日}}, {{日数}}d
89
+ IT2 {{ゴール}} :p2, after p1, {{日数}}d
90
+ ```
91
+
92
+ #### 実績スケジュール
93
+
94
+ ```mermaid
95
+ gantt
96
+ title 実績スケジュール
97
+ dateFormat YYYY-MM-DD
98
+
99
+ section Release {{X}}.0
100
+ IT1 {{ゴール}} ({{日数}}日) :done, a1, {{開始日}}, {{日数}}d
101
+ IT2 {{ゴール}} ({{日数}}日) :done, a2, {{開始日}}, {{日数}}d
102
+ リリース {{X}}.0 :milestone, m1, {{日付}}, 0d
103
+ ```
104
+
105
+ ### サマリー
106
+
107
+ | 指標 | 値 |
108
+ |------|-----|
109
+ | **計画総日数** | {{計画総日数}} 日 |
110
+ | **実績総日数** | {{実績総日数}} 日 |
111
+ | **短縮日数** | {{短縮日数}} 日 |
112
+ | **短縮率** | **{{短縮率}}%** |
113
+ | **効率倍率** | **{{効率倍率}} 倍** |
114
+
115
+ ### 差異分析
116
+
117
+ 1. {{差異分析ポイント 1}}
118
+ 2. {{差異分析ポイント 2}}
119
+ 3. {{差異分析ポイント 3}}
120
+
121
+ ### 工期短縮の要因分析
122
+
123
+ | 要因 | 説明 |
124
+ |------|------|
125
+ | {{要因 1}} | {{説明}} |
126
+ | {{要因 2}} | {{説明}} |
127
+
128
+ ---
129
+
130
+ ## コミットログ分析
131
+
132
+ ### コミットプリフィックス別内訳
133
+
134
+ | プリフィックス | 件数 | 割合 | 説明 |
135
+ |---------------|------|------|------|
136
+ | docs | {{件数}} | {{割合}}% | ドキュメント更新 |
137
+ | feat | {{件数}} | {{割合}}% | 新機能追加 |
138
+ | fix | {{件数}} | {{割合}}% | バグ修正 |
139
+ | refactor | {{件数}} | {{割合}}% | リファクタリング |
140
+ | test | {{件数}} | {{割合}}% | テスト追加 |
141
+ | chore | {{件数}} | {{割合}}% | 保守作業 |
142
+ | ci | {{件数}} | {{割合}}% | CI/CD 改善 |
143
+ | その他 | {{件数}} | {{割合}}% | マージ・リバート等 |
144
+ | **合計** | **{{合計}}** | **100%** | |
145
+
146
+ ### コミットプリフィックス別パイチャート
147
+
148
+ ```mermaid
149
+ pie showData
150
+ title "コミットプリフィックス別内訳"
151
+ "docs (ドキュメント)" : {{件数}}
152
+ "feat (新機能)" : {{件数}}
153
+ "fix (バグ修正)" : {{件数}}
154
+ "refactor (リファクタ)" : {{件数}}
155
+ "test (テスト)" : {{件数}}
156
+ "chore (保守)" : {{件数}}
157
+ "その他" : {{件数}}
158
+ ```
159
+
160
+ ### 分析
161
+
162
+ 1. {{コミット分析ポイント 1}}
163
+ 2. {{コミット分析ポイント 2}}
164
+ 3. {{コミット分析ポイント 3}}
165
+
166
+ ---
167
+
168
+ ## 品質メトリクス
169
+
170
+ ### テストカバレッジ
171
+
172
+ | 対象 | 目標 | 実績 | 判定 |
173
+ |------|------|------|------|
174
+ | バックエンド | {{目標}}% | {{実績}}% | {{判定}} |
175
+ | フロントエンド | {{目標}}% | {{実績}}% | {{判定}} |
176
+
177
+ ### テスト数のリリース別推移
178
+
179
+ | リリース | バックエンド | フロントエンド | E2E | 合計 |
180
+ |---------|------------|--------------|-----|------|
181
+ | Release {{X}}.0 | {{件数}} | {{件数}} | {{件数}} | {{合計}} |
182
+ | ... | | | | |
183
+
184
+ ```mermaid
185
+ xychart-beta
186
+ title "テスト数のリリース別推移"
187
+ x-axis ["Release {{X}}.0", "..."]
188
+ y-axis "テスト数" 0 --> {{最大値}}
189
+ bar [{{テスト数のカンマ区切り}}]
190
+ ```
191
+
192
+ ### 静的解析
193
+
194
+ | 指標 | 結果 |
195
+ |------|------|
196
+ | ESLint | {{結果}} |
197
+ | SonarQube BLOCKER | {{結果}} |
198
+ | Flaky テスト率 | {{結果}} |
199
+
200
+ ### ベロシティ
201
+
202
+ ```mermaid
203
+ xychart-beta
204
+ title "イテレーション別ベロシティ"
205
+ x-axis ["IT1", "IT2", "..."]
206
+ y-axis "完了したストーリーポイント" 0 --> {{最大 SP}}
207
+ bar [{{実績 SP のカンマ区切り}}]
208
+ line "平均({{平均}} SP)" [{{平均値の繰り返し}}]
209
+ ```
210
+
211
+ | 項目 | 値 |
212
+ |------|-----|
213
+ | 平均ベロシティ | {{平均}} SP/イテレーション |
214
+ | 最大ベロシティ | {{最大}} SP |
215
+ | 最小ベロシティ | {{最小}} SP |
216
+
217
+ ---
218
+
219
+ ## リリース履歴
220
+
221
+ | リリース | 含まれる IT | リリース日 | SP | 状態 |
222
+ |---------|-----------|-----------|-----|------|
223
+ | Release {{X}}.0 {{名称}} | IT{{開始}}-{{終了}} | {{日付}} | {{SP}} | {{状態}} |
224
+ | ... | | | | |
225
+
226
+ ---
227
+
228
+ ## 主要な成果物
229
+
230
+ ### 実装した主要機能
231
+
232
+ 1. **{{機能カテゴリ 1}}** ({{リリース}} / {{IT}})
233
+ - {{機能詳細}}
234
+
235
+ 2. **{{機能カテゴリ 2}}** ({{リリース}} / {{IT}})
236
+ - {{機能詳細}}
237
+
238
+ ### 技術的成果
239
+
240
+ | 成果 | 内容 |
241
+ |------|------|
242
+ | テスト駆動開発 | {{テスト数}}テスト、カバレッジ {{カバレッジ}}% |
243
+ | {{アーキテクチャ}} | {{説明}} |
244
+ | CI/CD | {{説明}} |
245
+
246
+ ---
247
+
248
+ ## 総評
249
+
250
+ {{プロジェクト名}} v{{バージョン}} は、全 {{総 SP}} SP を {{イテレーション数}} イテレーションで {{達成率}}% 達成し、{{完了状態}}。
251
+
252
+ ### ハイライト
253
+
254
+ - **全 {{ストーリー数}} ユーザーストーリー完了**: {{概要}}
255
+ - **{{テスト数}} テストによる品質保証**: バックエンド {{BE テスト数}} + フロントエンド {{FE テスト数}} + E2E {{E2E テスト数}}
256
+ - **{{カバレッジ}}% テストカバレッジ**: 目標 {{目標}}% を上回る品質水準
257
+ - **{{リリース回数}} 段階リリース戦略の成功**: {{リリース戦略の説明}}
258
+
259
+ ### プロジェクト完了メトリクス
260
+
261
+ | 指標 | 値 |
262
+ |------|-----|
263
+ | **総ストーリーポイント** | {{総 SP}} SP |
264
+ | **総コミット数** | {{コミット数}} |
265
+ | **総テスト数** | {{テスト数}} |
266
+ | **テストカバレッジ** | {{カバレッジ}}% |
267
+ | **リリース回数** | {{リリース回数}} |
268
+ | **イテレーション回数** | {{イテレーション数}} |
269
+ | **ユーザーストーリー数** | {{ストーリー数}} |
270
+
271
+ ---
272
+
273
+ **リリース完了** - Simple made easy.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@k2works/claude-code-booster",
3
- "version": "2.5.1",
3
+ "version": "2.7.0",
4
4
  "description": "AI Agent Development Support Tool",
5
5
  "main": "main.js",
6
6
  "bin": {