@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.
Files changed (70) hide show
  1. package/bin/claude-code-booster +5 -7
  2. package/lib/assets/.claude/README.md +73 -19
  3. package/lib/assets/.claude/agents/xp-architect.md +250 -0
  4. package/lib/assets/.claude/agents/xp-executive.md +207 -0
  5. package/lib/assets/.claude/agents/xp-interaction-designer.md +239 -0
  6. package/lib/assets/.claude/agents/xp-product-manager.md +245 -0
  7. package/lib/assets/.claude/agents/xp-programmer.md +268 -0
  8. package/lib/assets/.claude/agents/xp-project-manager.md +229 -0
  9. package/lib/assets/.claude/agents/xp-technical-writer.md +224 -0
  10. package/lib/assets/.claude/agents/xp-tester.md +265 -0
  11. package/lib/assets/.claude/agents/xp-user-representative.md +204 -0
  12. package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +49 -57
  13. package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +54 -58
  14. package/lib/assets/.claude/skills/analyzing-business/SKILL.md +52 -74
  15. package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +50 -53
  16. package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +56 -56
  17. package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +56 -109
  18. package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +61 -57
  19. package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +61 -57
  20. package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +57 -55
  21. package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +66 -67
  22. package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +58 -56
  23. package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +51 -57
  24. package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +45 -60
  25. package/lib/assets/.claude/skills/creating-adr/SKILL.md +38 -40
  26. package/lib/assets/.claude/skills/developing-backend/SKILL.md +49 -55
  27. package/lib/assets/.claude/skills/developing-frontend/SKILL.md +47 -50
  28. package/lib/assets/.claude/skills/developing-release/SKILL.md +60 -95
  29. package/lib/assets/.claude/skills/generating-slides/SKILL.md +58 -100
  30. package/lib/assets/.claude/skills/git-commit/SKILL.md +27 -52
  31. package/lib/assets/.claude/skills/killing-processes/SKILL.md +16 -70
  32. package/lib/assets/.claude/skills/operating-backup/SKILL.md +59 -0
  33. package/lib/assets/.claude/skills/operating-cicd/SKILL.md +54 -0
  34. package/lib/assets/.claude/skills/operating-deploy/SKILL.md +67 -0
  35. package/lib/assets/.claude/skills/{managing-docs → operating-docs}/SKILL.md +1 -1
  36. package/lib/assets/.claude/skills/operating-provision/SKILL.md +77 -0
  37. package/lib/assets/.claude/skills/operating-setup/SKILL.md +63 -0
  38. package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +65 -95
  39. package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +60 -155
  40. package/lib/assets/.claude/skills/orchestrating-operation/SKILL.md +158 -0
  41. package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +60 -119
  42. package/lib/assets/.claude/skills/planning-releases/SKILL.md +63 -168
  43. package/lib/assets/.claude/skills/syncing-github-project/SKILL.md +62 -266
  44. package/lib/assets/.claude/skills/tracking-progress/SKILL.md +49 -122
  45. package/lib/assets/CLAUDE.md +7 -2
  46. package/lib/assets/README.md +3 -34
  47. package/lib/assets/docs/development/index.md +14 -8
  48. package/lib/assets/docs/index.md +1 -0
  49. 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
  50. package/lib/assets/docs/reference/index.md +1 -0
  51. 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
  52. package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +69 -5
  53. 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
  54. 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
  55. 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
  56. 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
  57. package/lib/assets/docs/template//350/250/255/350/250/210.md +12 -2
  58. 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
  59. package/lib/assets/gulpfile.js +2 -0
  60. package/lib/assets/mkdocs.yml +1 -0
  61. package/lib/assets/ops/docker/sonarqube-local/docker-compose.yml +57 -0
  62. package/lib/assets/ops/scripts/sonar_local.js +726 -0
  63. package/package.json +1 -1
  64. package/lib/assets/.claude/SKILLS_TEMPLATE.md +0 -100
  65. package/lib/assets/.claude/agents/roles/.gitkeep +0 -0
  66. package/lib/assets/.claude/skills/managing-operations/DEPLOY.md +0 -77
  67. package/lib/assets/.claude/skills/managing-operations/SETUP_CSHARP.md +0 -80
  68. package/lib/assets/.claude/skills/managing-operations/SETUP_FRONTEND.md +0 -84
  69. package/lib/assets/.claude/skills/managing-operations/SETUP_JAVA.md +0 -75
  70. 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 に反映し同期。GitHub でのプロジェクト管理一元化時に使用。
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
- ## Instructions
10
+ `docs/development/release_plan.md` を正とし、GitHub は同期先として扱う。手動で GitHub を直接更新するのではなく、計画ドキュメントを更新してから `--sync` で反映する。
11
11
 
