@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.
Files changed (93) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +42 -42
  3. package/bin/claude-code-booster +79 -79
  4. package/lib/assets/.claude/README.md +162 -162
  5. package/lib/assets/.claude/SKILLS_TEMPLATE.md +100 -100
  6. package/lib/assets/.claude/scripts/generate-inception-deck.mjs +911 -911
  7. package/lib/assets/.claude/settings.json +11 -11
  8. package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +119 -119
  9. package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +87 -87
  10. package/lib/assets/.claude/skills/analyzing-business/SKILL.md +117 -117
  11. package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +80 -80
  12. package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +88 -88
  13. package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +137 -137
  14. package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +91 -91
  15. package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +91 -91
  16. package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +89 -87
  17. package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +102 -102
  18. package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +87 -87
  19. package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +86 -86
  20. package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +87 -87
  21. package/lib/assets/.claude/skills/creating-adr/SKILL.md +115 -115
  22. package/lib/assets/.claude/skills/developing-backend/SKILL.md +106 -106
  23. package/lib/assets/.claude/skills/developing-frontend/SKILL.md +96 -96
  24. package/lib/assets/.claude/skills/developing-release/SKILL.md +154 -154
  25. package/lib/assets/.claude/skills/generating-slides/SKILL.md +136 -136
  26. package/lib/assets/.claude/skills/git-commit/SKILL.md +106 -106
  27. package/lib/assets/.claude/skills/killing-processes/SKILL.md +98 -98
  28. package/lib/assets/.claude/skills/managing-docs/SKILL.md +200 -200
  29. package/lib/assets/.claude/skills/managing-operations/DEPLOY.md +77 -77
  30. package/lib/assets/.claude/skills/managing-operations/SETUP_CSHARP.md +80 -80
  31. package/lib/assets/.claude/skills/managing-operations/SETUP_FRONTEND.md +84 -84
  32. package/lib/assets/.claude/skills/managing-operations/SETUP_JAVA.md +75 -75
  33. package/lib/assets/.claude/skills/managing-operations/SKILL.md +156 -156
  34. package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +134 -134
  35. package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +243 -243
  36. package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +193 -193
  37. package/lib/assets/.claude/skills/planning-releases/SKILL.md +222 -222
  38. package/lib/assets/.claude/skills/tracking-progress/SKILL.md +164 -164
  39. package/lib/assets/.devcontainer/devcontainer.json +34 -34
  40. package/lib/assets/.env.example +17 -17
  41. package/lib/assets/.gitattributes +4 -4
  42. package/lib/assets/.github/workflows/docker-publish.yml +77 -77
  43. package/lib/assets/.github/workflows/mkdocs.yml +39 -39
  44. package/lib/assets/AGENTS.md +94 -94
  45. package/lib/assets/CLAUDE.md +162 -162
  46. package/lib/assets/README.md +285 -269
  47. package/lib/assets/docker-compose.yml +33 -33
  48. package/lib/assets/docs/assets/css/extra.css +29 -29
  49. package/lib/assets/docs/assets/js/extra.js +44 -44
  50. package/lib/assets/docs/index.md +14 -14
  51. 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
  52. 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
  53. 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
  54. 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
  55. package/lib/assets/docs/reference/UI/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +448 -448
  56. 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
  57. 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
  58. 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
  59. 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
  60. 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
  61. 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
  62. 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
  63. 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
  64. 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
  65. 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
  66. 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
  67. 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
  68. 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
  69. 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
  70. 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
  71. package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +235 -235
  72. 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
  73. package/lib/assets/docs/template/ADR.md +30 -30
  74. package/lib/assets/docs/template/README.md +50 -50
  75. 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
  76. 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
  77. 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
  78. 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
  79. 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
  80. package/lib/assets/docs/template//350/246/201/344/273/266/345/256/232/347/276/251.md +669 -669
  81. package/lib/assets/docs/template//350/250/255/350/250/210.md +163 -163
  82. package/lib/assets/gulpfile.js +23 -23
  83. package/lib/assets/mkdocs.yml +65 -65
  84. package/lib/assets/ops/docker/mkdoc/Dockerfile +19 -19
  85. package/lib/assets/ops/scripts/journal.js +180 -180
  86. package/lib/assets/ops/scripts/mkdocs.js +82 -82
  87. package/lib/assets/ops/scripts/release.js +431 -431
  88. package/lib/assets/ops/scripts/ssh.js +190 -190
  89. package/lib/assets/ops/scripts/vault.js +299 -299
  90. package/lib/assets/package-lock.json +1653 -1653
  91. package/lib/assets/package.json +40 -40
  92. package/lib/gulpfile.js +37 -37
  93. package/package.json +41 -41
