@k2works/claude-code-booster 1.12.0 → 2.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/bin/claude-code-booster +5 -7
- package/lib/assets/.claude/README.md +73 -19
- package/lib/assets/.claude/agents/xp-architect.md +250 -0
- package/lib/assets/.claude/agents/xp-executive.md +207 -0
- package/lib/assets/.claude/agents/xp-interaction-designer.md +239 -0
- package/lib/assets/.claude/agents/xp-product-manager.md +245 -0
- package/lib/assets/.claude/agents/xp-programmer.md +268 -0
- package/lib/assets/.claude/agents/xp-project-manager.md +229 -0
- package/lib/assets/.claude/agents/xp-technical-writer.md +224 -0
- package/lib/assets/.claude/agents/xp-tester.md +265 -0
- package/lib/assets/.claude/agents/xp-user-representative.md +204 -0
- package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +49 -57
- package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +54 -58
- package/lib/assets/.claude/skills/analyzing-business/SKILL.md +52 -74
- package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +50 -53
- package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +56 -56
- package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +56 -109
- package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +61 -57
- package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +61 -57
- package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +57 -55
- package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +66 -67
- package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +58 -56
- package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +51 -57
- package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +45 -60
- package/lib/assets/.claude/skills/creating-adr/SKILL.md +38 -40
- package/lib/assets/.claude/skills/developing-backend/SKILL.md +49 -55
- package/lib/assets/.claude/skills/developing-frontend/SKILL.md +47 -50
- package/lib/assets/.claude/skills/developing-release/SKILL.md +60 -95
- package/lib/assets/.claude/skills/generating-slides/SKILL.md +58 -100
- package/lib/assets/.claude/skills/git-commit/SKILL.md +27 -52
- package/lib/assets/.claude/skills/killing-processes/SKILL.md +16 -70
- package/lib/assets/.claude/skills/operating-backup/SKILL.md +59 -0
- package/lib/assets/.claude/skills/operating-cicd/SKILL.md +54 -0
- package/lib/assets/.claude/skills/operating-deploy/SKILL.md +67 -0
- package/lib/assets/.claude/skills/{managing-docs → operating-docs}/SKILL.md +1 -1
- package/lib/assets/.claude/skills/operating-provision/SKILL.md +77 -0
- package/lib/assets/.claude/skills/operating-setup/SKILL.md +63 -0
- package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +65 -95
- package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +60 -155
- package/lib/assets/.claude/skills/orchestrating-operation/SKILL.md +158 -0
- package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +60 -119
- package/lib/assets/.claude/skills/planning-releases/SKILL.md +63 -168
- package/lib/assets/.claude/skills/syncing-github-project/SKILL.md +62 -266
- package/lib/assets/.claude/skills/tracking-progress/SKILL.md +49 -122
- package/lib/assets/CLAUDE.md +7 -2
- package/lib/assets/README.md +3 -34
- package/lib/assets/docs/development/index.md +14 -8
- package/lib/assets/docs/index.md +1 -0
- package/lib/assets/docs/reference/SonarQube/343/203/255/343/203/274/343/202/253/343/203/253/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +640 -0
- package/lib/assets/docs/reference/index.md +1 -0
- package/lib/assets/docs/reference//351/201/213/347/224/250/343/202/271/343/202/257/343/203/252/343/203/227/343/203/210/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211.md +421 -0
- package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +69 -5
- package/lib/assets/docs/template/AWS/343/202/271/343/203/206/343/203/274/343/202/270/343/203/263/343/202/260/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +1366 -0
- package/lib/assets/docs/template/AWS/343/203/227/343/203/255/343/203/200/343/202/257/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +634 -0
- package/lib/assets/docs/template//343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/351/226/213/347/231/272/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +547 -0
- 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 +123 -1
- package/lib/assets/docs/template//350/250/255/350/250/210.md +12 -2
- package/lib/assets/docs/template//351/226/213/347/231/272/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +688 -0
- package/lib/assets/gulpfile.js +2 -0
- package/lib/assets/mkdocs.yml +1 -0
- package/lib/assets/ops/docker/sonarqube-local/docker-compose.yml +57 -0
- package/lib/assets/ops/scripts/sonar_local.js +726 -0
- package/package.json +1 -1
- package/lib/assets/.claude/SKILLS_TEMPLATE.md +0 -100
- package/lib/assets/.claude/agents/roles/.gitkeep +0 -0
- package/lib/assets/.claude/skills/managing-operations/DEPLOY.md +0 -77
- package/lib/assets/.claude/skills/managing-operations/SETUP_CSHARP.md +0 -80
- package/lib/assets/.claude/skills/managing-operations/SETUP_FRONTEND.md +0 -84
- package/lib/assets/.claude/skills/managing-operations/SETUP_JAVA.md +0 -75
- package/lib/assets/.claude/skills/managing-operations/SKILL.md +0 -156
|
@@ -1,127 +1,74 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: syncing-github-project
|
|
3
|
-
description: リリース計画を GitHub Project・Issue・Milestone
|
|
3
|
+
description: リリース計画を GitHub Project・Issue・Milestone に反映し一元管理。初回の一括同期から差異検出・自動同期まで対応する。「GitHub Project に同期したい」「Issue を作成したい」「計画と GitHub の差異を確認したい」「Milestone を設定したい」といった場面で発動する。計画ドキュメントを Single Source of Truth とし GitHub に自動反映することで、二重管理の手間と不整合を排除する。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# GitHub Project
|
|
6
|
+
# GitHub Project 同期
|
|
7
7
|
|
|
8
|
-
リリース計画を GitHub Project・Issue・Milestone に反映し、プロジェクト管理を GitHub
|
|
8
|
+
リリース計画を GitHub Project・Issue・Milestone に反映し、プロジェクト管理を GitHub 上で一元化する。
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
`docs/development/release_plan.md` を正とし、GitHub は同期先として扱う。手動で GitHub を直接更新するのではなく、計画ドキュメントを更新してから `--sync` で反映する。
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
## オプション
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
14
|
+
| オプション | 説明 |
|
|
15
|
+
|-----------|------|
|
|
16
|
+
| なし | 全体の同期を実行(Project・Issue・フィールド・Milestone) |
|
|
17
|
+
| `--project` | GitHub Project のみを作成 |
|
|
18
|
+
| `--issues` | Issue のみを作成(Project 存在が前提) |
|
|
19
|
+
| `--fields` | 各 Issue に対して Project フィールド値を設定 |
|
|
20
|
+
| `--milestones` | Milestone のみを作成し Issue に割り当て |
|
|
21
|
+
| `--sync` | release_plan.md と GitHub の差異を確認し同期 |
|
|
22
|
+
| `--status` | 現在の GitHub Project 状態を表示 |
|
|
21
23
|
|
|
22
|
-
|
|
24
|
+
## GitHub Project の作成
|
|
23
25
|
|
|
24
|
-
|
|
25
|
-
# 初回の完全同期(Project、Issue、Milestone すべて作成)
|
|
26
|
-
# 「リリース計画を GitHub Project に反映して」
|
|
27
|
-
|
|
28
|
-
# 差異確認と同期
|
|
29
|
-
# --sync
|
|
30
|
-
# 「release_plan.md と GitHub の差異を確認して同期して」
|
|
31
|
-
|
|
32
|
-
# 現在の状態確認
|
|
33
|
-
# --status
|
|
34
|
-
# 「GitHub Project の現在の状態を表示して」
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
### 3. GitHub Project の作成
|
|
38
|
-
|
|
39
|
-
release_plan.md に基づいて GitHub Project を作成し、カスタムフィールドを設定します。
|
|
26
|
+
release_plan.md に基づいて Project を作成し、カスタムフィールドを設定する。
|
|
40
27
|
|
|
41
28
|
**標準フィールド構成**:
|
|
42
29
|
|
|
43
30
|
| フィールド | タイプ | 説明 |
|
|
44
31
|
|-----------|--------|------|
|
|
45
|
-
|
|
|
46
|
-
|
|
|
47
|
-
|
|
|
48
|
-
|
|
|
49
|
-
|
|
|
50
|
-
|
|
51
|
-
プロジェクト固有のフィールド(カテゴリ、担当領域など)は release_plan.md の内容に応じて追加します。
|
|
52
|
-
|
|
53
|
-
**Single Select フィールドの作成**:
|
|
32
|
+
| Status | Single Select | Todo / In Progress / Done |
|
|
33
|
+
| リリース | Single Select | release_plan.md のリリースフェーズに対応 |
|
|
34
|
+
| 優先度 | Single Select | ストーリーの優先度 |
|
|
35
|
+
| SP | Number | ストーリーポイント |
|
|
36
|
+
| イテレーション | Iteration | スプリント期間(開始日・期間付き) |
|
|
54
37
|
|
|
55
38
|
```bash
|
|
39
|
+
# Single Select フィールドの作成
|
|
56
40
|
gh project field-create <PROJECT_NUMBER> --owner <OWNER> \
|
|
57
41
|
--name "<フィールド名>" --data-type "SINGLE_SELECT" \
|
|
58
|
-
--single-select-options "<選択肢1>,<選択肢2
|
|
59
|
-
```
|
|
42
|
+
--single-select-options "<選択肢1>,<選択肢2>"
|
|
60
43
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
```bash
|
|
44
|
+
# Number フィールドの作成
|
|
64
45
|
gh project field-create <PROJECT_NUMBER> --owner <OWNER> \
|
|
65
46
|
--name "SP" --data-type "NUMBER"
|
|
66
47
|
```
|
|
67
48
|
|
|
68
|
-
|
|
49
|
+
## Issue の作成
|
|
69
50
|
|
|
70
|
-
ユーザーストーリーを GitHub Issue として作成し、Project
|
|
71
|
-
|
|
72
|
-
**Issue の構成**:
|
|
51
|
+
ユーザーストーリーを GitHub Issue として作成し、Project に追加する。
|
|
73
52
|
|
|
74
53
|
- **タイトル**: `[ストーリーID] ストーリー名`
|
|
75
54
|
- **本文**: ユーザーストーリー、サブタスク、受入条件、見積もり情報
|
|
76
55
|
- **Milestone**: リリースフェーズに対応する Milestone に割り当て
|
|
77
|
-
- **Project 紐付け**: `gh project item-add` で Project に追加
|
|
78
56
|
|
|
79
57
|
```bash
|
|
80
|
-
# Issue の作成(Milestone 付き)
|
|
81
58
|
gh issue create --repo <OWNER>/<REPO> \
|
|
82
59
|
--title "<ストーリーID>: <ストーリー名>" \
|
|
83
|
-
--milestone "<Milestone 名>"
|
|
84
|
-
--body "..."
|
|
60
|
+
--milestone "<Milestone 名>" --body "..."
|
|
85
61
|
|
|
86
|
-
# Project への追加
|
|
87
62
|
gh project item-add <PROJECT_NUMBER> --owner <OWNER> \
|
|
88
63
|
--url "https://github.com/<OWNER>/<REPO>/issues/<NUMBER>"
|
|
89
64
|
```
|
|
90
65
|
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
各 Issue に対して Project のカスタムフィールド値を個別に設定します。
|
|
94
|
-
|
|
95
|
-
#### 5.1 フィールド ID・オプション ID の取得
|
|
96
|
-
|
|
97
|
-
```bash
|
|
98
|
-
# フィールド一覧の取得
|
|
99
|
-
gh project field-list <PROJECT_NUMBER> --owner <OWNER> --format json
|
|
100
|
-
|
|
101
|
-
# Project Item ID の取得
|
|
102
|
-
gh project item-list <PROJECT_NUMBER> --owner <OWNER> --format json --limit 50 \
|
|
103
|
-
| jq -r '.items[] | "\(.content.number):\(.id)"'
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
#### 5.2 Single Select / Number フィールドの設定
|
|
66
|
+
## Iteration フィールドの作成と設定
|
|
107
67
|
|
|
108
|
-
|
|
109
|
-
# Single Select フィールドの設定
|
|
110
|
-
gh project item-edit --project-id <PROJECT_ID> --id <ITEM_ID> \
|
|
111
|
-
--field-id <FIELD_ID> --single-select-option-id <OPTION_ID>
|
|
112
|
-
|
|
113
|
-
# Number フィールドの設定
|
|
114
|
-
gh project item-edit --project-id <PROJECT_ID> --id <ITEM_ID> \
|
|
115
|
-
--field-id <FIELD_ID> --number <VALUE>
|
|
116
|
-
```
|
|
117
|
-
|
|
118
|
-
#### 5.3 Iteration フィールドの作成と設定
|
|
119
|
-
|
|
120
|
-
Iteration フィールドは **Single Select ではなく Iteration 型** で作成します。GraphQL API の `createProjectV2Field` に `iterationConfiguration` を含めることで、フィールド作成と同時にイテレーション期間を設定できます。
|
|
121
|
-
|
|
122
|
-
**Iteration フィールドの作成(iterationConfiguration 付き)**:
|
|
68
|
+
Iteration フィールドは Single Select ではなく **Iteration 型** で作成する。GraphQL API で `iterationConfiguration` を含めることで、フィールド作成と同時にイテレーション期間を設定できる。
|
|
123
69
|
|
|
124
70
|
```bash
|
|
71
|
+
# Iteration フィールドの作成
|
|
125
72
|
gh api graphql -f query='
|
|
126
73
|
mutation {
|
|
127
74
|
createProjectV2Field(input: {
|
|
@@ -132,69 +79,13 @@ mutation {
|
|
|
132
79
|
startDate: "<開始日 YYYY-MM-DD>"
|
|
133
80
|
duration: <デフォルト期間(日数)>
|
|
134
81
|
iterations: [
|
|
135
|
-
{ title: "<IT名>", startDate: "<開始日>", duration: <日数> }
|
|
136
|
-
...
|
|
82
|
+
{ title: "<IT名>", startDate: "<開始日>", duration: <日数> }
|
|
137
83
|
]
|
|
138
84
|
}
|
|
139
|
-
}) {
|
|
140
|
-
projectV2Field {
|
|
141
|
-
... on ProjectV2IterationField {
|
|
142
|
-
id
|
|
143
|
-
name
|
|
144
|
-
configuration {
|
|
145
|
-
iterations { id title startDate duration }
|
|
146
|
-
}
|
|
147
|
-
}
|
|
148
|
-
}
|
|
149
|
-
}
|
|
85
|
+
}) { projectV2Field { ... on ProjectV2IterationField { id } } }
|
|
150
86
|
}'
|
|
151
|
-
```
|
|
152
|
-
|
|
153
|
-
**GraphQL スキーマ**:
|
|
154
|
-
|
|
155
|
-
```
|
|
156
|
-
CreateProjectV2FieldInput:
|
|
157
|
-
projectId: ID!
|
|
158
|
-
dataType: ProjectV2CustomFieldType! # ITERATION を指定
|
|
159
|
-
name: String!
|
|
160
|
-
iterationConfiguration: ProjectV2IterationFieldConfigurationInput
|
|
161
|
-
|
|
162
|
-
ProjectV2IterationFieldConfigurationInput:
|
|
163
|
-
startDate: Date! # フィールド全体の開始日
|
|
164
|
-
duration: Int! # デフォルト期間(日数)
|
|
165
|
-
iterations: [ProjectV2Iteration!]!
|
|
166
|
-
|
|
167
|
-
ProjectV2Iteration:
|
|
168
|
-
title: String! # イテレーション名(例: "IT1", "Sprint 1")
|
|
169
|
-
startDate: Date! # 開始日(YYYY-MM-DD)
|
|
170
|
-
duration: Int! # 期間(日数、例: 14)
|
|
171
|
-
```
|
|
172
|
-
|
|
173
|
-
**重要**: `iterationConfiguration` を含めることで Web UI での手動設定は不要です。
|
|
174
87
|
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
```bash
|
|
178
|
-
gh api graphql -f query='
|
|
179
|
-
query {
|
|
180
|
-
node(id: "<PROJECT_ID>") {
|
|
181
|
-
... on ProjectV2 {
|
|
182
|
-
field(name: "イテレーション") {
|
|
183
|
-
... on ProjectV2IterationField {
|
|
184
|
-
id
|
|
185
|
-
configuration {
|
|
186
|
-
iterations { id title startDate duration }
|
|
187
|
-
}
|
|
188
|
-
}
|
|
189
|
-
}
|
|
190
|
-
}
|
|
191
|
-
}
|
|
192
|
-
}'
|
|
193
|
-
```
|
|
194
|
-
|
|
195
|
-
**各 Issue への Iteration 値の設定**:
|
|
196
|
-
|
|
197
|
-
```bash
|
|
88
|
+
# 各 Issue への Iteration 値の設定
|
|
198
89
|
gh api graphql -f query='
|
|
199
90
|
mutation {
|
|
200
91
|
updateProjectV2ItemFieldValue(input: {
|
|
@@ -202,93 +93,23 @@ mutation {
|
|
|
202
93
|
itemId: "<ITEM_ID>"
|
|
203
94
|
fieldId: "<ITERATION_FIELD_ID>"
|
|
204
95
|
value: { iterationId: "<ITERATION_ID>" }
|
|
205
|
-
}) {
|
|
206
|
-
projectV2Item { id }
|
|
207
|
-
}
|
|
96
|
+
}) { projectV2Item { id } }
|
|
208
97
|
}'
|
|
209
98
|
```
|
|
210
99
|
|
|
211
|
-
|
|
100
|
+
## 差異確認と同期(--sync)
|
|
212
101
|
|
|
213
|
-
|
|
102
|
+
release_plan.md と GitHub の整合性を確認し、差異があれば同期を実行する。
|
|
214
103
|
|
|
215
|
-
|
|
216
|
-
# Milestone の作成
|
|
217
|
-
gh api repos/<OWNER>/<REPO>/milestones --method POST \
|
|
218
|
-
-f title="<Milestone 名>" \
|
|
219
|
-
-f description="<説明>" \
|
|
220
|
-
-f due_on="<期限 YYYY-MM-DDT00:00:00Z>"
|
|
221
|
-
|
|
222
|
-
# Issue 作成時に --milestone で指定するか、既存 Issue に割り当て
|
|
223
|
-
gh issue edit <NUMBER> --repo <OWNER>/<REPO> --milestone "<Milestone 名>"
|
|
224
|
-
```
|
|
225
|
-
|
|
226
|
-
### 7. 差異確認と同期
|
|
227
|
-
|
|
228
|
-
release_plan.md と GitHub Issue/Project の整合性を確認し、差異があれば同期を実行します。
|
|
229
|
-
|
|
230
|
-
**確認項目**:
|
|
231
|
-
|
|
232
|
-
- ストーリー数の一致
|
|
233
|
-
- ストーリーポイントの一致
|
|
234
|
-
- リリース/Milestone 割り当ての一致
|
|
235
|
-
- 優先度の一致
|
|
236
|
-
- イテレーション割り当ての一致
|
|
237
|
-
- Status の一致
|
|
104
|
+
**確認項目**: ストーリー数、SP、リリース/Milestone 割り当て、優先度、イテレーション割り当て、Status
|
|
238
105
|
|
|
239
106
|
**同期動作**:
|
|
240
107
|
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
108
|
+
- **新規ストーリー**: Issue を作成し Project に追加する
|
|
109
|
+
- **変更されたストーリー**: Issue のフィールド値を更新する
|
|
110
|
+
- **削除されたストーリー**: Issue をクローズする(削除はしない)
|
|
244
111
|
|
|
245
|
-
|
|
246
|
-
- **変更されたストーリー**: Issue のフィールド値を更新
|
|
247
|
-
- **削除されたストーリー**: Issue をクローズ(削除はしない)
|
|
248
|
-
- **Status 変更**: release_plan.md の Status を GitHub に反映
|
|
249
|
-
|
|
250
|
-
### 8. フィールド値の一括確認(GraphQL)
|
|
251
|
-
|
|
252
|
-
設定済みのフィールド値を一覧で確認します。
|
|
253
|
-
|
|
254
|
-
```bash
|
|
255
|
-
gh api graphql -f query='
|
|
256
|
-
query {
|
|
257
|
-
node(id: "<PROJECT_ID>") {
|
|
258
|
-
... on ProjectV2 {
|
|
259
|
-
items(first: 50) {
|
|
260
|
-
nodes {
|
|
261
|
-
content {
|
|
262
|
-
... on Issue { number title }
|
|
263
|
-
}
|
|
264
|
-
fieldValues(first: 10) {
|
|
265
|
-
nodes {
|
|
266
|
-
... on ProjectV2ItemFieldSingleSelectValue {
|
|
267
|
-
field { ... on ProjectV2SingleSelectField { name } }
|
|
268
|
-
name
|
|
269
|
-
}
|
|
270
|
-
... on ProjectV2ItemFieldNumberValue {
|
|
271
|
-
field { ... on ProjectV2Field { name } }
|
|
272
|
-
number
|
|
273
|
-
}
|
|
274
|
-
... on ProjectV2ItemFieldIterationValue {
|
|
275
|
-
field { ... on ProjectV2IterationField { name } }
|
|
276
|
-
title
|
|
277
|
-
startDate
|
|
278
|
-
duration
|
|
279
|
-
}
|
|
280
|
-
}
|
|
281
|
-
}
|
|
282
|
-
}
|
|
283
|
-
}
|
|
284
|
-
}
|
|
285
|
-
}
|
|
286
|
-
}'
|
|
287
|
-
```
|
|
288
|
-
|
|
289
|
-
### 9. 同期フロー
|
|
290
|
-
|
|
291
|
-
#### 初回同期フロー
|
|
112
|
+
## 同期フロー
|
|
292
113
|
|
|
293
114
|
```mermaid
|
|
294
115
|
graph TD
|
|
@@ -298,58 +119,33 @@ graph TD
|
|
|
298
119
|
D --> E[Issue 作成]
|
|
299
120
|
E --> F[Project に Item 追加]
|
|
300
121
|
F --> G[フィールド値設定]
|
|
301
|
-
G --> H[Milestone
|
|
302
|
-
H --> I[
|
|
303
|
-
I --> J[同期完了]
|
|
304
|
-
```
|
|
305
|
-
|
|
306
|
-
#### 差異確認・同期フロー(--sync)
|
|
307
|
-
|
|
308
|
-
```mermaid
|
|
309
|
-
graph TD
|
|
310
|
-
A[release_plan.md] --> B[GitHub Issue/Project 取得]
|
|
311
|
-
B --> C{差異検出}
|
|
312
|
-
C -->|差異なし| D[一致確認]
|
|
313
|
-
C -->|差異あり| E[差異レポート表示]
|
|
314
|
-
E --> F{同期実行}
|
|
315
|
-
F --> G[新規 Issue 作成]
|
|
316
|
-
F --> H[既存 Issue 更新]
|
|
317
|
-
F --> I[削除された Issue クローズ]
|
|
318
|
-
G --> J[同期完了]
|
|
319
|
-
H --> J
|
|
320
|
-
I --> J
|
|
122
|
+
G --> H[Milestone 作成・割当]
|
|
123
|
+
H --> I[同期完了]
|
|
321
124
|
```
|
|
322
125
|
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
- **前提条件**:
|
|
126
|
+
## 途中から再開
|
|
326
127
|
|
|
327
|
-
|
|
328
|
-
- `gh` CLI がインストールされ認証済みであること
|
|
329
|
-
- Project API スコープが有効であること(`gh auth refresh -s project,read:project`)
|
|
128
|
+
同期作業の途中から再開する場合は、まず現在の GitHub 状態を確認する。
|
|
330
129
|
|
|
331
|
-
|
|
130
|
+
**Example:**
|
|
332
131
|
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
- 初回は `--sync` で差異確認してから同期
|
|
340
|
-
- 大規模な変更前にはバックアップを推奨
|
|
132
|
+
```
|
|
133
|
+
ユーザー: 「Project と Issue は作成済み。フィールド値を設定したい」
|
|
134
|
+
回答: --status で現在の GitHub 状態を確認する。
|
|
135
|
+
--fields でフィールド値を一括設定する。
|
|
136
|
+
設定後に --sync で release_plan.md との整合性を検証する。
|
|
137
|
+
```
|
|
341
138
|
|
|
342
|
-
|
|
139
|
+
## 注意事項
|
|
343
140
|
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
5. **Iteration 型の活用**: イテレーションは Single Select ではなく Iteration 型フィールドを使用し、スプリント期間を明示する
|
|
141
|
+
- `docs/development/release_plan.md` が存在すること、`gh` CLI がインストールされ認証済みであること、Project API スコープが有効であること(前提条件)
|
|
142
|
+
- 既存の Project/Issue がある場合は重複作成に注意する
|
|
143
|
+
- Iteration フィールドの期間変更は GraphQL API または Web UI で実施する
|
|
144
|
+
- 初回は `--sync` で差異確認してから同期する。大規模変更前にはバックアップを推奨する
|
|
349
145
|
|
|
350
|
-
|
|
146
|
+
## 関連スキル
|
|
351
147
|
|
|
352
|
-
- `planning-releases`
|
|
353
|
-
- `tracking-progress`
|
|
354
|
-
- `orchestrating-project`
|
|
355
|
-
- `git-commit`
|
|
148
|
+
- `planning-releases` — リリース計画とイテレーション計画の作成
|
|
149
|
+
- `tracking-progress` — 進捗状況の確認と更新
|
|
150
|
+
- `orchestrating-project` — 計画・進捗管理フェーズ全体のオーケストレーション
|
|
151
|
+
- `git-commit` — 変更のコミット
|
|
@@ -1,119 +1,49 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: tracking-progress
|
|
3
|
-
description:
|
|
3
|
+
description: プロジェクトの開発進捗を多角的に分析しレポートを生成。イテレーション達成度、技術実装状況、品質メトリクスを確認し、計画ドキュメントを自動更新する。「進捗を確認したい」「プロジェクトの状態を知りたい」「イテレーションの達成度を分析したい」「進捗ドキュメントを更新したい」といった場面で発動する。定期的な進捗可視化により、遅延や品質低下を早期に発見しプロジェクトの透明性を確保する。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# 進捗追跡
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
プロジェクトの開発進捗を多角的に分析し、現在の状況を定量的に報告する。Git 履歴・テスト結果・ドキュメントを総合的に分析して進捗を可視化する。
|
|
9
9
|
|
|
10
|
-
##
|
|
10
|
+
## オプション
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
| オプション | 説明 |
|
|
13
|
+
|-----------|------|
|
|
14
|
+
| なし | 全体的な進捗確認(デフォルト) |
|
|
15
|
+
| `--brief` | 簡潔な進捗サマリー表示 |
|
|
16
|
+
| `--detailed` | 詳細な進捗レポート生成 |
|
|
17
|
+
| `--iteration <番号>` | 特定イテレーションの進捗確認 |
|
|
18
|
+
| `--technical` | 技術的な実装状況に焦点 |
|
|
19
|
+
| `--docs` | ドキュメント更新状況の確認 |
|
|
20
|
+
| `--update` | `docs/development/` 内のドキュメントを現在の進捗に合わせて更新 |
|
|
13
21
|
|
|
14
|
-
|
|
15
|
-
- `--brief` : 簡潔な進捗サマリー表示
|
|
16
|
-
- `--detailed` : 詳細な進捗レポート生成
|
|
17
|
-
- `--iteration <番号>` : 特定イテレーションの進捗確認
|
|
18
|
-
- `--technical` : 技術的な実装状況に焦点
|
|
19
|
-
- `--docs` : ドキュメント更新状況の確認
|
|
20
|
-
- `--update` : `docs/development/` 内のドキュメントを現在の進捗に合わせて更新
|
|
22
|
+
## 分析の観点
|
|
21
23
|
|
|
22
|
-
|
|
24
|
+
- **イテレーション達成度**: 計画 vs 実績の比較分析(SP、ストーリー数、期間)
|
|
25
|
+
- **技術実装状況**: 機能完成度・テスト結果・ビルド状態
|
|
26
|
+
- **品質メトリクス**: テストカバレッジ、静的解析結果、コード複雑度
|
|
27
|
+
- **ドキュメント整備**: 計画書・仕様書・手順書の最新性
|
|
23
28
|
|
|
24
|
-
|
|
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
|
-
```
|
|
29
|
+
## --update オプションの詳細
|
|
69
30
|
|
|
70
|
-
|
|
31
|
+
`docs/development/` 内のドキュメントを現在の進捗に合わせて自動更新する。
|
|
71
32
|
|
|
72
|
-
|
|
33
|
+
**更新対象**:
|
|
73
34
|
|
|
74
|
-
-
|
|
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. **振り返りセクション**: メトリクス実績値を記入
|
|
35
|
+
- `docs/development/release_plan.md` — 進捗状況テーブル、リリース条件チェック、バーンダウン実績値
|
|
36
|
+
- `docs/development/iteration_plan-*.md` — 成功基準チェック、タスク状態、完了条件(DoD)、メトリクス実績値
|
|
100
37
|
|
|
101
38
|
**更新判定の情報源**:
|
|
102
39
|
|
|
103
40
|
```bash
|
|
104
|
-
#
|
|
105
|
-
|
|
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/
|
|
41
|
+
git log --oneline --since="2 weeks ago" # 実装状況の分析
|
|
42
|
+
dotnet test --logger trx # テスト結果の取得
|
|
43
|
+
npm test -- --coverage # カバレッジの取得
|
|
114
44
|
```
|
|
115
45
|
|
|
116
|
-
|
|
46
|
+
## 出力例
|
|
117
47
|
|
|
118
48
|
```
|
|
119
49
|
プロジェクト進捗レポート
|
|
@@ -123,42 +53,39 @@ Overall Status: フルスタック実装完成 (MVP 準備段階)
|
|
|
123
53
|
|
|
124
54
|
Iteration Progress:
|
|
125
55
|
├─ Iteration 1 (認証・閲覧): 完了 (計画 10 日→実績 4 日)
|
|
126
|
-
├─ Iteration 2 (予約機能): 計画済み
|
|
56
|
+
├─ Iteration 2 (予約機能): 計画済み
|
|
127
57
|
├─ Iteration 3 (キャンセル): 待機中
|
|
128
58
|
└─ Iteration 4 (運用準備): 待機中
|
|
129
59
|
|
|
130
60
|
Technical Implementation:
|
|
131
61
|
├─ Backend (.NET 9): 完全実装 (181 テスト全通過)
|
|
132
62
|
├─ Frontend (React TS): 完全実装
|
|
133
|
-
├─ Database (SQLite): 稼働中
|
|
134
|
-
├─ Authentication: JWT 完全実装
|
|
135
63
|
└─ API Integration: フルスタック連携確認
|
|
136
|
-
|
|
137
|
-
Documentation:
|
|
138
|
-
├─ 計画書: 最新
|
|
139
|
-
├─ リリース計画: 更新済み
|
|
140
|
-
├─ README: 実行手順書完備
|
|
141
|
-
└─ API 仕様: Swagger UI 統合
|
|
142
64
|
```
|
|
143
65
|
|
|
144
|
-
|
|
66
|
+
## 途中から再開
|
|
67
|
+
|
|
68
|
+
進捗追跡の途中から再開する場合は、前回の追跡結果を確認する。
|
|
145
69
|
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
70
|
+
**Example:**
|
|
71
|
+
|
|
72
|
+
```
|
|
73
|
+
ユーザー: 「イテレーション 2 の中間進捗を確認したい」
|
|
74
|
+
回答: --iteration 2 で現在の達成状況を分析する。
|
|
75
|
+
計画 SP と完了 SP を比較し、残りの期間で完了可能か評価する。
|
|
76
|
+
遅延リスクがあれば早期に報告する。
|
|
77
|
+
```
|
|
150
78
|
|
|
151
|
-
|
|
79
|
+
## 注意事項
|
|
152
80
|
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
6. **振り返り記録**: `--update` 実行後、KPT セクションを手動で記入して振り返りを完了
|
|
81
|
+
- Git リポジトリ内で実行し、プロジェクト構造を理解していること(前提条件)
|
|
82
|
+
- 実行時点での動的な状況を総合的に分析する
|
|
83
|
+
- `--update` 使用時は更新前に Git でコミットしておくことを推奨する(ロールバック用)
|
|
84
|
+
- イテレーション開始・終了時の定期実行を推奨する
|
|
85
|
+
- `--update` 実行後、KPT セクションは手動で記入して振り返りを完了する
|
|
159
86
|
|
|
160
|
-
|
|
87
|
+
## 関連スキル
|
|
161
88
|
|
|
162
|
-
- `managing-docs`
|
|
163
|
-
- `git-commit`
|
|
164
|
-
- `planning-releases`
|
|
89
|
+
- `managing-docs` — ドキュメント一覧と進捗状況の確認
|
|
90
|
+
- `git-commit` — 進捗に合わせた適切なコミット実行
|
|
91
|
+
- `planning-releases` — イテレーション計画の作成・更新
|
package/lib/assets/CLAUDE.md
CHANGED
|
@@ -24,6 +24,7 @@
|
|
|
24
24
|
| :--- | :--- |
|
|
25
25
|
| `orchestrating-analysis` | 分析フェーズの全体ワークフロー |
|
|
26
26
|
| `orchestrating-development` | 開発フェーズの TDD ワークフロー・Codex 分業 |
|
|
27
|
+
| `orchestrating-operation` | 運用フェーズの環境構築・デプロイワークフロー |
|
|
27
28
|
|
|
28
29
|
### 分析
|
|
29
30
|
|
|
@@ -60,14 +61,18 @@
|
|
|
60
61
|
|
|
61
62
|
| スキル | 用途 |
|
|
62
63
|
| :--- | :--- |
|
|
63
|
-
| `
|
|
64
|
+
| `operating-setup` | 環境構築(段階的セットアップ) |
|
|
65
|
+
| `operating-provision` | IaC プロビジョニング(Terraform) |
|
|
66
|
+
| `operating-cicd` | CI/CD パイプライン構築 |
|
|
67
|
+
| `operating-deploy` | デプロイ・ロールバック |
|
|
68
|
+
| `operating-backup` | バックアップ・リストア |
|
|
64
69
|
| `killing-processes` | 開発プロセス強制終了 |
|
|
65
70
|
|
|
66
71
|
### ドキュメント・Git
|
|
67
72
|
|
|
68
73
|
| スキル | 用途 |
|
|
69
74
|
| :--- | :--- |
|
|
70
|
-
| `
|
|
75
|
+
| `operating-docs` | ドキュメント管理・Lint |
|
|
71
76
|
| `generating-slides` | インセプションデッキのスライド生成 |
|
|
72
77
|
| `git-commit` | Conventional Commits 準拠のコミット |
|
|
73
78
|
| `creating-adr` | ADR 作成 |
|