@k2works/claude-code-booster 1.10.0 → 1.11.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/LICENSE +21 -21
- package/README.md +42 -42
- package/bin/claude-code-booster +79 -79
- package/lib/assets/.claude/README.md +162 -162
- package/lib/assets/.claude/SKILLS_TEMPLATE.md +100 -100
- package/lib/assets/.claude/scripts/generate-inception-deck.mjs +911 -911
- package/lib/assets/.claude/settings.json +11 -11
- package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +119 -119
- package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +87 -87
- package/lib/assets/.claude/skills/analyzing-business/SKILL.md +117 -117
- package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +80 -80
- package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +88 -88
- package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +137 -137
- package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +91 -91
- package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +91 -91
- package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +89 -87
- package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +102 -102
- package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +87 -87
- package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +86 -86
- package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +87 -87
- package/lib/assets/.claude/skills/creating-adr/SKILL.md +115 -115
- package/lib/assets/.claude/skills/developing-backend/SKILL.md +106 -106
- package/lib/assets/.claude/skills/developing-frontend/SKILL.md +96 -96
- package/lib/assets/.claude/skills/developing-release/SKILL.md +154 -154
- package/lib/assets/.claude/skills/generating-slides/SKILL.md +136 -136
- package/lib/assets/.claude/skills/git-commit/SKILL.md +106 -106
- package/lib/assets/.claude/skills/killing-processes/SKILL.md +98 -98
- package/lib/assets/.claude/skills/managing-docs/SKILL.md +200 -200
- package/lib/assets/.claude/skills/managing-operations/DEPLOY.md +77 -77
- package/lib/assets/.claude/skills/managing-operations/SETUP_CSHARP.md +80 -80
- package/lib/assets/.claude/skills/managing-operations/SETUP_FRONTEND.md +84 -84
- package/lib/assets/.claude/skills/managing-operations/SETUP_JAVA.md +75 -75
- package/lib/assets/.claude/skills/managing-operations/SKILL.md +156 -156
- package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +134 -134
- package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +243 -243
- package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +193 -193
- package/lib/assets/.claude/skills/planning-releases/SKILL.md +222 -222
- package/lib/assets/.claude/skills/tracking-progress/SKILL.md +164 -164
- package/lib/assets/.devcontainer/devcontainer.json +34 -34
- package/lib/assets/.env.example +17 -17
- package/lib/assets/.gitattributes +4 -4
- package/lib/assets/.github/workflows/docker-publish.yml +77 -77
- package/lib/assets/.github/workflows/mkdocs.yml +39 -39
- package/lib/assets/AGENTS.md +94 -94
- package/lib/assets/CLAUDE.md +162 -162
- package/lib/assets/README.md +285 -269
- package/lib/assets/docker-compose.yml +33 -33
- package/lib/assets/docs/assets/css/extra.css +29 -29
- package/lib/assets/docs/assets/js/extra.js +44 -44
- package/lib/assets/docs/index.md +14 -14
- package/lib/assets/docs/reference/CodexCLIMCP/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/343/203/225/343/203/255/343/203/274.md +532 -532
- package/lib/assets/docs/reference/CodexCLIMCP/343/202/265/343/203/274/343/203/220/343/203/274/350/250/255/345/256/232/346/211/213/351/240/206.md +341 -341
- package/lib/assets/docs/reference/Java/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/346/247/213/347/257/211/343/202/254/343/202/244/343/203/211.md +578 -578
- package/lib/assets/docs/reference/TypeScript/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/346/247/213/347/257/211/343/202/254/343/202/244/343/203/211.md +465 -465
- package/lib/assets/docs/reference/UI/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +448 -448
- package/lib/assets/docs/reference//343/202/210/343/201/204/343/202/275/343/203/225/343/203/210/343/202/246/343/202/247/343/202/242/343/201/250/343/201/257.md +242 -242
- package/lib/assets/docs/reference//343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +2216 -2216
- package/lib/assets/docs/reference//343/202/244/343/203/263/343/203/225/343/203/251/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +1878 -1878
- package/lib/assets/docs/reference//343/202/250/343/202/257/343/202/271/343/203/210/343/203/252/343/203/274/343/203/240/343/203/227/343/203/255/343/202/260/343/203/251/343/203/237/343/203/263/343/202/260.md +554 -554
- package/lib/assets/docs/reference//343/202/263/343/203/274/343/203/207/343/202/243/343/203/263/343/202/260/343/201/250/343/203/206/343/202/271/343/203/210/343/202/254/343/202/244/343/203/211.md +705 -705
- package/lib/assets/docs/reference//343/203/206/343/202/271/343/203/210/346/210/246/347/225/245/343/202/254/343/202/244/343/203/211.md +1313 -1313
- package/lib/assets/docs/reference//343/203/207/343/203/274/343/202/277/343/203/242/343/203/207/343/203/253/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +311 -311
- package/lib/assets/docs/reference//343/203/211/343/203/241/343/202/244/343/203/263/343/203/242/343/203/207/343/203/253/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +599 -599
- package/lib/assets/docs/reference//343/203/223/343/202/270/343/203/215/343/202/271/343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243/345/210/206/346/236/220/343/202/254/343/202/244/343/203/211.md +528 -528
- package/lib/assets/docs/reference//343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211.md +682 -682
- 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 -442
- package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/203/273/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/343/202/254/343/202/244/343/203/211.md +558 -558
- package/lib/assets/docs/reference//347/222/260/345/242/203/345/244/211/346/225/260/347/256/241/347/220/206/343/202/254/343/202/244/343/203/211.md +663 -663
- package/lib/assets/docs/reference//350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +1248 -1248
- package/lib/assets/docs/reference//351/201/213/347/224/250/350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +392 -392
- package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +235 -235
- package/lib/assets/docs/reference//351/235/236/346/251/237/350/203/275/350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +1236 -1236
- package/lib/assets/docs/template/ADR.md +30 -30
- package/lib/assets/docs/template/README.md +50 -50
- package/lib/assets/docs/template//343/201/276/343/201/232/343/201/223/343/202/214/343/202/222/350/252/255/343/202/202/343/201/206/343/203/252/343/202/271/343/203/210.md +12 -12
- 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/345/256/214/344/272/206/345/240/261/345/221/212/346/233/270.md +58 -58
- package/lib/assets/docs/template//343/202/244/343/203/263/343/202/273/343/203/227/343/202/267/343/203/247/343/203/263/343/203/207/343/203/203/343/202/255.md +13 -13
- package/lib/assets/docs/template//343/203/223/343/202/270/343/203/215/343/202/271/343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243.md +379 -379
- package/lib/assets/docs/template//345/256/214/345/205/250/345/275/242/345/274/217/343/201/256/343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271.md +68 -68
- package/lib/assets/docs/template//350/246/201/344/273/266/345/256/232/347/276/251.md +669 -669
- package/lib/assets/docs/template//350/250/255/350/250/210.md +163 -163
- package/lib/assets/gulpfile.js +23 -23
- package/lib/assets/mkdocs.yml +65 -65
- package/lib/assets/ops/docker/mkdoc/Dockerfile +19 -19
- package/lib/assets/ops/scripts/journal.js +180 -180
- package/lib/assets/ops/scripts/mkdocs.js +82 -82
- package/lib/assets/ops/scripts/release.js +431 -431
- package/lib/assets/ops/scripts/ssh.js +190 -190
- package/lib/assets/ops/scripts/vault.js +299 -299
- package/lib/assets/package-lock.json +1653 -1653
- package/lib/assets/package.json +40 -40
- package/lib/gulpfile.js +37 -37
- package/package.json +41 -41
|
@@ -1,136 +1,136 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: generating-slides
|
|
3
|
-
description: インセプションデッキの Markdown ドキュメントから PowerPoint スライド(.pptx)を生成。pptxgenjs を使用し、テンプレートのスライド構成・テーマに準拠した 12 枚構成のプレゼンテーションを出力。スライド生成やプレゼンテーション作成時に使用。
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# スライド生成
|
|
7
|
-
|
|
8
|
-
インセプションデッキの Markdown ドキュメントから、pptxgenjs を使用して PowerPoint スライド(.pptx)を生成します。テンプレート `docs/template/インセプションデッキ.pptx` のスライド構成に準拠した 12 枚構成のプレゼンテーションを出力します。
|
|
9
|
-
|
|
10
|
-
## Instructions
|
|
11
|
-
|
|
12
|
-
### 1. 参照ドキュメント
|
|
13
|
-
|
|
14
|
-
- @docs/template/インセプションデッキ.pptx - スライド構成のリファレンス(15 枚構成、4:3、テーマカラー・フォント)
|
|
15
|
-
|
|
16
|
-
### 2. 生成スクリプト
|
|
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
|
-
| # | スライドタイトル | テンプレート対応 | データソース |
|
|
47
|
-
| :--- | :--- | :--- | :--- |
|
|
48
|
-
| 1 | タイトル | Slide 2: プロジェクト名 | プロジェクト基本情報 |
|
|
49
|
-
| 2 | 我われはなぜここにいるのか | Slide 3: なぜここにいるのか | なぜやるのか? |
|
|
50
|
-
| 3 | エレベーターピッチ | Slide 4: エレベーターピッチ | どんなビジョンなのか? |
|
|
51
|
-
| 4 | どんな価値をもたらすのか? | Slide 5: パッケージデザイン | どんな価値をもたらすのか? |
|
|
52
|
-
| 5 | やらないことリスト | Slide 6: やらないことリスト | スコープの範囲はどこか? |
|
|
53
|
-
| 6 | プロジェクトコミュニティ | Slide 7: プロジェクトコミュニティ | 主なステークホルダーは? |
|
|
54
|
-
| 7 | 技術的な解決策の概要 | Slide 8: 技術的な解決策 | 基本的な解決策 |
|
|
55
|
-
| 8 | 夜も眠れなくなるような問題 | Slide 9: 夜も眠れない問題 | 主なリスクは何か? |
|
|
56
|
-
| 9 | 俺たちの "A チーム" | Slide 10: A チーム | どのくらい作業があり費用はいくらか? |
|
|
57
|
-
| 10 | 期間を見極める | Slide 11: 期間を見極める | 初回リリースはいつか? |
|
|
58
|
-
| 11 | トレードオフ・スライダー | Slide 12: トレードオフ | トレードオフにどう向き合うか? |
|
|
59
|
-
| 12 | 初回のリリースに必要なもの | Slide 13: 初回リリース | MVP スコープ・リリース戦略 |
|
|
60
|
-
|
|
61
|
-
#### テーマ設定
|
|
62
|
-
|
|
63
|
-
テンプレートから抽出したテーマに準拠する。
|
|
64
|
-
|
|
65
|
-
- **フォント**: Yu Gothic(游ゴシック)— Windows / Mac 両対応の日本語フォント
|
|
66
|
-
- **テーマカラー**: ダークブルー `#333399`、ティール `#009999`、ライトティール `#BBE0E3`
|
|
67
|
-
- **スライドサイズ**: 4:3(10" x 7.5")
|
|
68
|
-
|
|
69
|
-
#### 生成スクリプトの更新
|
|
70
|
-
|
|
71
|
-
inception-deck.md の内容が更新された場合、生成スクリプトの `SLIDE_DATA` オブジェクトを更新してから再実行する。
|
|
72
|
-
|
|
73
|
-
1. @docs/analysis/inception-deck.md を読み込む
|
|
74
|
-
2. @.claude/scripts/generate-inception-deck.mjs の `SLIDE_DATA` セクションを更新
|
|
75
|
-
3. `node .claude/scripts/generate-inception-deck.mjs` で再生成
|
|
76
|
-
|
|
77
|
-
#### スクリプト構成
|
|
78
|
-
|
|
79
|
-
生成スクリプトは以下の 4 セクションで構成されている。
|
|
80
|
-
|
|
81
|
-
| セクション | 内容 | 編集対象 |
|
|
82
|
-
| :--- | :--- | :--- |
|
|
83
|
-
| `SLIDE_DATA` | プロジェクト固有のデータ(テキスト・数値) | 毎回更新 |
|
|
84
|
-
| テーマ設定 | カラー・フォント定義 | 通常変更不要 |
|
|
85
|
-
| ヘルパー関数 | スライド部品の描画ロジック | 通常変更不要 |
|
|
86
|
-
| スライド生成 | `SLIDE_DATA` を読み取り 12 枚を生成 | 通常変更不要 |
|
|
87
|
-
|
|
88
|
-
`SLIDE_DATA` の各キーがスライドに対応している。
|
|
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
|
-
#### バージョン管理
|
|
107
|
-
|
|
108
|
-
- 出力ファイル名は `SLIDE_DATA.meta.outputFileName` で指定する(例: `PROJECT_v0.1.0.pptx`)
|
|
109
|
-
- `meta.title` と `meta.outputFileName` を同時に更新すること
|
|
110
|
-
|
|
111
|
-
### 6. 注意事項
|
|
112
|
-
|
|
113
|
-
- **前提条件**: @docs/analysis/inception-deck.md が作成済みであること(`analyzing-inception-deck` を先に実行)
|
|
114
|
-
- **制限事項**: テンプレート @docs/template/インセプションデッキ.pptx は編集しないこと。日本語フォントは Yu Gothic を使用すること(Gill Sans 等の欧文フォントは文字化けする)
|
|
115
|
-
- **推奨事項**: 生成後は PowerPoint で開いてレイアウトを目視確認し、必要に応じてスクリプトのレイアウトパラメータを微調整する
|
|
116
|
-
|
|
117
|
-
## Examples
|
|
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 が生成されたことを確認
|
|
126
|
-
|
|
127
|
-
### インセプションデッキ更新後のスライド再生成
|
|
128
|
-
|
|
129
|
-
1. @docs/analysis/inception-deck.md の更新内容を確認
|
|
130
|
-
2. @.claude/scripts/generate-inception-deck.mjs の `SLIDE_DATA` を更新
|
|
131
|
-
3. `node .claude/scripts/generate-inception-deck.mjs` を実行
|
|
132
|
-
|
|
133
|
-
### 関連スキル
|
|
134
|
-
|
|
135
|
-
- `analyzing-inception-deck` : 入力となるインセプションデッキの作成
|
|
136
|
-
- `analyzing-business` : ビジネスアーキテクチャ分析(補足情報の参照元)
|
|
1
|
+
---
|
|
2
|
+
name: generating-slides
|
|
3
|
+
description: インセプションデッキの Markdown ドキュメントから PowerPoint スライド(.pptx)を生成。pptxgenjs を使用し、テンプレートのスライド構成・テーマに準拠した 12 枚構成のプレゼンテーションを出力。スライド生成やプレゼンテーション作成時に使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# スライド生成
|
|
7
|
+
|
|
8
|
+
インセプションデッキの Markdown ドキュメントから、pptxgenjs を使用して PowerPoint スライド(.pptx)を生成します。テンプレート `docs/template/インセプションデッキ.pptx` のスライド構成に準拠した 12 枚構成のプレゼンテーションを出力します。
|
|
9
|
+
|
|
10
|
+
## Instructions
|
|
11
|
+
|
|
12
|
+
### 1. 参照ドキュメント
|
|
13
|
+
|
|
14
|
+
- @docs/template/インセプションデッキ.pptx - スライド構成のリファレンス(15 枚構成、4:3、テーマカラー・フォント)
|
|
15
|
+
|
|
16
|
+
### 2. 生成スクリプト
|
|
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
|
+
| # | スライドタイトル | テンプレート対応 | データソース |
|
|
47
|
+
| :--- | :--- | :--- | :--- |
|
|
48
|
+
| 1 | タイトル | Slide 2: プロジェクト名 | プロジェクト基本情報 |
|
|
49
|
+
| 2 | 我われはなぜここにいるのか | Slide 3: なぜここにいるのか | なぜやるのか? |
|
|
50
|
+
| 3 | エレベーターピッチ | Slide 4: エレベーターピッチ | どんなビジョンなのか? |
|
|
51
|
+
| 4 | どんな価値をもたらすのか? | Slide 5: パッケージデザイン | どんな価値をもたらすのか? |
|
|
52
|
+
| 5 | やらないことリスト | Slide 6: やらないことリスト | スコープの範囲はどこか? |
|
|
53
|
+
| 6 | プロジェクトコミュニティ | Slide 7: プロジェクトコミュニティ | 主なステークホルダーは? |
|
|
54
|
+
| 7 | 技術的な解決策の概要 | Slide 8: 技術的な解決策 | 基本的な解決策 |
|
|
55
|
+
| 8 | 夜も眠れなくなるような問題 | Slide 9: 夜も眠れない問題 | 主なリスクは何か? |
|
|
56
|
+
| 9 | 俺たちの "A チーム" | Slide 10: A チーム | どのくらい作業があり費用はいくらか? |
|
|
57
|
+
| 10 | 期間を見極める | Slide 11: 期間を見極める | 初回リリースはいつか? |
|
|
58
|
+
| 11 | トレードオフ・スライダー | Slide 12: トレードオフ | トレードオフにどう向き合うか? |
|
|
59
|
+
| 12 | 初回のリリースに必要なもの | Slide 13: 初回リリース | MVP スコープ・リリース戦略 |
|
|
60
|
+
|
|
61
|
+
#### テーマ設定
|
|
62
|
+
|
|
63
|
+
テンプレートから抽出したテーマに準拠する。
|
|
64
|
+
|
|
65
|
+
- **フォント**: Yu Gothic(游ゴシック)— Windows / Mac 両対応の日本語フォント
|
|
66
|
+
- **テーマカラー**: ダークブルー `#333399`、ティール `#009999`、ライトティール `#BBE0E3`
|
|
67
|
+
- **スライドサイズ**: 4:3(10" x 7.5")
|
|
68
|
+
|
|
69
|
+
#### 生成スクリプトの更新
|
|
70
|
+
|
|
71
|
+
inception-deck.md の内容が更新された場合、生成スクリプトの `SLIDE_DATA` オブジェクトを更新してから再実行する。
|
|
72
|
+
|
|
73
|
+
1. @docs/analysis/inception-deck.md を読み込む
|
|
74
|
+
2. @.claude/scripts/generate-inception-deck.mjs の `SLIDE_DATA` セクションを更新
|
|
75
|
+
3. `node .claude/scripts/generate-inception-deck.mjs` で再生成
|
|
76
|
+
|
|
77
|
+
#### スクリプト構成
|
|
78
|
+
|
|
79
|
+
生成スクリプトは以下の 4 セクションで構成されている。
|
|
80
|
+
|
|
81
|
+
| セクション | 内容 | 編集対象 |
|
|
82
|
+
| :--- | :--- | :--- |
|
|
83
|
+
| `SLIDE_DATA` | プロジェクト固有のデータ(テキスト・数値) | 毎回更新 |
|
|
84
|
+
| テーマ設定 | カラー・フォント定義 | 通常変更不要 |
|
|
85
|
+
| ヘルパー関数 | スライド部品の描画ロジック | 通常変更不要 |
|
|
86
|
+
| スライド生成 | `SLIDE_DATA` を読み取り 12 枚を生成 | 通常変更不要 |
|
|
87
|
+
|
|
88
|
+
`SLIDE_DATA` の各キーがスライドに対応している。
|
|
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
|
+
#### バージョン管理
|
|
107
|
+
|
|
108
|
+
- 出力ファイル名は `SLIDE_DATA.meta.outputFileName` で指定する(例: `PROJECT_v0.1.0.pptx`)
|
|
109
|
+
- `meta.title` と `meta.outputFileName` を同時に更新すること
|
|
110
|
+
|
|
111
|
+
### 6. 注意事項
|
|
112
|
+
|
|
113
|
+
- **前提条件**: @docs/analysis/inception-deck.md が作成済みであること(`analyzing-inception-deck` を先に実行)
|
|
114
|
+
- **制限事項**: テンプレート @docs/template/インセプションデッキ.pptx は編集しないこと。日本語フォントは Yu Gothic を使用すること(Gill Sans 等の欧文フォントは文字化けする)
|
|
115
|
+
- **推奨事項**: 生成後は PowerPoint で開いてレイアウトを目視確認し、必要に応じてスクリプトのレイアウトパラメータを微調整する
|
|
116
|
+
|
|
117
|
+
## Examples
|
|
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 が生成されたことを確認
|
|
126
|
+
|
|
127
|
+
### インセプションデッキ更新後のスライド再生成
|
|
128
|
+
|
|
129
|
+
1. @docs/analysis/inception-deck.md の更新内容を確認
|
|
130
|
+
2. @.claude/scripts/generate-inception-deck.mjs の `SLIDE_DATA` を更新
|
|
131
|
+
3. `node .claude/scripts/generate-inception-deck.mjs` を実行
|
|
132
|
+
|
|
133
|
+
### 関連スキル
|
|
134
|
+
|
|
135
|
+
- `analyzing-inception-deck` : 入力となるインセプションデッキの作成
|
|
136
|
+
- `analyzing-business` : ビジネスアーキテクチャ分析(補足情報の参照元)
|
|
@@ -1,106 +1,106 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: git-commit
|
|
3
|
-
description: Git コミットのベストプラクティス。意味のある変更単位でのコミット、Conventional Commits ルール、コミットメッセージの書き方を定義。
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Git コミットガイドライン
|
|
7
|
-
|
|
8
|
-
意味のある変更単位ごとにコミットを行うことは、コードの履歴を明確にし、将来の変更を追跡しやすくするために重要です。
|
|
9
|
-
|
|
10
|
-
## Instructions
|
|
11
|
-
|
|
12
|
-
### 1. 変更を確認する
|
|
13
|
-
|
|
14
|
-
まず、現在のワーキングディレクトリでの変更を確認します:
|
|
15
|
-
|
|
16
|
-
```bash
|
|
17
|
-
git status
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
### 2. 変更をステージングする
|
|
21
|
-
|
|
22
|
-
変更をコミットする前に、ステージングエリアに追加する必要があります:
|
|
23
|
-
|
|
24
|
-
```bash
|
|
25
|
-
git add 対象ファイルやディレクトリ
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
**重要**:意味のある変更単位ごとにファイルを指定すること。無条件にすべての変更を追加しないでください。
|
|
29
|
-
|
|
30
|
-
### 3. コミットメッセージを作成する
|
|
31
|
-
|
|
32
|
-
コミットメッセージは、変更内容を簡潔に説明する重要な部分です:
|
|
33
|
-
|
|
34
|
-
```bash
|
|
35
|
-
git commit -m "コミットメッセージをここに入力"
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
#### コミットメッセージのルール
|
|
39
|
-
|
|
40
|
-
- コミットメッセージは日本語で記述
|
|
41
|
-
- Conventional Commits のルールに従う
|
|
42
|
-
- co-author やコミットメッセージに "Claude Code" のキーワードは含めない
|
|
43
|
-
|
|
44
|
-
#### Conventional Commits フォーマット
|
|
45
|
-
|
|
46
|
-
```
|
|
47
|
-
<type>(<scope>): <subject>
|
|
48
|
-
|
|
49
|
-
<body>
|
|
50
|
-
|
|
51
|
-
<footer>
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
**type の種類**:
|
|
55
|
-
- `feat`: 新機能
|
|
56
|
-
- `fix`: バグ修正
|
|
57
|
-
- `docs`: ドキュメントのみの変更
|
|
58
|
-
- `style`: コードの意味に影響しない変更(空白、フォーマット等)
|
|
59
|
-
- `refactor`: バグ修正や機能追加ではないコード変更
|
|
60
|
-
- `test`: テストの追加・修正
|
|
61
|
-
- `chore`: ビルドプロセスやツールの変更
|
|
62
|
-
|
|
63
|
-
### 4. コミットを確認する
|
|
64
|
-
|
|
65
|
-
コミットが正しく行われたかを確認:
|
|
66
|
-
|
|
67
|
-
```bash
|
|
68
|
-
git log --oneline
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
## Examples
|
|
72
|
-
|
|
73
|
-
### 機能追加のコミット
|
|
74
|
-
|
|
75
|
-
```bash
|
|
76
|
-
git add src/features/user-auth.ts
|
|
77
|
-
git commit -m "feat(auth): ユーザー認証機能を追加"
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
### バグ修正のコミット
|
|
81
|
-
|
|
82
|
-
```bash
|
|
83
|
-
git add src/utils/validation.ts
|
|
84
|
-
git commit -m "fix(validation): メールアドレスのバリデーションエラーを修正"
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
### ドキュメント更新のコミット
|
|
88
|
-
|
|
89
|
-
```bash
|
|
90
|
-
git add README.md docs/setup.md
|
|
91
|
-
git commit -m "docs: セットアップ手順を更新"
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
### リファクタリングのコミット
|
|
95
|
-
|
|
96
|
-
```bash
|
|
97
|
-
git add src/services/api.ts
|
|
98
|
-
git commit -m "refactor(api): API クライアントの共通処理を抽出"
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
## ベストプラクティス
|
|
102
|
-
|
|
103
|
-
- **1 コミット 1 目的**:構造変更と動作変更を同一コミットに含めない
|
|
104
|
-
- **小さく頻繁に**:大きな変更は小さなコミットに分割
|
|
105
|
-
- **テスト通過後にコミット**:壊れたコードをコミットしない
|
|
106
|
-
- **明確なメッセージ**:何を、なぜ変更したかを簡潔に記述
|
|
1
|
+
---
|
|
2
|
+
name: git-commit
|
|
3
|
+
description: Git コミットのベストプラクティス。意味のある変更単位でのコミット、Conventional Commits ルール、コミットメッセージの書き方を定義。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Git コミットガイドライン
|
|
7
|
+
|
|
8
|
+
意味のある変更単位ごとにコミットを行うことは、コードの履歴を明確にし、将来の変更を追跡しやすくするために重要です。
|
|
9
|
+
|
|
10
|
+
## Instructions
|
|
11
|
+
|
|
12
|
+
### 1. 変更を確認する
|
|
13
|
+
|
|
14
|
+
まず、現在のワーキングディレクトリでの変更を確認します:
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
git status
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
### 2. 変更をステージングする
|
|
21
|
+
|
|
22
|
+
変更をコミットする前に、ステージングエリアに追加する必要があります:
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
git add 対象ファイルやディレクトリ
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
**重要**:意味のある変更単位ごとにファイルを指定すること。無条件にすべての変更を追加しないでください。
|
|
29
|
+
|
|
30
|
+
### 3. コミットメッセージを作成する
|
|
31
|
+
|
|
32
|
+
コミットメッセージは、変更内容を簡潔に説明する重要な部分です:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
git commit -m "コミットメッセージをここに入力"
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
#### コミットメッセージのルール
|
|
39
|
+
|
|
40
|
+
- コミットメッセージは日本語で記述
|
|
41
|
+
- Conventional Commits のルールに従う
|
|
42
|
+
- co-author やコミットメッセージに "Claude Code" のキーワードは含めない
|
|
43
|
+
|
|
44
|
+
#### Conventional Commits フォーマット
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
<type>(<scope>): <subject>
|
|
48
|
+
|
|
49
|
+
<body>
|
|
50
|
+
|
|
51
|
+
<footer>
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
**type の種類**:
|
|
55
|
+
- `feat`: 新機能
|
|
56
|
+
- `fix`: バグ修正
|
|
57
|
+
- `docs`: ドキュメントのみの変更
|
|
58
|
+
- `style`: コードの意味に影響しない変更(空白、フォーマット等)
|
|
59
|
+
- `refactor`: バグ修正や機能追加ではないコード変更
|
|
60
|
+
- `test`: テストの追加・修正
|
|
61
|
+
- `chore`: ビルドプロセスやツールの変更
|
|
62
|
+
|
|
63
|
+
### 4. コミットを確認する
|
|
64
|
+
|
|
65
|
+
コミットが正しく行われたかを確認:
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
git log --oneline
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
## Examples
|
|
72
|
+
|
|
73
|
+
### 機能追加のコミット
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
git add src/features/user-auth.ts
|
|
77
|
+
git commit -m "feat(auth): ユーザー認証機能を追加"
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
### バグ修正のコミット
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
git add src/utils/validation.ts
|
|
84
|
+
git commit -m "fix(validation): メールアドレスのバリデーションエラーを修正"
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### ドキュメント更新のコミット
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
git add README.md docs/setup.md
|
|
91
|
+
git commit -m "docs: セットアップ手順を更新"
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
### リファクタリングのコミット
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
git add src/services/api.ts
|
|
98
|
+
git commit -m "refactor(api): API クライアントの共通処理を抽出"
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
## ベストプラクティス
|
|
102
|
+
|
|
103
|
+
- **1 コミット 1 目的**:構造変更と動作変更を同一コミットに含めない
|
|
104
|
+
- **小さく頻繁に**:大きな変更は小さなコミットに分割
|
|
105
|
+
- **テスト通過後にコミット**:壊れたコードをコミットしない
|
|
106
|
+
- **明確なメッセージ**:何を、なぜ変更したかを簡潔に記述
|