12
- ### 1. オプション
12
+ ## オプション
13
13
 
14
- - なし : 全体の同期を実行(Project 作成、Issue 作成、フィールド設定、Milestone 作成)
15
- - `--project` : GitHub Project のみを作成
16
- - `--issues` : Issue のみを作成(Project が存在する前提)
17
- - `--fields` : Issue に対して Project フィールド値を個別に設定
18
- - `--milestones` : Milestone のみを作成し Issue に割り当て
19
- - `--sync` : release_plan.md GitHub の差異を確認し、差異があれば同期を実行
20
- - `--status` : 現在の GitHub Project 状態を表示
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
- ### 2. 基本例
24
+ ## GitHub Project の作成
23
25
 
24
- ```bash
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
- | **Status** | Single Select | Todo / In Progress / Done(デフォルト) |
46
- | **リリース** | Single Select | release_plan.md のリリースフェーズに対応 |
47
- | **優先度** | Single Select | ストーリーの優先度 |
48
- | **SP** | Number | ストーリーポイント(数値) |
49
- | **イテレーション** | **Iteration** | スプリント期間(開始日・期間付き) |
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>,<選択肢3>"
59
- ```
42
+ --single-select-options "<選択肢1>,<選択肢2>"
60
43
 
61
- **Number フィールドの作成**:
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
- ### 4. Issue の作成
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
- ### 5. フィールド値の設定
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
- ```bash
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
- **Iteration フィールドの ID と各イテレーション ID の取得**:
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
- ### 6. Milestone の作成
100
+ ## 差異確認と同期(--sync)
212
101
 
213
- リリースフェーズを GitHub Milestone として作成し、Issue に割り当てます。
102
+ release_plan.md GitHub の整合性を確認し、差異があれば同期を実行する。
214
103
 
215
- ```bash
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
- 1. release_plan.md GitHub Issue/Project の差異を検出
242
- 2. 差異レポートを表示(追加/変更/削除項目)
243
- 3. 差異がある場合は同期を実行:
108
+ - **新規ストーリー**: Issue を作成し Project に追加する
109
+ - **変更されたストーリー**: Issue のフィールド値を更新する
110
+ - **削除されたストーリー**: Issue をクローズする(削除はしない)
244
111
 
245
- - **新規ストーリー**: Issue を作成し Project に追加
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[Issue に Milestone 割当]
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
- ### 10. 注意事項
324
-
325
- - **前提条件**:
126
+ ## 途中から再開
326
127
 
327
- - `docs/development/release_plan.md` が存在すること
328
- - `gh` CLI がインストールされ認証済みであること
329
- - Project API スコープが有効であること(`gh auth refresh -s project,read:project`)
128
+ 同期作業の途中から再開する場合は、まず現在の GitHub 状態を確認する。
330
129
 
331
- - **制限事項**:
130
+ **Example:**
332
131
 
333
- - 既存の Project/Issue がある場合は重複作成に注意
334
- - フィールド値の更新は既存値を上書き
335
- - Iteration フィールドの期間変更は GraphQL API または Web UI で実施
336
-
337
- - **推奨事項**:
338
-
339
- - 初回は `--sync` で差異確認してから同期
340
- - 大規模な変更前にはバックアップを推奨
132
+ ```
133
+ ユーザー: 「Project と Issue は作成済み。フィールド値を設定したい」
134
+ 回答: --status で現在の GitHub 状態を確認する。
135
+ --fields でフィールド値を一括設定する。
136
+ 設定後に --sync で release_plan.md との整合性を検証する。
137
+ ```
341
138
 
