@k2works/claude-code-booster 0.22.0 → 1.0.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 +96 -80
- package/lib/assets/.claude/SKILLS_TEMPLATE.md +100 -0
- package/lib/assets/.claude/settings.local.json +2 -8
- package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +87 -0
- package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +80 -0
- package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +88 -0
- package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +91 -0
- package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +91 -0
- package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +87 -0
- package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +102 -0
- package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +87 -0
- package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +86 -0
- package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +87 -0
- package/lib/assets/.claude/skills/creating-adr/SKILL.md +115 -0
- package/lib/assets/.claude/skills/developing-backend/SKILL.md +89 -0
- package/lib/assets/.claude/skills/developing-frontend/SKILL.md +79 -0
- package/lib/assets/.claude/skills/killing-processes/SKILL.md +98 -0
- package/lib/assets/.claude/skills/managing-docs/SKILL.md +195 -0
- package/lib/assets/.claude/skills/managing-operations/DEPLOY.md +77 -0
- package/lib/assets/.claude/skills/managing-operations/SETUP_CSHARP.md +80 -0
- package/lib/assets/.claude/skills/managing-operations/SETUP_FRONTEND.md +84 -0
- package/lib/assets/.claude/skills/managing-operations/SETUP_JAVA.md +75 -0
- package/lib/assets/.claude/skills/managing-operations/SKILL.md +156 -0
- package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +103 -0
- package/lib/assets/.claude/{commands/dev.md → skills/orchestrating-development/SKILL.md} +42 -49
- package/lib/assets/.claude/skills/planning-releases/SKILL.md +222 -0
- package/lib/assets/.claude/{commands/plan-github.md → skills/syncing-github-project/SKILL.md} +78 -159
- package/lib/assets/.claude/skills/tracking-progress/SKILL.md +164 -0
- package/lib/assets/.mcp.json +12 -0
- package/lib/assets/CLAUDE.md +71 -230
- package/lib/assets/README.md +38 -3
- package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/202/254/343/202/244/343/203/211.md +442 -0
- package/lib/assets/docs/reference//350/250/200/350/252/236/345/210/245/351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +8 -7
- package/lib/assets/docs/template//343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/350/250/210/347/224/273.md +205 -0
- package/lib/assets/docs/template//343/203/252/343/203/252/343/203/274/343/202/271/350/250/210/347/224/273.md +280 -0
- package/lib/assets/ops/scripts/mkdocs.js +71 -105
- package/lib/assets/ops/scripts/release.js +431 -0
- package/lib/assets/ops/scripts/ssh.js +190 -0
- package/package.json +1 -1
- package/lib/assets/.claude/.mcp.json +0 -45
- package/lib/assets/.claude/COMMAND_TEMPLATE.md +0 -122
- package/lib/assets/.claude/commands/adr.md +0 -177
- package/lib/assets/.claude/commands/analysis-architecture.md +0 -98
- package/lib/assets/.claude/commands/analysis-data-model.md +0 -94
- package/lib/assets/.claude/commands/analysis-domain-model.md +0 -101
- package/lib/assets/.claude/commands/analysis-non-functional.md +0 -103
- package/lib/assets/.claude/commands/analysis-operation.md +0 -104
- package/lib/assets/.claude/commands/analysis-requirements.md +0 -100
- package/lib/assets/.claude/commands/analysis-tech-stack.md +0 -113
- package/lib/assets/.claude/commands/analysis-test-strategy.md +0 -101
- package/lib/assets/.claude/commands/analysis-ui-design.md +0 -100
- package/lib/assets/.claude/commands/analysis-usecases.md +0 -100
- package/lib/assets/.claude/commands/analysis.md +0 -103
- package/lib/assets/.claude/commands/dev-backend.md +0 -144
- package/lib/assets/.claude/commands/dev-frontend.md +0 -126
- package/lib/assets/.claude/commands/docs.md +0 -335
- package/lib/assets/.claude/commands/git-commit.md +0 -47
- package/lib/assets/.claude/commands/kill.md +0 -109
- package/lib/assets/.claude/commands/ops.md +0 -508
- package/lib/assets/.claude/commands/plan.md +0 -238
- package/lib/assets/.claude/commands/progress.md +0 -245
package/lib/assets/.claude/{commands/plan-github.md → skills/syncing-github-project/SKILL.md}
RENAMED
|
@@ -1,16 +1,17 @@
|
|
|
1
|
-
|
|
1
|
+
---
|
|
2
|
+
name: syncing-github-project
|
|
3
|
+
description: リリース計画を GitHub Project・Issue・Milestone に反映し同期。GitHub でのプロジェクト管理一元化時に使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# GitHub Project 同期ガイド
|
|
2
7
|
|
|
3
8
|
リリース計画を GitHub Project・Issue・Milestone に反映し、プロジェクト管理を GitHub 上で一元化します。
|
|
4
9
|
|
|
5
|
-
|
|
10
|
+
## Instructions
|
|
6
11
|
|
|
7
|
-
|
|
8
|
-
/plan-github [オプション]
|
|
9
|
-
```
|
|
12
|
+
### 1. オプション
|
|
10
13
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
- なし : 全体の同期を実行(Project作成、Issue作成、フィールド設定、Milestone作成)
|
|
14
|
+
- なし : 全体の同期を実行(Project 作成、Issue 作成、フィールド設定、Milestone 作成)
|
|
14
15
|
- `--project` : GitHub Project のみを作成
|
|
15
16
|
- `--issues` : Issue のみを作成(Project が存在する前提)
|
|
16
17
|
- `--fields` : 各 Issue に対して Project フィールド値を個別に設定(リリース、イテレーション、優先度、SP、カテゴリ、Status)
|
|
@@ -18,29 +19,22 @@
|
|
|
18
19
|
- `--sync` : release_plan.md と GitHub の差異を確認し、差異があれば同期を実行
|
|
19
20
|
- `--status` : 現在の GitHub Project 状態を表示
|
|
20
21
|
|
|
21
|
-
### 基本例
|
|
22
|
+
### 2. 基本例
|
|
22
23
|
|
|
23
24
|
```bash
|
|
24
25
|
# 初回の完全同期(Project、Issue、Milestone すべて作成)
|
|
25
|
-
|
|
26
|
-
「リリース計画を GitHub Project に反映して」
|
|
27
|
-
|
|
28
|
-
# GitHub Project のみ作成
|
|
29
|
-
/plan-github --project
|
|
30
|
-
「GitHub Project を作成して」
|
|
26
|
+
# 「リリース計画を GitHub Project に反映して」
|
|
31
27
|
|
|
32
28
|
# 差異確認と同期
|
|
33
|
-
|
|
34
|
-
「release_plan.md と GitHub の差異を確認して同期して」
|
|
29
|
+
# --sync
|
|
30
|
+
# 「release_plan.md と GitHub の差異を確認して同期して」
|
|
35
31
|
|
|
36
32
|
# 現在の状態確認
|
|
37
|
-
|
|
38
|
-
「GitHub Project の現在の状態を表示して」
|
|
33
|
+
# --status
|
|
34
|
+
# 「GitHub Project の現在の状態を表示して」
|
|
39
35
|
```
|
|
40
36
|
|
|
41
|
-
###
|
|
42
|
-
|
|
43
|
-
#### GitHub Project の作成
|
|
37
|
+
### 3. GitHub Project の作成
|
|
44
38
|
|
|
45
39
|
release_plan.md に基づいて GitHub Project を作成し、カスタムフィールドを設定します。
|
|
46
40
|
|
|
@@ -52,13 +46,7 @@ release_plan.md に基づいて GitHub Project を作成し、カスタムフィ
|
|
|
52
46
|
- **SP**: ストーリーポイント(数値)
|
|
53
47
|
- **カテゴリ**: 認証・ユーザー管理 / マスタ管理 / 仕訳管理 / 元帳・残高管理 / 財務諸表 / システム管理
|
|
54
48
|
|
|
55
|
-
|
|
56
|
-
# GitHub Project の作成
|
|
57
|
-
/plan-github --project
|
|
58
|
-
「カスタムフィールド付きの GitHub Project を作成して」
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
#### Issue の作成
|
|
49
|
+
### 4. Issue の作成
|
|
62
50
|
|
|
63
51
|
ユーザーストーリーを GitHub Issue として作成し、Project に追加します。
|
|
64
52
|
|
|
@@ -68,30 +56,27 @@ release_plan.md に基づいて GitHub Project を作成し、カスタムフィ
|
|
|
68
56
|
- **本文**: ユーザーストーリー、受け入れ基準、見積もり情報
|
|
69
57
|
- **Project 紐付け**: 作成した Project に自動追加
|
|
70
58
|
|
|
71
|
-
|
|
72
|
-
# Issue の作成と Project への追加
|
|
73
|
-
/plan-github --issues
|
|
74
|
-
「ユーザーストーリーを Issue として作成して Project に追加して」
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
#### フィールド値の設定
|
|
59
|
+
### 5. フィールド値の設定
|
|
78
60
|
|
|
79
61
|
各 Issue に対して Project のカスタムフィールド値を個別に設定します。
|
|
80
62
|
|
|
81
63
|
**設定手順**:
|
|
82
64
|
|
|
83
65
|
1. **フィールド ID とオプション ID の取得**
|
|
66
|
+
|
|
84
67
|
```bash
|
|
85
68
|
gh project field-list <PROJECT_NUMBER> --owner <OWNER> --format json
|
|
86
69
|
```
|
|
87
70
|
|
|
88
71
|
2. **Project Item ID の取得**
|
|
72
|
+
|
|
89
73
|
```bash
|
|
90
74
|
gh project item-list <PROJECT_NUMBER> --owner <OWNER> --format json --limit 50 \
|
|
91
75
|
| jq -r '.items[] | "\(.content.number):\(.id)"'
|
|
92
76
|
```
|
|
93
77
|
|
|
94
78
|
3. **各 Issue にフィールド値を設定**
|
|
79
|
+
|
|
95
80
|
```bash
|
|
96
81
|
# Single Select フィールド(リリース、イテレーション、優先度、カテゴリ、Status)
|
|
97
82
|
gh project item-edit --project-id <PROJECT_ID> --id <ITEM_ID> \
|
|
@@ -107,7 +92,7 @@ release_plan.md に基づいて GitHub Project を作成し、カスタムフィ
|
|
|
107
92
|
| フィールド | タイプ | 設定内容 |
|
|
108
93
|
|-----------|--------|---------|
|
|
109
94
|
| **リリース** | Single Select | Release 1.0 MVP Alpha / 1.1 MVP Beta / 1.2 MVP / 2.0 完成版 |
|
|
110
|
-
| **イテレーション** | **Iteration** | IT-1 〜 IT-6(2週間スプリント) |
|
|
95
|
+
| **イテレーション** | **Iteration** | IT-1 〜 IT-6(2 週間スプリント) |
|
|
111
96
|
| **優先度** | Single Select | 必須 / 中 / 低 |
|
|
112
97
|
| **SP** | Number | ストーリーポイント(2〜5) |
|
|
113
98
|
| **カテゴリ** | Single Select | 認証 / お知らせ / 社員名簿 / カレンダー / 規定集 / マニュアル / ツール / 問い合わせ / 申請 / 承認 / ユーザー管理 |
|
|
@@ -118,7 +103,6 @@ release_plan.md に基づいて GitHub Project を作成し、カスタムフィ
|
|
|
118
103
|
イテレーションフィールドは `gh project field-create` では作成できないため、GraphQL API を使用します:
|
|
119
104
|
|
|
120
105
|
```bash
|
|
121
|
-
# Iteration タイプでフィールドを作成
|
|
122
106
|
gh api graphql -f query='
|
|
123
107
|
mutation {
|
|
124
108
|
createProjectV2Field(input: {
|
|
@@ -138,56 +122,15 @@ mutation {
|
|
|
138
122
|
```
|
|
139
123
|
|
|
140
124
|
**注意**: Iteration フィールドの期間設定(開始日、スプリント期間)は GitHub Web UI から設定する必要があります:
|
|
141
|
-
1. Project Settings → 「イテレーション」フィールド → 設定
|
|
142
|
-
2. 各イテレーション(IT-1〜IT-6)を追加し、開始日と期間(14日)を設定
|
|
143
|
-
|
|
144
|
-
**設定例**:
|
|
145
|
-
|
|
146
|
-
```bash
|
|
147
|
-
# Issue #1 にフィールド値を設定
|
|
148
|
-
PROJECT_ID="PVT_kwDOBz-FwM4BNAQ9"
|
|
149
|
-
ITEM_ID="PVTI_lADOBz-FwM4BNAQ9zgj6ixU"
|
|
150
125
|
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
--field-id PVTSSF_xxx --single-select-option-id 32cce308
|
|
154
|
-
|
|
155
|
-
# イテレーション: IT-1(Iteration フィールドの場合)
|
|
156
|
-
gh project item-edit --project-id $PROJECT_ID --id $ITEM_ID \
|
|
157
|
-
--field-id PVTIF_xxx --iteration-id <ITERATION_ID>
|
|
158
|
-
|
|
159
|
-
# SP: 5
|
|
160
|
-
gh project item-edit --project-id $PROJECT_ID --id $ITEM_ID \
|
|
161
|
-
--field-id PVTF_xxx --number 5
|
|
162
|
-
|
|
163
|
-
# Status: Done
|
|
164
|
-
gh project item-edit --project-id $PROJECT_ID --id $ITEM_ID \
|
|
165
|
-
--field-id PVTSSF_xxx --single-select-option-id 98236657
|
|
166
|
-
```
|
|
167
|
-
|
|
168
|
-
```bash
|
|
169
|
-
# フィールド値の一括設定
|
|
170
|
-
/plan-github --fields
|
|
171
|
-
「release_plan.md の内容で各 Issue のフィールド値を個別に設定して」
|
|
172
|
-
```
|
|
126
|
+
1. Project Settings → 「イテレーション」フィールド → 設定
|
|
127
|
+
2. 各イテレーション(IT-1〜IT-6)を追加し、開始日と期間(14 日)を設定
|
|
173
128
|
|
|
174
|
-
|
|
129
|
+
### 6. Milestone の作成
|
|
175
130
|
|
|
176
131
|
リリースを GitHub Milestone として作成し、Issue に割り当てます。
|
|
177
132
|
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
- **リリース 1.0 MVP**: 基本的な仕訳入力と元帳管理
|
|
181
|
-
- **リリース 2.0 機能拡張版**: 承認ワークフローと財務諸表
|
|
182
|
-
- **リリース 3.0 完成版**: 高度な分析機能とシステム管理
|
|
183
|
-
|
|
184
|
-
```bash
|
|
185
|
-
# Milestone の作成と Issue 割り当て
|
|
186
|
-
/plan-github --milestones
|
|
187
|
-
「リリースを Milestone として作成して Issue に割り当てて」
|
|
188
|
-
```
|
|
189
|
-
|
|
190
|
-
#### 差異確認と同期
|
|
133
|
+
### 7. 差異確認と同期
|
|
191
134
|
|
|
192
135
|
release_plan.md と GitHub Issue/Project の整合性を確認し、差異があれば同期を実行します。
|
|
193
136
|
|
|
@@ -209,104 +152,55 @@ release_plan.md と GitHub Issue/Project の整合性を確認し、差異があ
|
|
|
209
152
|
- **削除されたストーリー**: Issue をクローズ(削除はしない)
|
|
210
153
|
- **Status 変更**: release_plan.md の Status を GitHub に反映
|
|
211
154
|
|
|
212
|
-
|
|
213
|
-
# 差異確認と同期
|
|
214
|
-
/plan-github --sync
|
|
215
|
-
「release_plan.md と GitHub の差異を確認して同期して」
|
|
216
|
-
```
|
|
217
|
-
|
|
218
|
-
### 出力例
|
|
155
|
+
### 8. 出力例
|
|
219
156
|
|
|
220
157
|
```
|
|
221
|
-
|
|
158
|
+
GitHub Project 同期結果
|
|
222
159
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
223
160
|
|
|
224
|
-
|
|
225
|
-
URL: https://github.com/users/k2works/projects/8
|
|
226
|
-
|
|
227
|
-
📋 Issue 作成状況
|
|
228
|
-
├─ 認証・ユーザー管理: 6件(21SP)
|
|
229
|
-
├─ マスタ管理: 8件(29SP)
|
|
230
|
-
├─ 仕訳管理: 10件(45SP)
|
|
231
|
-
├─ 元帳・残高管理: 5件(26SP)
|
|
232
|
-
├─ 財務諸表: 3件(21SP)
|
|
233
|
-
└─ システム管理: 2件(13SP)
|
|
234
|
-
合計: 34件(155SP)
|
|
235
|
-
|
|
236
|
-
🏁 Milestone 割り当て
|
|
237
|
-
├─ リリース 1.0 MVP: 14件(期日: 2026-02-27)
|
|
238
|
-
├─ リリース 2.0 機能拡張版: 12件(期日: 2026-04-24)
|
|
239
|
-
└─ リリース 3.0 完成版: 8件(期日: 2026-06-19)
|
|
240
|
-
|
|
241
|
-
🔄 差異確認・同期結果
|
|
242
|
-
├─ 新規 Issue: 2件(US-401, US-402)
|
|
243
|
-
├─ 更新 Issue: 3件(SP変更、Status変更)
|
|
244
|
-
├─ クローズ Issue: 0件
|
|
245
|
-
└─ ✅ 同期完了: release_plan.md と GitHub が一致
|
|
246
|
-
```
|
|
247
|
-
|
|
248
|
-
### Claude との連携
|
|
161
|
+
Project: 会計システムのケーススタディ
|
|
249
162
|
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
/plan-github --sync
|
|
259
|
-
「更新したリリース計画と GitHub の差異を確認して同期して」
|
|
260
|
-
|
|
261
|
-
# 既存 Project へのフィールド更新
|
|
262
|
-
/plan-github --fields
|
|
263
|
-
「release_plan.md の最新内容で Project フィールドを更新して」
|
|
264
|
-
```
|
|
163
|
+
Issue 作成状況
|
|
164
|
+
├─ 認証・ユーザー管理: 6 件(21SP)
|
|
165
|
+
├─ マスタ管理: 8 件(29SP)
|
|
166
|
+
├─ 仕訳管理: 10 件(45SP)
|
|
167
|
+
├─ 元帳・残高管理: 5 件(26SP)
|
|
168
|
+
├─ 財務諸表: 3 件(21SP)
|
|
169
|
+
└─ システム管理: 2 件(13SP)
|
|
170
|
+
合計: 34 件(155SP)
|
|
265
171
|
|
|
266
|
-
|
|
172
|
+
Milestone 割り当て
|
|
173
|
+
├─ リリース 1.0 MVP: 14 件
|
|
174
|
+
├─ リリース 2.0 機能拡張版: 12 件
|
|
175
|
+
└─ リリース 3.0 完成版: 8 件
|
|
267
176
|
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
- `gh` CLI がインストールされ認証済みであること
|
|
271
|
-
- Project API スコープが有効であること(`gh auth refresh -s project,read:project`)
|
|
272
|
-
- **制限事項**:
|
|
273
|
-
- 既存の Project/Issue がある場合は重複作成に注意
|
|
274
|
-
- フィールド値の更新は既存値を上書き
|
|
275
|
-
- **推奨事項**:
|
|
276
|
-
- 初回は `--sync` で差異確認してから同期
|
|
277
|
-
- 大規模な変更前にはバックアップを推奨
|
|
278
|
-
|
|
279
|
-
### ベストプラクティス
|
|
280
|
-
|
|
281
|
-
1. **初回同期**: `/plan-github` で全体を一括作成
|
|
282
|
-
2. **計画更新時**: `/plan-github --sync` で差異確認と自動同期
|
|
283
|
-
3. **定期確認**: `/plan-github --status` で進捗状況を定期的に確認
|
|
284
|
-
4. **一貫性維持**: release_plan.md を Single Source of Truth として管理し、`--sync` で GitHub に反映
|
|
177
|
+
同期完了: release_plan.md と GitHub が一致
|
|
178
|
+
```
|
|
285
179
|
|
|
286
|
-
### 同期フロー
|
|
180
|
+
### 9. 同期フロー
|
|
287
181
|
|
|
288
|
-
####
|
|
182
|
+
#### 初回同期フロー
|
|
289
183
|
|
|
290
184
|
```mermaid
|
|
291
185
|
graph TD
|
|
292
|
-
A[release_plan.md] --> B{
|
|
186
|
+
A[release_plan.md] --> B{同期開始}
|
|
293
187
|
B --> C[GitHub Project 作成]
|
|
294
188
|
C --> D[カスタムフィールド設定]
|
|
295
189
|
D --> E[Issue 作成]
|
|
296
|
-
E --> F[Project にItem追加]
|
|
190
|
+
E --> F[Project に Item 追加]
|
|
297
191
|
F --> G[フィールド値設定]
|
|
298
192
|
G --> H[Milestone 作成]
|
|
299
193
|
H --> I[Issue に Milestone 割当]
|
|
300
194
|
I --> J[同期完了]
|
|
301
195
|
```
|
|
302
196
|
|
|
303
|
-
####
|
|
197
|
+
#### 差異確認・同期フロー(--sync)
|
|
304
198
|
|
|
305
199
|
```mermaid
|
|
306
200
|
graph TD
|
|
307
201
|
A[release_plan.md] --> B[GitHub Issue/Project 取得]
|
|
308
202
|
B --> C{差異検出}
|
|
309
|
-
C -->|差異なし| D[
|
|
203
|
+
C -->|差異なし| D[一致確認]
|
|
310
204
|
C -->|差異あり| E[差異レポート表示]
|
|
311
205
|
E --> F{同期実行}
|
|
312
206
|
F --> G[新規 Issue 作成]
|
|
@@ -317,8 +211,33 @@ graph TD
|
|
|
317
211
|
I --> J
|
|
318
212
|
```
|
|
319
213
|
|
|
320
|
-
###
|
|
214
|
+
### 10. 注意事項
|
|
215
|
+
|
|
216
|
+
- **前提条件**:
|
|
217
|
+
|
|
218
|
+
- `docs/development/release_plan.md` が存在すること
|
|
219
|
+
- `gh` CLI がインストールされ認証済みであること
|
|
220
|
+
- Project API スコープが有効であること(`gh auth refresh -s project,read:project`)
|
|
221
|
+
|
|
222
|
+
- **制限事項**:
|
|
223
|
+
|
|
224
|
+
- 既存の Project/Issue がある場合は重複作成に注意
|
|
225
|
+
- フィールド値の更新は既存値を上書き
|
|
226
|
+
|
|
227
|
+
- **推奨事項**:
|
|
228
|
+
|
|
229
|
+
- 初回は `--sync` で差異確認してから同期
|
|
230
|
+
- 大規模な変更前にはバックアップを推奨
|
|
231
|
+
|
|
232
|
+
### 11. ベストプラクティス
|
|
233
|
+
|
|
234
|
+
1. **初回同期**: 全体を一括作成
|
|
235
|
+
2. **計画更新時**: `--sync` で差異確認と自動同期
|
|
236
|
+
3. **定期確認**: `--status` で進捗状況を定期的に確認
|
|
237
|
+
4. **一貫性維持**: release_plan.md を Single Source of Truth として管理し、`--sync` で GitHub に反映
|
|
238
|
+
|
|
239
|
+
### 関連スキル
|
|
321
240
|
|
|
322
|
-
-
|
|
323
|
-
-
|
|
324
|
-
-
|
|
241
|
+
- `planning-releases` : リリース計画とイテレーション計画の作成
|
|
242
|
+
- `tracking-progress` : 進捗状況の確認と更新
|
|
243
|
+
- `git-commit` : 変更のコミット
|
|
@@ -0,0 +1,164 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: tracking-progress
|
|
3
|
+
description: プロジェクトの開発進捗を包括的に分析しレポート生成。イテレーション達成度、技術実装状況、品質メトリクスを確認。進捗確認やステークホルダー報告時に使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# 進捗追跡ガイド
|
|
7
|
+
|
|
8
|
+
プロジェクトの開発進捗を包括的に確認し、現在の状況を詳細に報告します。
|
|
9
|
+
|
|
10
|
+
## Instructions
|
|
11
|
+
|
|
12
|
+
### 1. オプション
|
|
13
|
+
|
|
14
|
+
- なし : 全体的な進捗確認(デフォルト)
|
|
15
|
+
- `--brief` : 簡潔な進捗サマリー表示
|
|
16
|
+
- `--detailed` : 詳細な進捗レポート生成
|
|
17
|
+
- `--iteration <番号>` : 特定イテレーションの進捗確認
|
|
18
|
+
- `--technical` : 技術的な実装状況に焦点
|
|
19
|
+
- `--docs` : ドキュメント更新状況の確認
|
|
20
|
+
- `--update` : `docs/development/` 内のドキュメントを現在の進捗に合わせて更新
|
|
21
|
+
|
|
22
|
+
### 2. 基本例
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
# 基本的な進捗確認
|
|
26
|
+
# 「プロジェクト全体の開発進捗を包括的にレポート」
|
|
27
|
+
|
|
28
|
+
# 簡潔なサマリー
|
|
29
|
+
# --brief
|
|
30
|
+
# 「要点のみを絞った進捗状況を表示」
|
|
31
|
+
|
|
32
|
+
# 詳細レポート
|
|
33
|
+
# --detailed
|
|
34
|
+
# 「技術実装・テスト・ドキュメント・品質指標を含む詳細分析」
|
|
35
|
+
|
|
36
|
+
# 特定イテレーションの確認
|
|
37
|
+
# --iteration 1
|
|
38
|
+
# 「イテレーション 1 の完了状況と成果を詳細分析」
|
|
39
|
+
|
|
40
|
+
# 進捗をドキュメントに反映
|
|
41
|
+
# --update
|
|
42
|
+
# 「release_plan.md と iteration_plan-*.md を現在の進捗に合わせて更新」
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### 3. 包括的な進捗分析
|
|
46
|
+
|
|
47
|
+
プロジェクトの多角的な視点から現在の進捗状況を分析:
|
|
48
|
+
|
|
49
|
+
- **イテレーション達成度**: 計画 vs 実績の比較分析
|
|
50
|
+
- **技術実装状況**: 機能完成度・品質指標・テスト結果
|
|
51
|
+
- **アーキテクチャ進展**: 設計の実装状況と技術的負債
|
|
52
|
+
- **ドキュメント整備**: 計画書・仕様書・実行手順書の最新性
|
|
53
|
+
|
|
54
|
+
### 4. 動的な状況判定
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
# Git 履歴の分析
|
|
58
|
+
git log --oneline -10
|
|
59
|
+
git status --porcelain
|
|
60
|
+
|
|
61
|
+
# テスト実行状況の確認
|
|
62
|
+
dotnet test --logger trx
|
|
63
|
+
npm test -- --coverage
|
|
64
|
+
|
|
65
|
+
# 実行環境の状況確認
|
|
66
|
+
ps aux | grep -E "dotnet|node|npm"
|
|
67
|
+
netstat -tlnp | grep -E ":3000|:5150"
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
### 5. 品質メトリクス取得
|
|
71
|
+
|
|
72
|
+
実装品質の定量的評価:
|
|
73
|
+
|
|
74
|
+
- **テストカバレッジ**: 単体・統合・E2E テストの網羅率
|
|
75
|
+
- **コード品質**: 静的解析結果・複雑度測定
|
|
76
|
+
- **性能指標**: レスポンス時間・スループット測定
|
|
77
|
+
- **セキュリティ**: 脆弱性スキャン結果
|
|
78
|
+
|
|
79
|
+
### 6. --update オプションの詳細
|
|
80
|
+
|
|
81
|
+
`--update` オプションは `docs/development/` 内のドキュメントを現在の進捗に合わせて自動更新します。
|
|
82
|
+
|
|
83
|
+
**更新対象ファイル**:
|
|
84
|
+
|
|
85
|
+
- `docs/development/release_plan.md` - リリース計画
|
|
86
|
+
- `docs/development/iteration_plan-*.md` - イテレーション計画
|
|
87
|
+
|
|
88
|
+
**release_plan.md の更新内容**:
|
|
89
|
+
|
|
90
|
+
1. **進捗状況テーブル**: 各イテレーションの実績 SP、達成率、状態を更新
|
|
91
|
+
2. **リリース条件チェックボックス**: 完了した条件にチェックを入れる
|
|
92
|
+
3. **バーンダウンチャート**: 実績値を反映
|
|
93
|
+
|
|
94
|
+
**iteration_plan-*.md の更新内容**:
|
|
95
|
+
|
|
96
|
+
1. **成功基準チェックボックス**: 達成した基準にチェックを入れる
|
|
97
|
+
2. **タスク分解の状態**: 完了したタスクのチェックボックスを更新
|
|
98
|
+
3. **完了条件(DoD)**: 達成した条件にチェックを入れる
|
|
99
|
+
4. **振り返りセクション**: メトリクス実績値を記入
|
|
100
|
+
|
|
101
|
+
**更新判定の情報源**:
|
|
102
|
+
|
|
103
|
+
```bash
|
|
104
|
+
# Git コミット履歴から実装状況を分析
|
|
105
|
+
git log --oneline --since="2 weeks ago"
|
|
106
|
+
|
|
107
|
+
# テスト実行結果から品質指標を取得
|
|
108
|
+
dotnet test --logger trx
|
|
109
|
+
npm test -- --coverage
|
|
110
|
+
|
|
111
|
+
# ディレクトリ構造から機能実装状況を確認
|
|
112
|
+
ls -la apps/backend/src/
|
|
113
|
+
ls -la apps/frontend/src/
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
### 7. 出力例
|
|
117
|
+
|
|
118
|
+
```
|
|
119
|
+
プロジェクト進捗レポート
|
|
120
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
121
|
+
|
|
122
|
+
Overall Status: フルスタック実装完成 (MVP 準備段階)
|
|
123
|
+
|
|
124
|
+
Iteration Progress:
|
|
125
|
+
├─ Iteration 1 (認証・閲覧): 完了 (計画 10 日→実績 4 日)
|
|
126
|
+
├─ Iteration 2 (予約機能): 計画済み (8 営業日予定)
|
|
127
|
+
├─ Iteration 3 (キャンセル): 待機中
|
|
128
|
+
└─ Iteration 4 (運用準備): 待機中
|
|
129
|
+
|
|
130
|
+
Technical Implementation:
|
|
131
|
+
├─ Backend (.NET 9): 完全実装 (181 テスト全通過)
|
|
132
|
+
├─ Frontend (React TS): 完全実装
|
|
133
|
+
├─ Database (SQLite): 稼働中
|
|
134
|
+
├─ Authentication: JWT 完全実装
|
|
135
|
+
└─ API Integration: フルスタック連携確認
|
|
136
|
+
|
|
137
|
+
Documentation:
|
|
138
|
+
├─ 計画書: 最新
|
|
139
|
+
├─ リリース計画: 更新済み
|
|
140
|
+
├─ README: 実行手順書完備
|
|
141
|
+
└─ API 仕様: Swagger UI 統合
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
### 8. 注意事項
|
|
145
|
+
|
|
146
|
+
- **前提条件**: Git リポジトリ内で実行、プロジェクト構造を理解
|
|
147
|
+
- **情報取得**: 実行時点での動的な状況を総合的に分析
|
|
148
|
+
- **推奨事項**: 重要な節目や問題発生時の定期的な進捗確認
|
|
149
|
+
- **--update 使用時**: 更新前に Git でコミットしておくことを推奨(変更のロールバック用)
|
|
150
|
+
|
|
151
|
+
### 9. ベストプラクティス
|
|
152
|
+
|
|
153
|
+
1. **定期実行**: イテレーション開始・終了時の進捗確認
|
|
154
|
+
2. **問題発見**: 遅延や品質低下の早期発見に活用
|
|
155
|
+
3. **ステークホルダー報告**: 詳細レポートを会議資料として活用
|
|
156
|
+
4. **改善指標**: 進捗データを基にした開発プロセス改善
|
|
157
|
+
5. **ドキュメント同期**: イテレーション完了時に `--update` で docs/development を同期
|
|
158
|
+
6. **振り返り記録**: `--update` 実行後、KPT セクションを手動で記入して振り返りを完了
|
|
159
|
+
|
|
160
|
+
### 関連スキル
|
|
161
|
+
|
|
162
|
+
- `managing-docs` : ドキュメント一覧と進捗状況の確認
|
|
163
|
+
- `git-commit` : 進捗に合わせた適切なコミット実行
|
|
164
|
+
- `planning-releases` : イテレーション計画の作成・更新
|