@@ -1,98 +1,98 @@
1
- ---
2
- name: killing-processes
3
- description: 開発サーバーや Node.js プロセスを強制終了。ポート競合の解決やプロセスリセット時に使用。
4
- ---
5
-
6
- # Kill Development Processes
7
-
8
- 開発サーバーや Node.js プロセスを強制終了するスキル。複数ポートで起動している開発プロセスを一括で停止できます。
9
-
10
- ## Instructions
11
-
12
- ### 1. オプション
13
-
14
- - なし : すべての Node.js 開発プロセスを強制終了
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 環境で複数の開発サーバーが起動している場合の一括終了処理。
38
-
39
- ```bash
40
- # ポート範囲でのプロセス検索・終了
41
- netstat -ano | findstr ":300[0-9]" | findstr LISTENING
42
- taskkill //F //PID <PID1> && taskkill //F //PID <PID2>
43
- ```
44
-
45
- #### 個別ポート指定終了
46
-
47
- 特定のポートで起動しているプロセスのみを終了する。
48
-
49
- - **安全性**: 指定ポートのみ終了で他に影響しない
50
- - **精密性**: 必要最小限のプロセス停止
51
- - **確認**: 終了前にプロセス情報を表示
52
-
53
- ### 4. 出力例
54
-
55
- ```
56
- 現在起動中の開発プロセス:
57
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
58
-
59
- ポート 3000: PID 34348 (Node.js)
60
- ポート 3001: PID 16676 (Node.js)
61
- ポート 3002: PID 25696 (Node.js)
62
-
63
- プロセス終了中...
64
- PID 34348 を終了しました
65
- PID 16676 を終了しました
66
- PID 25696 を終了しました
67
-
68
- すべての開発プロセスを停止しました。
69
- ```
70
-
71
- ### 5. 連携シナリオ
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. ベストプラクティス
94
-
95
- 1. **安全な終了**: 作業中のファイルは事前に保存する
96
- 2. **段階的終了**: まず `--check` で状況確認してから終了
97
- 3. **ポート指定**: 必要に応じて特定ポートのみ終了
98
- 4. **再起動準備**: プロセス終了後は適切にサーバーを再起動
1
+ ---
2
+ name: killing-processes
3
+ description: 開発サーバーや Node.js プロセスを強制終了。ポート競合の解決やプロセスリセット時に使用。
4
+ ---
5
+
6
+ # Kill Development Processes
7
+
8
+ 開発サーバーや Node.js プロセスを強制終了するスキル。複数ポートで起動している開発プロセスを一括で停止できます。
9
+
10
+ ## Instructions
11
+
12
+ ### 1. オプション
13
+
14
+ - なし : すべての Node.js 開発プロセスを強制終了
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 環境で複数の開発サーバーが起動している場合の一括終了処理。
38
+
39
+ ```bash
40
+ # ポート範囲でのプロセス検索・終了
41
+ netstat -ano | findstr ":300[0-9]" | findstr LISTENING
42
+ taskkill //F //PID <PID1> && taskkill //F //PID <PID2>
43
+ ```
44
+
45
+ #### 個別ポート指定終了
46
+
47
+ 特定のポートで起動しているプロセスのみを終了する。
48
+
49
+ - **安全性**: 指定ポートのみ終了で他に影響しない
50
+ - **精密性**: 必要最小限のプロセス停止
51
+ - **確認**: 終了前にプロセス情報を表示
52
+
53
+ ### 4. 出力例
54
+
55
+ ```
56
+ 現在起動中の開発プロセス:
57
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
58
+
59
+ ポート 3000: PID 34348 (Node.js)
60
+ ポート 3001: PID 16676 (Node.js)
61
+ ポート 3002: PID 25696 (Node.js)
62
+
63
+ プロセス終了中...
64
+ PID 34348 を終了しました
65
+ PID 16676 を終了しました
66
+ PID 25696 を終了しました
67
+
68
+ すべての開発プロセスを停止しました。
69
+ ```
70
+
71
+ ### 5. 連携シナリオ
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. ベストプラクティス
94
+
95
+ 1. **安全な終了**: 作業中のファイルは事前に保存する
96
+ 2. **段階的終了**: まず `--check` で状況確認してから終了
97
+ 3. **ポート指定**: 必要に応じて特定ポートのみ終了
98
+ 4. **再起動準備**: プロセス終了後は適切にサーバーを再起動
@@ -1,200 +1,200 @@
1
- ---
2
- name: managing-docs
3
- description: 設計ドキュメントの一覧表示、進捗確認、内容参照、インデックス更新、Markdown Lint を実行。ドキュメント管理や整備時に使用。
4
- ---
5
-
6
- # ドキュメント管理ガイド
7
-
8
- 設計ドキュメントの一覧表示、進捗確認、内容参照を行います。
9
-
10
- ## Instructions
11
-
12
- ### 1. オプション
13
-
14
- - なし : ドキュメント一覧と進捗状況を表示
15
- - `--list` : ドキュメント一覧のみを表示
16
- - `--status` : ドキュメントの作成状況を詳細表示
17
- - `--read <ファイル名>` : 指定したドキュメントの内容を表示
18
- - `--summary` : 全ドキュメントの概要を表示
19
- - `--update` : `docs/index.md` と `mkdocs.yml` を現在のドキュメント構成に合わせて更新
20
- - `--update-index` : `docs/index.md` のみを更新
21
- - `--update-mkdocs` : `mkdocs.yml` のみを更新
22
- - `--lint` : Markdown フォーマットをチェックし、違反を自動修正
23
-
24
- ### 2. 基本例
25
-
26
- ```bash
27
- # ドキュメント一覧と進捗確認
28
- # 「設計ドキュメントの一覧と作成状況を確認」
29
-
30
- # 特定ドキュメントの参照
31
- # --read tech_stack
32
- # 「技術スタック選定ドキュメントの内容を表示」
33
-
34
- # docs/index.md と mkdocs.yml を更新
35
- # --update
36
- # 「現在のドキュメント構成に合わせて両ファイルを更新」
37
-
38
- # Markdown フォーマットをチェック・修正
39
- # --lint
40
- # 「タスク項目の前に空行がないなどのフォーマット違反を検出し自動修正」
41
- ```
42
-
43
- ### 3. ドキュメント構成
44
-
45
- 本プロジェクトのドキュメントは以下の構成で管理されています:
46
-
47
- **要件定義ドキュメント** (`docs/requirements/`)
48
-
49
- - `requirements_definition.md` : 要件定義書(RDRA 2.0)
50
- - `business_usecase.md` : ビジネスユースケース
51
- - `system_usecase.md` : システムユースケース
52
- - `user_story.md` : ユーザーストーリー
53
-
54
- **設計ドキュメント** (`docs/design/`)
55
-
56
- - `architecture_backend.md` : バックエンドアーキテクチャ
57
- - `architecture_frontend.md` : フロントエンドアーキテクチャ
58
- - `architecture_infrastructure.md` : インフラストラクチャ
59
- - `data-model.md` : データモデル設計
60
- - `domain-model.md` : ドメインモデル設計
61
- - `ui-design.md` : UI 設計
62
- - `test_strategy.md` : テスト戦略
63
- - `non_functional.md` : 非機能要件
64
- - `operation.md` : 運用要件
65
- - `tech_stack.md` : 技術スタック選定
66
-
67
- ### 4. ドキュメント更新機能
68
-
69
- `--update` オプションを使用すると、現在のドキュメント構成に合わせて `docs/index.md` と `mkdocs.yml` と 各ディレクトリの `index.md` を自動更新できます。
70
-
71
- **docs/index.md の更新内容**:
72
-
73
- - ドキュメント一覧をカテゴリ別に整理
74
- - 各ドキュメントへのリンクと説明を生成
75
- - 「まずこれを読もうリスト」形式で構成
76
-
77
- **mkdocs.yml の更新内容**:
78
-
79
- - `nav` セクションを現在のドキュメント構成に合わせて更新
80
- - 要件定義、設計、開発、運用などのカテゴリで階層化
81
- - 新しいドキュメントを自動的にナビゲーションに追加
82
-
83
- **各ディレクトリの index.md の更新内容**:
84
-
85
- - ドキュメント一覧をカテゴリ別に整理
86
- - 各ドキュメントへのリンクと説明を生成
87
-
88
- ### 5. Lint 機能
89
-
90
- `--lint` オプションを使用すると、Markdown ドキュメントのフォーマットをチェックし、違反を自動修正できます。
91
-
92
- **チェックルール**:
93
-
94
- - タスク項目(リスト)の前には空行が必要
95
- - 番号付きリストのサブリスト前にも空行が必要
96
- - コロンで終わる行の直後にリストがある場合も空行が必要
97
- - 太字ラベル(半角・全角コロン両方)の直後にリストがある場合も空行が必要
98
-
99
- **NG 例** - ラベルの直後にリスト:
100
-
101
- ```markdown
102
- **受入条件**:
103
- - [ ] ログアウトボタンをクリックするとログアウトできる
104
- ```
105
-
106
- **OK 例**:
107
-
108
- ```markdown
109
- **受入条件**:
110
-
111
- - [ ] ログアウトボタンをクリックするとログアウトできる
112
- ```
113
-
114
- **NG 例** - 番号付きリストの直後にサブリスト:
115
-
116
- ```markdown
117
- 1. **対処**: SMB バージョンを確認
118
- - コントロールパネル > ファイルサービス > SMB で設定
119
- ```
120
-
121
- **OK 例**:
122
-
123
- ```markdown
124
- 1. **対処**: SMB バージョンを確認
125
-
126
- - コントロールパネル > ファイルサービス > SMB で設定
127
- ```
128
-
129
- **NG 例** - コロンで終わる行の直後にリスト:
130
-
131
- ```markdown
132
- PMD はカスタム設定で以下をチェック:
133
- - マジックナンバーの使用
134
- ```
135
-
136
- **OK 例**:
137
-
138
- ```markdown
139
- PMD はカスタム設定で以下をチェック:
140
-
141
- - マジックナンバーの使用
142
- ```
143
-
144
- **実行手順**:
145
-
146
- 1. `docs/` 配下の全 Markdown ファイルをスキャン
147
- 2. 上記ルールに違反する箇所を検出
148
- 3. 違反箇所を自動修正
149
- 4. 修正結果を報告
150
-
151
- ### 6. 出力例
152
-
153
- ```
154
- 設計ドキュメント一覧
155
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
156
-
157
- docs/requirements/
158
- ├─ requirements_definition.md (要件定義書)
159
- ├─ business_usecase.md (ビジネスユースケース)
160
- ├─ system_usecase.md (システムユースケース)
161
- └─ user_story.md (ユーザーストーリー)
162
-
163
- docs/design/
164
- ├─ architecture_backend.md (バックエンドアーキテクチャ)
165
- ├─ architecture_frontend.md (フロントエンドアーキテクチャ)
166
- ├─ data-model.md (データモデル設計)
167
- ├─ domain-model.md (ドメインモデル設計)
168
- ├─ ui-design.md (UI 設計)
169
- ├─ test_strategy.md (テスト戦略)
170
- ├─ non_functional.md (非機能要件)
171
- ├─ operation.md (運用要件)
172
- └─ tech_stack.md (技術スタック選定)
173
-
174
- 進捗: 14/14 ドキュメント完成 (100%)
175
- ```
176
-
177
- ### 7. 注意事項
178
-
179
- - **前提条件**: `docs/` ディレクトリが存在すること
180
- - **制限事項**: Markdown 形式のドキュメントのみ対応
181
- - **推奨事項**: 定期的にドキュメントの進捗を確認し、最新の状態を維持すること
182
- - **更新時の注意**: `--update` 実行前に現在の `docs/index.md` と `mkdocs.yml` をバックアップすることを推奨
183
- - **MkDocs 依存**: `--update-mkdocs` を使用する場合、MkDocs がインストールされている必要がある
184
-
185
- ### 8. ベストプラクティス
186
-
187
- 1. **定期確認**: 開発フェーズ移行前にドキュメントの完成度を確認する
188
- 2. **整合性維持**: コード変更時は関連ドキュメントも更新する
189
- 3. **レビュー活用**: チームレビュー前にドキュメント概要を共有する
190
- 4. **バージョン管理**: ドキュメントの変更は Git でコミットする
191
- 5. **インデックス同期**: 新しいドキュメント作成後は `--update` でインデックスを同期する
192
- 6. **プレビュー確認**: `--update-mkdocs` 後は `mkdocs serve` でナビゲーションを確認する
193
- 7. **フォーマット統一**: コミット前に `--lint` でフォーマットの一貫性を確保する
194
-
195
- ### 関連スキル
196
-
197
- - `orchestrating-analysis` : 分析フェーズ全体の作業支援
198
- - `analyzing-requirements` : 要件定義関連の作業支援
199
- - `analyzing-architecture` : アーキテクチャ設計支援
200
- - `tracking-progress` : プロジェクト全体の進捗確認
1
+ ---
2
+ name: managing-docs
3
+ description: 設計ドキュメントの一覧表示、進捗確認、内容参照、インデックス更新、Markdown Lint を実行。ドキュメント管理や整備時に使用。
4
+ ---
5
+
6
+ # ドキュメント管理ガイド
7
+
8
+ 設計ドキュメントの一覧表示、進捗確認、内容参照を行います。
9
+
10
+ ## Instructions
11
+
12
+ ### 1. オプション
13
+
14
+ - なし : ドキュメント一覧と進捗状況を表示
15
+ - `--list` : ドキュメント一覧のみを表示
16
+ - `--status` : ドキュメントの作成状況を詳細表示
17
+ - `--read <ファイル名>` : 指定したドキュメントの内容を表示
18
+ - `--summary` : 全ドキュメントの概要を表示
19
+ - `--update` : `docs/index.md` と `mkdocs.yml` を現在のドキュメント構成に合わせて更新
20
+ - `--update-index` : `docs/index.md` のみを更新
21
+ - `--update-mkdocs` : `mkdocs.yml` のみを更新
22
+ - `--lint` : Markdown フォーマットをチェックし、違反を自動修正
23
+
24
+ ### 2. 基本例
25
+
26
+ ```bash
27
+ # ドキュメント一覧と進捗確認
28
+ # 「設計ドキュメントの一覧と作成状況を確認」
29
+
30
+ # 特定ドキュメントの参照
31
+ # --read tech_stack
32
+ # 「技術スタック選定ドキュメントの内容を表示」
33
+
34
+ # docs/index.md と mkdocs.yml を更新
35
+ # --update
36
+ # 「現在のドキュメント構成に合わせて両ファイルを更新」
37
+
38
+ # Markdown フォーマットをチェック・修正
39
+ # --lint
40
+ # 「タスク項目の前に空行がないなどのフォーマット違反を検出し自動修正」
41
+ ```
42
+
43
+ ### 3. ドキュメント構成
44
+
45
+ 本プロジェクトのドキュメントは以下の構成で管理されています:
46
+
47
+ **要件定義ドキュメント** (`docs/requirements/`)
48
+
49
+ - `requirements_definition.md` : 要件定義書(RDRA 2.0)
50
+ - `business_usecase.md` : ビジネスユースケース
51
+ - `system_usecase.md` : システムユースケース
52
+ - `user_story.md` : ユーザーストーリー
53
+
54
+ **設計ドキュメント** (`docs/design/`)
55
+
56
+ - `architecture_backend.md` : バックエンドアーキテクチャ
57
+ - `architecture_frontend.md` : フロントエンドアーキテクチャ
58
+ - `architecture_infrastructure.md` : インフラストラクチャ
59
+ - `data-model.md` : データモデル設計
60
+ - `domain-model.md` : ドメインモデル設計
61
+ - `ui-design.md` : UI 設計
62
+ - `test_strategy.md` : テスト戦略
63
+ - `non_functional.md` : 非機能要件
64
+ - `operation.md` : 運用要件
65
+ - `tech_stack.md` : 技術スタック選定
66
+
67
+ ### 4. ドキュメント更新機能
68
+
69
+ `--update` オプションを使用すると、現在のドキュメント構成に合わせて `docs/index.md` と `mkdocs.yml` と 各ディレクトリの `index.md` を自動更新できます。
70
+
71
+ **docs/index.md の更新内容**:
72
+
73
+ - ドキュメント一覧をカテゴリ別に整理
74
+ - 各ドキュメントへのリンクと説明を生成
75
+ - 「まずこれを読もうリスト」形式で構成
76
+
77
+ **mkdocs.yml の更新内容**:
78
+
79
+ - `nav` セクションを現在のドキュメント構成に合わせて更新
80
+ - 要件定義、設計、開発、運用などのカテゴリで階層化
81
+ - 新しいドキュメントを自動的にナビゲーションに追加
82
+
83
+ **各ディレクトリの index.md の更新内容**:
84
+
85
+ - ドキュメント一覧をカテゴリ別に整理
86
+ - 各ドキュメントへのリンクと説明を生成
87
+
88
+ ### 5. Lint 機能
89
+
90
+ `--lint` オプションを使用すると、Markdown ドキュメントのフォーマットをチェックし、違反を自動修正できます。
91
+
92
+ **チェックルール**:
93
+
94
+ - タスク項目(リスト)の前には空行が必要
95
+ - 番号付きリストのサブリスト前にも空行が必要
96
+ - コロンで終わる行の直後にリストがある場合も空行が必要
97
+ - 太字ラベル(半角・全角コロン両方)の直後にリストがある場合も空行が必要
98
+
99
+ **NG 例** - ラベルの直後にリスト:
100
+
101
+ ```markdown
102
+ **受入条件**:
103
+ - [ ] ログアウトボタンをクリックするとログアウトできる
104
+ ```
105
+
106
+ **OK 例**:
107
+
108
+ ```markdown
109
+ **受入条件**:
110
+
111
+ - [ ] ログアウトボタンをクリックするとログアウトできる
112
+ ```
113
+
114
+ **NG 例** - 番号付きリストの直後にサブリスト:
115
+
116
+ ```markdown
117
+ 1. **対処**: SMB バージョンを確認
118
+ - コントロールパネル > ファイルサービス > SMB で設定
119
+ ```
120
+
121
+ **OK 例**:
122
+
123
+ ```markdown
124
+ 1. **対処**: SMB バージョンを確認
125
+
126
+ - コントロールパネル > ファイルサービス > SMB で設定
127
+ ```
128
+
129
+ **NG 例** - コロンで終わる行の直後にリスト:
130
+
131
+ ```markdown
132
+ PMD はカスタム設定で以下をチェック:
133
+ - マジックナンバーの使用
134
+ ```
135
+
136
+ **OK 例**:
137
+
138
+ ```markdown
139
+ PMD はカスタム設定で以下をチェック:
140
+
141
+ - マジックナンバーの使用
142
+ ```
143
+
144
+ **実行手順**:
145
+
146
+ 1. `docs/` 配下の全 Markdown ファイルをスキャン
147
+ 2. 上記ルールに違反する箇所を検出
148
+ 3. 違反箇所を自動修正
149
+ 4. 修正結果を報告
150
+
151
+ ### 6. 出力例
152
+
153
+ ```
154
+ 設計ドキュメント一覧
155
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
156
+
157
+ docs/requirements/
158
+ ├─ requirements_definition.md (要件定義書)
159
+ ├─ business_usecase.md (ビジネスユースケース)
160
+ ├─ system_usecase.md (システムユースケース)
161
+ └─ user_story.md (ユーザーストーリー)
162
+
163
+ docs/design/
164
+ ├─ architecture_backend.md (バックエンドアーキテクチャ)
165
+ ├─ architecture_frontend.md (フロントエンドアーキテクチャ)
166
+ ├─ data-model.md (データモデル設計)
167
+ ├─ domain-model.md (ドメインモデル設計)
168
+ ├─ ui-design.md (UI 設計)
169
+ ├─ test_strategy.md (テスト戦略)
170
+ ├─ non_functional.md (非機能要件)
171
+ ├─ operation.md (運用要件)
172
+ └─ tech_stack.md (技術スタック選定)
173
+
174
+ 進捗: 14/14 ドキュメント完成 (100%)
175
+ ```
176
+
177
+ ### 7. 注意事項
178
+
179
+ - **前提条件**: `docs/` ディレクトリが存在すること
180
+ - **制限事項**: Markdown 形式のドキュメントのみ対応
181
+ - **推奨事項**: 定期的にドキュメントの進捗を確認し、最新の状態を維持すること
182
+ - **更新時の注意**: `--update` 実行前に現在の `docs/index.md` と `mkdocs.yml` をバックアップすることを推奨
183
+ - **MkDocs 依存**: `--update-mkdocs` を使用する場合、MkDocs がインストールされている必要がある
184
+
185
+ ### 8. ベストプラクティス
186
+
187
+ 1. **定期確認**: 開発フェーズ移行前にドキュメントの完成度を確認する
188
+ 2. **整合性維持**: コード変更時は関連ドキュメントも更新する
189
+ 3. **レビュー活用**: チームレビュー前にドキュメント概要を共有する
190
+ 4. **バージョン管理**: ドキュメントの変更は Git でコミットする
191
+ 5. **インデックス同期**: 新しいドキュメント作成後は `--update` でインデックスを同期する
192
+ 6. **プレビュー確認**: `--update-mkdocs` 後は `mkdocs serve` でナビゲーションを確認する
193
+ 7. **フォーマット統一**: コミット前に `--lint` でフォーマットの一貫性を確保する
194
+
195
+ ### 関連スキル
196
+
197
+ - `orchestrating-analysis` : 分析フェーズ全体の作業支援
198
+ - `analyzing-requirements` : 要件定義関連の作業支援
199
+ - `analyzing-architecture` : アーキテクチャ設計支援
200
+ - `tracking-progress` : プロジェクト全体の進捗確認