342
- ### 11. ベストプラクティス
139
+ ## 注意事項
343
140
 
344
- 1. **初回同期**: 全体を一括作成
345
- 2. **計画更新時**: `--sync` で差異確認と自動同期
346
- 3. **定期確認**: `--status` で進捗状況を定期的に確認
347
- 4. **一貫性維持**: release_plan.md を Single Source of Truth として管理し、`--sync` で GitHub に反映
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
- ## Instructions
10
+ ## オプション
11
11
 
12
- ### 1. オプション
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
- ### 2. 基本例
24
+ - **イテレーション達成度**: 計画 vs 実績の比較分析(SP、ストーリー数、期間)
25
+ - **技術実装状況**: 機能完成度・テスト結果・ビルド状態
26
+ - **品質メトリクス**: テストカバレッジ、静的解析結果、コード複雑度
27
+ - **ドキュメント整備**: 計画書・仕様書・手順書の最新性
23
28
 
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
- ```
29
+ ## --update オプションの詳細
69
30
 
70
- ### 5. 品質メトリクス取得
31
+ `docs/development/` 内のドキュメントを現在の進捗に合わせて自動更新する。
71
32
 
72
- 実装品質の定量的評価:
33
+ **更新対象**:
73
34
 
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. **振り返りセクション**: メトリクス実績値を記入
35
+ - `docs/development/release_plan.md` 進捗状況テーブル、リリース条件チェック、バーンダウン実績値
36
+ - `docs/development/iteration_plan-*.md` — 成功基準チェック、タスク状態、完了条件(DoD)、メトリクス実績値
100
37
 
101
38
  **更新判定の情報源**:
102
39
 
103
40
  ```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/
41
+ git log --oneline --since="2 weeks ago" # 実装状況の分析
42
+ dotnet test --logger trx # テスト結果の取得
43
+ npm test -- --coverage # カバレッジの取得
114
44
  ```
115
45
 
116
- ### 7. 出力例
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 (予約機能): 計画済み (8 営業日予定)
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
- ### 8. 注意事項
66
+ ## 途中から再開
67
+
68
+ 進捗追跡の途中から再開する場合は、前回の追跡結果を確認する。
145
69
 
146
- - **前提条件**: Git リポジトリ内で実行、プロジェクト構造を理解
147
- - **情報取得**: 実行時点での動的な状況を総合的に分析
148
- - **推奨事項**: 重要な節目や問題発生時の定期的な進捗確認
149
- - **--update 使用時**: 更新前に Git でコミットしておくことを推奨(変更のロールバック用)
70
+ **Example:**
71
+
72
+ ```
73
+ ユーザー: 「イテレーション 2 の中間進捗を確認したい」
74
+ 回答: --iteration 2 で現在の達成状況を分析する。
75
+ 計画 SP と完了 SP を比較し、残りの期間で完了可能か評価する。
76
+ 遅延リスクがあれば早期に報告する。
77
+ ```
150
78
 
151
- ### 9. ベストプラクティス
79
+ ## 注意事項
152
80
 
153
- 1. **定期実行**: イテレーション開始・終了時の進捗確認
154
- 2. **問題発見**: 遅延や品質低下の早期発見に活用
155
- 3. **ステークホルダー報告**: 詳細レポートを会議資料として活用
156
- 4. **改善指標**: 進捗データを基にした開発プロセス改善
157
- 5. **ドキュメント同期**: イテレーション完了時に `--update` docs/development を同期
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` イテレーション計画の作成・更新
@@ -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
- | `managing-operations` | 環境構築・デプロイ・監視 |
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
- | `managing-docs` | ドキュメント管理・Lint |
75
+ | `operating-docs` | ドキュメント管理・Lint |
71
76
  | `generating-slides` | インセプションデッキのスライド生成 |
72
77
  | `git-commit` | Conventional Commits 準拠のコミット |
73
78
  | `creating-adr` | ADR 作成 |