@k2works/claude-code-booster 2.5.1 → 2.6.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.
- package/lib/assets/.claude/README.md +4 -0
- package/lib/assets/.claude/skills/creating-iteration-report/SKILL.md +210 -0
- package/lib/assets/.claude/skills/creating-release-report/SKILL.md +161 -0
- package/lib/assets/.claude/skills/planning-releases/SKILL.md +18 -16
- package/lib/assets/CLAUDE.md +2 -0
- package/lib/assets/docs/template/index.md +1 -0
- package/lib/assets/docs/template//343/203/252/343/203/252/343/203/274/343/202/271/345/256/214/344/272/206/345/240/261/345/221/212/346/233/270.md +273 -0
- package/package.json +1 -1
|
@@ -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` — 計画・進捗管理フェーズ全体のオーケストレーション
|
|
@@ -11,16 +11,17 @@ description: アジャイルなリリース計画とイテレーション計画
|
|
|
11
11
|
|
|
12
12
|
## オプション
|
|
13
13
|
|
|
14
|
-
| オプション
|
|
15
|
-
|
|
16
|
-
| なし
|
|
17
|
-
| `--release`
|
|
18
|
-
| `--iteration <番号>`
|
|
19
|
-
| `--velocity`
|
|
20
|
-
| `--burndown`
|
|
21
|
-
| `--retrospective`
|
|
22
|
-
| `--report` |
|
|
23
|
-
| `--
|
|
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
|
-
|
|
70
|
+
報告書の作成は専用スキルに委譲する。
|
|
70
71
|
|
|
71
|
-
|
|
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
|
-
- `
|
|
119
|
+
- `operating-docs` — ドキュメント管理
|
package/lib/assets/CLAUDE.md
CHANGED
|
@@ -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.
|