@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,64 +1,42 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: developing-release
|
|
3
|
-
description:
|
|
3
|
+
description: アプリケーションのリリースワークフローを一貫実行。品質ゲート→バージョンバンプ→CHANGELOG 生成→git commit + tag を自動化する。「リリースしたい」「バージョンを上げたい」「CHANGELOG を生成したい」「リリース前のチェックをしたい」といった場面で発動する。リリース手順を標準化することで、ヒューマンエラーを排除し、いつでも安全にリリースできる状態を維持する。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# リリースワークフロー
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
品質ゲート→バージョンバンプ→CHANGELOG 生成→git commit + tag を一貫して実行する。
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
リリースを自動化する価値は「いつでもリリースできる」状態を維持すること。手作業によるミスを排除し、品質ゲートで最低品質を保証する。
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
## 参照ドキュメント
|
|
13
13
|
|
|
14
|
-
- @docs/reference/リリースガイド.md
|
|
14
|
+
- @docs/reference/リリースガイド.md — リリースワークフロー全体
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
## オプション
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
| オプション | 説明 |
|
|
19
|
+
|-----------|------|
|
|
20
|
+
| なし | ドライランを実行(デフォルト) |
|
|
21
|
+
| `--dry-run` | CHANGELOG プレビュー + バージョン計算 |
|
|
22
|
+
| `--patch` | パッチリリース(バグ修正) |
|
|
23
|
+
| `--minor` | マイナーリリース(新機能追加、後方互換あり) |
|
|
24
|
+
| `--major` | メジャーリリース(破壊的変更) |
|
|
25
|
+
| `--preflight` | 品質ゲートのみ実行 |
|
|
26
|
+
| `--deploy` | リリース + デプロイ(`--patch` / `--minor` / `--major` と併用) |
|
|
19
27
|
|
|
20
|
-
|
|
21
|
-
2. **リリース種別選択**: patch / minor / major を選択
|
|
22
|
-
3. **品質ゲート(preflight)**: 全チェックを通過
|
|
23
|
-
4. **リリース実行**: バージョンバンプ → CHANGELOG 生成 → commit + tag
|
|
24
|
-
5. **リモートプッシュ**: コミットとタグをプッシュ
|
|
25
|
-
6. **デプロイ**: 必要に応じて本番デプロイ
|
|
28
|
+
## リリースフロー
|
|
26
29
|
|
|
27
|
-
|
|
30
|
+
1. **ドライラン**: CHANGELOG プレビューとバージョン計算を確認する
|
|
31
|
+
2. **リリース種別選択**: patch / minor / major を選択する
|
|
32
|
+
3. **品質ゲート(preflight)**: 全チェックを通過する
|
|
33
|
+
4. **リリース実行**: バージョンバンプ→CHANGELOG 生成→commit + tag
|
|
34
|
+
5. **リモートプッシュ**: コミットとタグをプッシュする
|
|
35
|
+
6. **デプロイ**: 必要に応じて本番デプロイを実行する
|
|
28
36
|
|
|
29
|
-
|
|
30
|
-
- `--dry-run` : CHANGELOG プレビュー + バージョン計算
|
|
31
|
-
- `--patch` : パッチリリース(バグ修正)
|
|
32
|
-
- `--minor` : マイナーリリース(新機能追加、後方互換あり)
|
|
33
|
-
- `--major` : メジャーリリース(破壊的変更)
|
|
34
|
-
- `--preflight` : 品質ゲートのみ実行
|
|
35
|
-
- `--deploy` : リリース + デプロイ(`--patch` / `--minor` / `--major` と併用)
|
|
37
|
+
## 品質ゲート(preflight)
|
|
36
38
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
```bash
|
|
40
|
-
# ドライラン(プレビュー)
|
|
41
|
-
npm run release:dry-run
|
|
42
|
-
|
|
43
|
-
# パッチリリース
|
|
44
|
-
npm run release:patch
|
|
45
|
-
|
|
46
|
-
# マイナーリリース
|
|
47
|
-
npm run release:minor
|
|
48
|
-
|
|
49
|
-
# メジャーリリース
|
|
50
|
-
npm run release:major
|
|
51
|
-
|
|
52
|
-
# 品質ゲートのみ実行
|
|
53
|
-
npm run release:preflight
|
|
54
|
-
|
|
55
|
-
# パッチリリース + デプロイ
|
|
56
|
-
npm run release:deploy:patch
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
### 5. 品質ゲート(preflight)
|
|
60
|
-
|
|
61
|
-
リリース前に以下のチェックを直列実行します。全チェック通過が必須です:
|
|
39
|
+
リリース前に以下のチェックを直列実行する。全チェック通過が必須。
|
|
62
40
|
|
|
63
41
|
| チェック | コマンド | 内容 |
|
|
64
42
|
| :--- | :--- | :--- |
|
|
@@ -68,9 +46,9 @@ npm run release:deploy:patch
|
|
|
68
46
|
| ビルド確認 | `release:preflight:build` | ビルド成功 |
|
|
69
47
|
| E2E テスト | `release:preflight:e2e` | E2E テスト全パス |
|
|
70
48
|
|
|
71
|
-
|
|
49
|
+
## バージョニング規則
|
|
72
50
|
|
|
73
|
-
[Semantic Versioning](https://semver.org/)
|
|
51
|
+
[Semantic Versioning](https://semver.org/) に従う。
|
|
74
52
|
|
|
75
53
|
| 種類 | 変更例 | バージョン変化 |
|
|
76
54
|
| :--- | :--- | :--- |
|
|
@@ -78,11 +56,11 @@ npm run release:deploy:patch
|
|
|
78
56
|
| `minor` | 新機能追加(後方互換あり) | `0.1.0` → `0.2.0` |
|
|
79
57
|
| `major` | 破壊的変更 | `0.1.0` → `1.0.0` |
|
|
80
58
|
|
|
81
|
-
|
|
59
|
+
モノレポ構成の場合、全パッケージのバージョンを同期管理する。
|
|
82
60
|
|
|
83
|
-
|
|
61
|
+
## CHANGELOG 生成ルール
|
|
84
62
|
|
|
85
|
-
[Conventional Commits](https://www.conventionalcommits.org/)
|
|
63
|
+
[Conventional Commits](https://www.conventionalcommits.org/) に基づいて自動生成する。
|
|
86
64
|
|
|
87
65
|
| prefix | カテゴリ |
|
|
88
66
|
| :--- | :--- |
|
|
@@ -91,64 +69,51 @@ npm run release:deploy:patch
|
|
|
91
69
|
| `docs` | Documentation |
|
|
92
70
|
| `refactor` | Refactoring |
|
|
93
71
|
| `test` | Tests |
|
|
94
|
-
| `chore` |
|
|
95
|
-
| `perf` | Performance |
|
|
96
|
-
| `ci` | CI |
|
|
97
|
-
| `style` | Styles |
|
|
98
|
-
| `build` | Build |
|
|
72
|
+
| `chore` / `perf` / `ci` / `style` / `build` | その他 |
|
|
99
73
|
|
|
100
|
-
|
|
101
|
-
- タグが存在しない場合は全コミット履歴を対象
|
|
102
|
-
- `CHANGELOG.md` の先頭に新しいエントリを追加
|
|
74
|
+
直近の git tag から HEAD までのコミットを対象とする。タグが存在しない場合は全コミット履歴を対象とする。
|
|
103
75
|
|
|
104
|
-
|
|
76
|
+
## リリース実行ステップ
|
|
105
77
|
|
|
106
78
|
| ステップ | 内容 |
|
|
107
79
|
| :--- | :--- |
|
|
108
|
-
| [1/4] バージョン更新 |
|
|
109
|
-
| [2/4] CHANGELOG 生成 |
|
|
110
|
-
| [3/4] git commit + tag |
|
|
80
|
+
| [1/4] バージョン更新 | セマンティックバージョニングに従って更新 |
|
|
81
|
+
| [2/4] CHANGELOG 生成 | コミットを分類し CHANGELOG.md を生成 |
|
|
82
|
+
| [3/4] git commit + tag | `release: vX.X.X` でコミット→`vX.X.X` タグ作成 |
|
|
111
83
|
| [4/4] サマリー表示 | バージョン変化、タグ名、次のステップを表示 |
|
|
112
84
|
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
- **working tree がクリーンでない**: 変更をコミットまたは `git stash` してからリリース再実行
|
|
116
|
-
- **テスト失敗**: テストを修正してからリリースを再実行
|
|
117
|
-
- **リリースを元に戻したい**: リモートプッシュ前なら `git tag -d vX.X.X && git reset --hard HEAD~1`
|
|
118
|
-
|
|
119
|
-
### 10. コンテキスト管理
|
|
85
|
+
## 途中から再開
|
|
120
86
|
|
|
121
|
-
|
|
87
|
+
リリース作業の途中から再開する場合は、現在の状態を確認する。
|
|
122
88
|
|
|
123
|
-
|
|
89
|
+
**Example:**
|
|
124
90
|
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
91
|
+
```
|
|
92
|
+
ユーザー: 「品質ゲートは通った。リリースを実行したい」
|
|
93
|
+
回答: --preflight の結果を確認し、全チェック通過を検証する。
|
|
94
|
+
--patch / --minor / --major のいずれかでリリースを実行する。
|
|
95
|
+
```
|
|
129
96
|
|
|
130
|
-
|
|
97
|
+
## トラブルシューティング
|
|
131
98
|
|
|
132
|
-
|
|
133
|
-
|
|
99
|
+
- **working tree がクリーンでない**: 変更をコミットまたは `git stash` してからリリース再実行する
|
|
100
|
+
- **テスト失敗**: テストを修正してからリリースを再実行する
|
|
101
|
+
- **リリースを元に戻したい**: リモートプッシュ前なら `git tag -d vX.X.X && git reset --hard HEAD~1`
|
|
134
102
|
|
|
135
|
-
|
|
103
|
+
## コンテキスト管理
|
|
136
104
|
|
|
137
|
-
|
|
138
|
-
- **制限事項**: working tree がクリーンでないとリリース不可
|
|
139
|
-
- **推奨事項**: リリース前に必ずドライランで内容を確認
|
|
105
|
+
品質ゲート完了後、CHANGELOG 生成後、リリースコミット完了後に `/compact` を実施する。
|
|
140
106
|
|
|
141
|
-
|
|
107
|
+
## 注意事項
|
|
142
108
|
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
5. **段階的デプロイ**: リリースとデプロイを分離し、必要に応じてデプロイを実行
|
|
109
|
+
- ビルドツール・パッケージマネージャーがセットアップ済み、依存関係インストール済みであること(前提条件)
|
|
110
|
+
- working tree がクリーンでないとリリース不可
|
|
111
|
+
- リリース前に必ずドライランで内容を確認する
|
|
112
|
+
- Conventional Commits でコミットメッセージを記述し CHANGELOG の品質を確保する
|
|
148
113
|
|
|
149
|
-
|
|
114
|
+
## 関連スキル
|
|
150
115
|
|
|
151
|
-
- `git-commit`
|
|
152
|
-
- `managing-operations`
|
|
153
|
-
- `planning-releases`
|
|
154
|
-
- `orchestrating-development`
|
|
116
|
+
- `git-commit` — Conventional Commits 準拠のコミット作成
|
|
117
|
+
- `managing-operations` — デプロイ・運用管理
|
|
118
|
+
- `planning-releases` — リリース・イテレーション計画
|
|
119
|
+
- `orchestrating-development` — 開発フェーズ全体のワークフロー
|
|
@@ -1,82 +1,64 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: generating-slides
|
|
3
|
-
description: インセプションデッキの Markdown
|
|
3
|
+
description: インセプションデッキの Markdown から PowerPoint スライド(.pptx)を自動生成。pptxgenjs を使用し、テンプレート準拠の 12 枚構成プレゼンテーションを出力する。「スライドを生成したい」「インセプションデッキの pptx を作りたい」「プレゼン資料を出力したい」「スライドを更新したい」といった場面で発動する。Markdown から自動生成することで、内容更新のたびに手動でスライドを作り直す手間を排除する。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# スライド生成
|
|
7
7
|
|
|
8
|
-
インセプションデッキの Markdown
|
|
8
|
+
インセプションデッキの Markdown ドキュメントから pptxgenjs を使用して PowerPoint スライド(.pptx)を生成する。テンプレートのスライド構成・テーマに準拠した 12 枚構成のプレゼンテーションを出力する。
|
|
9
9
|
|
|
10
|
-
##
|
|
10
|
+
## 参照ドキュメントと成果物
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
| 種類 | パス | 備考 |
|
|
13
|
+
|------|------|------|
|
|
14
|
+
| テンプレート | @docs/template/インセプションデッキ.pptx | スライド構成のリファレンス(15 枚、4:3) |
|
|
15
|
+
| 生成スクリプト | @.claude/scripts/generate-inception-deck.mjs | 内容の編集は可能 |
|
|
16
|
+
| 入力 | @docs/analysis/inception-deck.md | `analyzing-inception-deck` の成果物 |
|
|
17
|
+
| 入力(補足) | @docs/analysis/business_architecture.md | ビジネスアーキテクチャ分析書 |
|
|
18
|
+
| 成果物 | `docs/analysis/slide/xxxxx_v0.1.0.pptx` | 生成された PowerPoint スライド |
|
|
13
19
|
|
|
14
|
-
|
|
20
|
+
## スライド構成(12 枚)
|
|
15
21
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
- @.claude/scripts/generate-inception-deck.mjs - スライド生成スクリプト(**内容の編集は可能**)
|
|
19
|
-
|
|
20
|
-
### 3. 入力
|
|
21
|
-
|
|
22
|
-
- @docs/analysis/inception-deck.md - インセプションデッキ(`analyzing-inception-deck` の成果物)
|
|
23
|
-
- @docs/analysis/business_architecture.md - ビジネスアーキテクチャ分析書(補足情報)
|
|
24
|
-
|
|
25
|
-
### 4. 成果物
|
|
26
|
-
|
|
27
|
-
- @docs/analysis/slide/xxxxx_v0.1.0.pptx - 生成された PowerPoint スライド
|
|
28
|
-
|
|
29
|
-
### 5. 作業内容
|
|
30
|
-
|
|
31
|
-
#### 前提条件の確認
|
|
32
|
-
|
|
33
|
-
- Node.js がインストールされていること
|
|
34
|
-
- `pptxgenjs` パッケージがインストールされていること(未インストール時は `npm install pptxgenjs`)
|
|
35
|
-
|
|
36
|
-
#### スライド生成の実行
|
|
37
|
-
|
|
38
|
-
```bash
|
|
39
|
-
node .claude/scripts/generate-inception-deck.mjs
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
#### スライド構成(12 枚)
|
|
43
|
-
|
|
44
|
-
テンプレートのインセプションデッキ構成に準拠した以下の 12 枚を生成する。
|
|
45
|
-
|
|
46
|
-
| # | スライドタイトル | テンプレート対応 | データソース |
|
|
22
|
+
| # | スライドタイトル | SLIDE_DATA キー | データソース |
|
|
47
23
|
| :--- | :--- | :--- | :--- |
|
|
48
|
-
| 1 | タイトル |
|
|
49
|
-
| 2 | 我われはなぜここにいるのか |
|
|
50
|
-
| 3 | エレベーターピッチ |
|
|
51
|
-
| 4 | どんな価値をもたらすのか? |
|
|
52
|
-
| 5 | やらないことリスト |
|
|
53
|
-
| 6 | プロジェクトコミュニティ |
|
|
54
|
-
| 7 | 技術的な解決策の概要 |
|
|
55
|
-
| 8 | 夜も眠れなくなるような問題 |
|
|
56
|
-
| 9 | 俺たちの "A チーム" |
|
|
57
|
-
| 10 | 期間を見極める |
|
|
58
|
-
| 11 | トレードオフ・スライダー |
|
|
59
|
-
| 12 | 初回のリリースに必要なもの |
|
|
60
|
-
|
|
61
|
-
|
|
24
|
+
| 1 | タイトル | `titleSlide` | プロジェクト基本情報 |
|
|
25
|
+
| 2 | 我われはなぜここにいるのか | `whyAreWeHere` | なぜやるのか? |
|
|
26
|
+
| 3 | エレベーターピッチ | `elevatorPitch` | どんなビジョンなのか? |
|
|
27
|
+
| 4 | どんな価値をもたらすのか? | `values` | どんな価値をもたらすのか? |
|
|
28
|
+
| 5 | やらないことリスト | `scope` | スコープの範囲はどこか? |
|
|
29
|
+
| 6 | プロジェクトコミュニティ | `stakeholders` | 主なステークホルダーは? |
|
|
30
|
+
| 7 | 技術的な解決策の概要 | `technicalSolution` | 基本的な解決策 |
|
|
31
|
+
| 8 | 夜も眠れなくなるような問題 | `risks` | 主なリスクは何か? |
|
|
32
|
+
| 9 | 俺たちの "A チーム" | `team` | どのくらい作業があり費用はいくらか? |
|
|
33
|
+
| 10 | 期間を見極める | `timeline` | 初回リリースはいつか? |
|
|
34
|
+
| 11 | トレードオフ・スライダー | `tradeoffs` | トレードオフにどう向き合うか? |
|
|
35
|
+
| 12 | 初回のリリースに必要なもの | `initialRelease` | MVP スコープ・リリース戦略 |
|
|
36
|
+
|
|
37
|
+
## テーマ設定
|
|
62
38
|
|
|
63
39
|
テンプレートから抽出したテーマに準拠する。
|
|
64
40
|
|
|
65
|
-
- **フォント**: Yu Gothic(游ゴシック)— Windows / Mac
|
|
41
|
+
- **フォント**: Yu Gothic(游ゴシック)— Windows / Mac 両対応
|
|
66
42
|
- **テーマカラー**: ダークブルー `#333399`、ティール `#009999`、ライトティール `#BBE0E3`
|
|
67
43
|
- **スライドサイズ**: 4:3(10" x 7.5")
|
|
68
44
|
|
|
69
|
-
|
|
45
|
+
## 生成の進め方
|
|
46
|
+
|
|
47
|
+
### 新規生成
|
|
70
48
|
|
|
71
|
-
|
|
49
|
+
1. `npm install pptxgenjs`(初回のみ)
|
|
50
|
+
2. `docs/analysis/inception-deck.md` の内容を確認する
|
|
51
|
+
3. `.claude/scripts/generate-inception-deck.mjs` の `SLIDE_DATA` をプロジェクト固有の内容に書き換える
|
|
52
|
+
4. `node .claude/scripts/generate-inception-deck.mjs` を実行する
|
|
53
|
+
5. `docs/analysis/slide/` に .pptx が生成されたことを確認する
|
|
72
54
|
|
|
73
|
-
|
|
74
|
-
2. @.claude/scripts/generate-inception-deck.mjs の `SLIDE_DATA` セクションを更新
|
|
75
|
-
3. `node .claude/scripts/generate-inception-deck.mjs` で再生成
|
|
55
|
+
### 更新時の再生成
|
|
76
56
|
|
|
77
|
-
|
|
57
|
+
1. `docs/analysis/inception-deck.md` の更新内容を確認する
|
|
58
|
+
2. `.claude/scripts/generate-inception-deck.mjs` の `SLIDE_DATA` を更新する
|
|
59
|
+
3. `node .claude/scripts/generate-inception-deck.mjs` を実行する
|
|
78
60
|
|
|
79
|
-
|
|
61
|
+
## スクリプト構成
|
|
80
62
|
|
|
81
63
|
| セクション | 内容 | 編集対象 |
|
|
82
64
|
| :--- | :--- | :--- |
|
|
@@ -85,52 +67,28 @@ inception-deck.md の内容が更新された場合、生成スクリプトの `
|
|
|
85
67
|
| ヘルパー関数 | スライド部品の描画ロジック | 通常変更不要 |
|
|
86
68
|
| スライド生成 | `SLIDE_DATA` を読み取り 12 枚を生成 | 通常変更不要 |
|
|
87
69
|
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
| キー | 対応スライド |
|
|
91
|
-
| :--- | :--- |
|
|
92
|
-
| `meta` | メタ情報(author, title, version, date, outputFileName) |
|
|
93
|
-
| `titleSlide` | Slide 1: タイトル |
|
|
94
|
-
| `whyAreWeHere` | Slide 2: 我われはなぜここにいるのか |
|
|
95
|
-
| `elevatorPitch` | Slide 3: エレベーターピッチ |
|
|
96
|
-
| `values` | Slide 4: どんな価値をもたらすのか? |
|
|
97
|
-
| `scope` | Slide 5: やらないことリスト |
|
|
98
|
-
| `stakeholders` | Slide 6: プロジェクトコミュニティ |
|
|
99
|
-
| `technicalSolution` | Slide 7: 技術的な解決策の概要 |
|
|
100
|
-
| `risks` | Slide 8: 夜も眠れなくなるような問題 |
|
|
101
|
-
| `team` | Slide 9: 俺たちの "A チーム" |
|
|
102
|
-
| `timeline` | Slide 10: 期間を見極める |
|
|
103
|
-
| `tradeoffs` | Slide 11: トレードオフ・スライダー |
|
|
104
|
-
| `initialRelease` | Slide 12: 初回のリリースに必要なもの |
|
|
105
|
-
|
|
106
|
-
#### バージョン管理
|
|
70
|
+
## 途中から再開
|
|
107
71
|
|
|
108
|
-
|
|
109
|
-
- `meta.title` と `meta.outputFileName` を同時に更新すること
|
|
72
|
+
スライドの一部を修正したい場合は、`SLIDE_DATA` の該当キーのみを更新して再生成する。
|
|
110
73
|
|
|
111
|
-
|
|
74
|
+
**Example:**
|
|
112
75
|
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
### インセプションデッキのスライドを新規生成
|
|
120
|
-
|
|
121
|
-
1. `npm install pptxgenjs`(初回のみ)
|
|
122
|
-
2. @docs/analysis/inception-deck.md の内容を確認
|
|
123
|
-
3. @.claude/scripts/generate-inception-deck.mjs の `SLIDE_DATA` をプロジェクト固有の内容に書き換える
|
|
124
|
-
4. `node .claude/scripts/generate-inception-deck.mjs` を実行
|
|
125
|
-
5. @docs/analysis/slide/ に .pptx が生成されたことを確認
|
|
76
|
+
```
|
|
77
|
+
ユーザー: 「エレベーターピッチの内容が変わった。スライドを更新したい」
|
|
78
|
+
回答: inception-deck.md の更新内容を確認し、
|
|
79
|
+
SLIDE_DATA.elevatorPitch のみを更新して再生成する。
|
|
80
|
+
出力ファイル名の meta.outputFileName のバージョンも更新する。
|
|
81
|
+
```
|
|
126
82
|
|
|
127
|
-
|
|
83
|
+
## 注意事項
|
|
128
84
|
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
85
|
+
- `docs/analysis/inception-deck.md` が作成済みであること(`analyzing-inception-deck` を先に実行する)
|
|
86
|
+
- テンプレート `docs/template/インセプションデッキ.pptx` は編集しない
|
|
87
|
+
- 日本語フォントは Yu Gothic を使用する(Gill Sans 等の欧文フォントは文字化けする)
|
|
88
|
+
- 出力ファイル名は `SLIDE_DATA.meta.outputFileName` で指定する。`meta.title` と同時に更新する
|
|
89
|
+
- 生成後は PowerPoint で開いてレイアウトを目視確認し、必要に応じてスクリプトのレイアウトパラメータを微調整する
|
|
132
90
|
|
|
133
|
-
|
|
91
|
+
## 関連スキル
|
|
134
92
|
|
|
135
|
-
- `analyzing-inception-deck`
|
|
136
|
-
- `analyzing-business`
|
|
93
|
+
- `analyzing-inception-deck` — 入力となるインセプションデッキの作成
|
|
94
|
+
- `analyzing-business` — ビジネスアーキテクチャ分析(補足情報の参照元)
|
|
@@ -1,47 +1,41 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: git-commit
|
|
3
|
-
description:
|
|
3
|
+
description: Conventional Commits 準拠の Git コミットを作成。意味のある変更単位でステージングし、日本語で明確なコミットメッセージを記述する。「コミットしたい」「変更を保存したい」「コミットメッセージの書き方を知りたい」といった場面で発動する。コミット履歴を意味のある単位で保つことで、変更の追跡とロールバックを容易にする。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Git
|
|
6
|
+
# Git コミット
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
意味のある変更単位ごとにコミットを行う。コミット履歴はコードの「変更理由の記録」であり、将来の自分やチームメンバーが変更を追跡するための重要な情報源になる。
|
|
9
9
|
|
|
10
|
-
##
|
|
10
|
+
## コミット手順
|
|
11
11
|
|
|
12
12
|
### 1. 変更を確認する
|
|
13
13
|
|
|
14
|
-
まず、現在のワーキングディレクトリでの変更を確認します:
|
|
15
|
-
|
|
16
14
|
```bash
|
|
17
15
|
git status
|
|
18
16
|
```
|
|
19
17
|
|
|
20
18
|
### 2. 変更をステージングする
|
|
21
19
|
|
|
22
|
-
変更をコミットする前に、ステージングエリアに追加する必要があります:
|
|
23
|
-
|
|
24
20
|
```bash
|
|
25
21
|
git add 対象ファイルやディレクトリ
|
|
26
22
|
```
|
|
27
23
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
### 3. コミットメッセージを作成する
|
|
24
|
+
意味のある変更単位ごとにファイルを指定する。無条件にすべての変更を追加しない。
|
|
31
25
|
|
|
32
|
-
|
|
26
|
+
### 3. コミットする
|
|
33
27
|
|
|
34
28
|
```bash
|
|
35
|
-
git commit -m "
|
|
29
|
+
git commit -m "コミットメッセージ"
|
|
36
30
|
```
|
|
37
31
|
|
|
38
|
-
|
|
32
|
+
### 4. コミットを確認する
|
|
39
33
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
34
|
+
```bash
|
|
35
|
+
git log --oneline
|
|
36
|
+
```
|
|
43
37
|
|
|
44
|
-
|
|
38
|
+
## Conventional Commits フォーマット
|
|
45
39
|
|
|
46
40
|
```
|
|
47
41
|
<type>(<scope>): <subject>
|
|
@@ -51,56 +45,37 @@ git commit -m "コミットメッセージをここに入力"
|
|
|
51
45
|
<footer>
|
|
52
46
|
```
|
|
53
47
|
|
|
54
|
-
**type
|
|
55
|
-
- `feat`: 新機能
|
|
56
|
-
- `fix`: バグ修正
|
|
57
|
-
- `docs`: ドキュメントのみの変更
|
|
58
|
-
- `style`: コードの意味に影響しない変更(空白、フォーマット等)
|
|
59
|
-
- `refactor`: バグ修正や機能追加ではないコード変更
|
|
60
|
-
- `test`: テストの追加・修正
|
|
61
|
-
- `chore`: ビルドプロセスやツールの変更
|
|
62
|
-
|
|
63
|
-
### 4. コミットを確認する
|
|
48
|
+
**type の種類**:
|
|
64
49
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
50
|
+
| type | 用途 |
|
|
51
|
+
|------|------|
|
|
52
|
+
| `feat` | 新機能 |
|
|
53
|
+
| `fix` | バグ修正 |
|
|
54
|
+
| `docs` | ドキュメントのみの変更 |
|
|
55
|
+
| `style` | コードの意味に影響しない変更(空白、フォーマット等) |
|
|
56
|
+
| `refactor` | バグ修正や機能追加ではないコード変更 |
|
|
57
|
+
| `test` | テストの追加・修正 |
|
|
58
|
+
| `chore` | ビルドプロセスやツールの変更 |
|
|
70
59
|
|
|
71
60
|
## Examples
|
|
72
61
|
|
|
73
|
-
### 機能追加のコミット
|
|
74
|
-
|
|
75
62
|
```bash
|
|
76
63
|
git add src/features/user-auth.ts
|
|
77
64
|
git commit -m "feat(auth): ユーザー認証機能を追加"
|
|
78
|
-
```
|
|
79
65
|
|
|
80
|
-
### バグ修正のコミット
|
|
81
|
-
|
|
82
|
-
```bash
|
|
83
66
|
git add src/utils/validation.ts
|
|
84
67
|
git commit -m "fix(validation): メールアドレスのバリデーションエラーを修正"
|
|
85
|
-
```
|
|
86
68
|
|
|
87
|
-
### ドキュメント更新のコミット
|
|
88
|
-
|
|
89
|
-
```bash
|
|
90
69
|
git add README.md docs/setup.md
|
|
91
70
|
git commit -m "docs: セットアップ手順を更新"
|
|
92
|
-
```
|
|
93
71
|
|
|
94
|
-
### リファクタリングのコミット
|
|
95
|
-
|
|
96
|
-
```bash
|
|
97
72
|
git add src/services/api.ts
|
|
98
73
|
git commit -m "refactor(api): API クライアントの共通処理を抽出"
|
|
99
74
|
```
|
|
100
75
|
|
|
101
|
-
##
|
|
76
|
+
## 注意事項
|
|
102
77
|
|
|
103
|
-
-
|
|
104
|
-
-
|
|
105
|
-
-
|
|
106
|
-
-
|
|
78
|
+
- コミットメッセージは日本語で記述する。co-author やメッセージに "Claude Code" のキーワードは含めない
|
|
79
|
+
- 1 コミット 1 目的: 構造変更と動作変更を同一コミットに含めない
|
|
80
|
+
- 小さく頻繁に: 大きな変更は小さなコミットに分割する
|
|
81
|
+
- テスト通過後にコミットする。壊れたコードをコミットしない
|
|
@@ -1,98 +1,44 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: killing-processes
|
|
3
|
-
description: 開発サーバーや Node.js
|
|
3
|
+
description: 開発サーバーや Node.js プロセスを強制終了。ポート競合の解消やプロセスリセットに対応する。「プロセスを止めたい」「ポートが使われている」「開発サーバーを再起動したい」「Port already in use を解決したい」といった場面で発動する。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# プロセス強制終了
|
|
7
7
|
|
|
8
|
-
開発サーバーや Node.js
|
|
8
|
+
開発サーバーや Node.js プロセスを強制終了する。複数ポートで起動している開発プロセスを一括停止できる。
|
|
9
9
|
|
|
10
|
-
##
|
|
10
|
+
## オプション
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
| オプション | 説明 |
|
|
13
|
+
|-----------|------|
|
|
14
|
+
| なし | すべての Node.js 開発プロセスを強制終了 |
|
|
15
|
+
| `--port <ポート番号>` | 特定のポートのプロセスのみ終了 |
|
|
16
|
+
| `--check` | プロセス状況の確認のみ(終了せず) |
|
|
13
17
|
|
|
14
|
-
|
|
15
|
-
- `--port <ポート番号>` : 特定のポートのプロセスのみ終了
|
|
16
|
-
- `--check` : プロセス状況の確認のみ(終了せず)
|
|
17
|
-
|
|
18
|
-
### 2. 基本例
|
|
19
|
-
|
|
20
|
-
```bash
|
|
21
|
-
# 全開発プロセスを強制終了
|
|
22
|
-
# 「すべての Node.js 開発サーバー(npm run dev 等)を停止」
|
|
23
|
-
|
|
24
|
-
# ポート 3000 番のプロセスのみ終了
|
|
25
|
-
# --port 3000
|
|
26
|
-
# 「ポート 3000 で動作中のプロセスを終了」
|
|
27
|
-
|
|
28
|
-
# プロセス状況の確認
|
|
29
|
-
# --check
|
|
30
|
-
# 「現在起動中の開発プロセスを一覧表示」
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
### 3. 詳細機能
|
|
34
|
-
|
|
35
|
-
#### 一括プロセス終了
|
|
36
|
-
|
|
37
|
-
Windows 環境で複数の開発サーバーが起動している場合の一括終了処理。
|
|
18
|
+
## 実行コマンド
|
|
38
19
|
|
|
39
20
|
```bash
|
|
40
21
|
# ポート範囲でのプロセス検索・終了
|
|
41
22
|
netstat -ano | findstr ":300[0-9]" | findstr LISTENING
|
|
42
|
-
taskkill //F //PID <
|
|
23
|
+
taskkill //F //PID <PID>
|
|
43
24
|
```
|
|
44
25
|
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
特定のポートで起動しているプロセスのみを終了する。
|
|
48
|
-
|
|
49
|
-
- **安全性**: 指定ポートのみ終了で他に影響しない
|
|
50
|
-
- **精密性**: 必要最小限のプロセス停止
|
|
51
|
-
- **確認**: 終了前にプロセス情報を表示
|
|
52
|
-
|
|
53
|
-
### 4. 出力例
|
|
26
|
+
## 出力例
|
|
54
27
|
|
|
55
28
|
```
|
|
56
29
|
現在起動中の開発プロセス:
|
|
57
30
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
58
|
-
|
|
59
31
|
ポート 3000: PID 34348 (Node.js)
|
|
60
32
|
ポート 3001: PID 16676 (Node.js)
|
|
61
|
-
ポート 3002: PID 25696 (Node.js)
|
|
62
33
|
|
|
63
34
|
プロセス終了中...
|
|
64
35
|
PID 34348 を終了しました
|
|
65
36
|
PID 16676 を終了しました
|
|
66
|
-
PID 25696 を終了しました
|
|
67
|
-
|
|
68
37
|
すべての開発プロセスを停止しました。
|
|
69
38
|
```
|
|
70
39
|
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
```bash
|
|
74
|
-
# 開発中のエラー修正後にプロセスリセット
|
|
75
|
-
npm run dev
|
|
76
|
-
# 「エラーが発生」→ kill → 「全プロセス停止して再起動準備」
|
|
77
|
-
|
|
78
|
-
# ポート競合の解決
|
|
79
|
-
npm start
|
|
80
|
-
# 「Port 3000 is already in use」→ kill --port 3000
|
|
81
|
-
|
|
82
|
-
# 開発環境のクリーンアップ
|
|
83
|
-
git checkout main
|
|
84
|
-
# → kill → 「ブランチ切り替え前に開発プロセスをクリーンアップ」
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
### 6. 注意事項
|
|
88
|
-
|
|
89
|
-
- **前提条件**: Windows 環境(taskkill コマンド使用)
|
|
90
|
-
- **制限事項**: 管理者権限が必要な場合があります
|
|
91
|
-
- **推奨事項**: 重要な作業中は事前にファイル保存を行う
|
|
92
|
-
|
|
93
|
-
### 7. ベストプラクティス
|
|
40
|
+
## 注意事項
|
|
94
41
|
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
4. **再起動準備**: プロセス終了後は適切にサーバーを再起動
|
|
42
|
+
- Windows 環境(taskkill コマンド使用)が前提。管理者権限が必要な場合がある
|
|
43
|
+
- 重要な作業中は事前にファイルを保存する
|
|
44
|
+
- まず `--check` で状況確認してから終了する。必要に応じて `--port` で特定ポートのみ終了する
|