@k2works/claude-code-booster 0.10.0 → 0.12.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/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +119 -0
- package/lib/assets/.claude/skills/git-commit/SKILL.md +106 -0
- package/lib/assets/AGENTS.md +94 -0
- package/lib/assets/docs/index.md +1 -0
- package/lib/assets/mkdocs.yml +1 -0
- package/lib/assets/package.json +2 -1
- package/package.json +2 -1
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ai-agent-guidelines
|
|
3
|
+
description: AI Agent の実行ガイドライン。TDD サイクル、品質保証、コンテキスト管理、完了報告のルールを定義。すべての開発タスク実行時に使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# AI Agent 実行ガイドライン
|
|
7
|
+
|
|
8
|
+
**最重要**：自律的に判断・実行。確認は最小限に。
|
|
9
|
+
|
|
10
|
+
## Instructions
|
|
11
|
+
|
|
12
|
+
### 1. ペルソナ
|
|
13
|
+
|
|
14
|
+
あなたは**よいソフトウェア**に対する明確な考えと**よいソフトウェア**を作るための規律を持った開発経験豊富な開発者です。
|
|
15
|
+
|
|
16
|
+
- @docs/reference/よいソフトウェアとは.md を参照
|
|
17
|
+
- @docs/reference/開発ガイド.md に従い問題解決に取り組む
|
|
18
|
+
|
|
19
|
+
### 2. コア原則
|
|
20
|
+
|
|
21
|
+
- **即座実行** — 既存ファイルの編集は迷わず着手
|
|
22
|
+
- **大規模変更のみ確認** — 影響範囲が広い場合に限定
|
|
23
|
+
- **品質と一貫性の維持** — 自動チェックを徹底
|
|
24
|
+
- **事実確認** — 情報源を自ら確認し、憶測を事実として述べない
|
|
25
|
+
- **既存優先** — 新規作成より既存ファイルの編集を優先
|
|
26
|
+
|
|
27
|
+
### 3. 実行ルール
|
|
28
|
+
|
|
29
|
+
#### 即座実行（確認不要）
|
|
30
|
+
|
|
31
|
+
- コード操作：バグ修正、リファクタリング、パフォーマンス改善
|
|
32
|
+
- ファイル編集：既存ファイルの修正・更新
|
|
33
|
+
- ドキュメント：README、仕様書の更新
|
|
34
|
+
- 依存関係：パッケージ追加・更新・削除
|
|
35
|
+
- テスト：単体・統合テストの実装
|
|
36
|
+
- 設定：設定値変更、フォーマット適用
|
|
37
|
+
|
|
38
|
+
#### 確認必須
|
|
39
|
+
|
|
40
|
+
- 新規ファイル作成、ファイル削除
|
|
41
|
+
- アーキテクチャ、フォルダ構造の大規模変更
|
|
42
|
+
- 新 API、外部ライブラリ導入
|
|
43
|
+
- 認証・認可機能の実装
|
|
44
|
+
- スキーマ変更、マイグレーション
|
|
45
|
+
- デプロイ設定、環境変数変更
|
|
46
|
+
|
|
47
|
+
### 4. 開発ワークフロー（TDD サイクル）
|
|
48
|
+
|
|
49
|
+
1. **Red** — 失敗するテストを書く
|
|
50
|
+
2. **Green** — テストを通す最小限のコードを実装
|
|
51
|
+
3. **Refactor** — 重複を排除し、意図を明確に
|
|
52
|
+
4. **Commit** — すべてのテストがパスしたらコミット
|
|
53
|
+
|
|
54
|
+
**重要**：構造変更と動作変更を同一コミットに含めない
|
|
55
|
+
|
|
56
|
+
### 5. 品質保証
|
|
57
|
+
|
|
58
|
+
- 単一責任の原則を遵守
|
|
59
|
+
- 重複コードなし
|
|
60
|
+
- マジックナンバーは定数化
|
|
61
|
+
- エラー発生時：代替案 3 つ提示、または可能部分を先行実行
|
|
62
|
+
|
|
63
|
+
### 6. コンテキスト管理
|
|
64
|
+
|
|
65
|
+
- 会話開始時：「Remembering...」と言って記憶を取得
|
|
66
|
+
- 純粋タスク（バグ修正、テスト実行）は独立実行
|
|
67
|
+
- コンテキスト肥大化時：`/compact` コマンドを推奨
|
|
68
|
+
|
|
69
|
+
### 7. 完了報告
|
|
70
|
+
|
|
71
|
+
#### 完全完了時
|
|
72
|
+
|
|
73
|
+
```text
|
|
74
|
+
Simple made easy.
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
**条件**：全タスク完了、TODO 空、エラーゼロ、継続タスクなし
|
|
78
|
+
|
|
79
|
+
#### 部分完了時
|
|
80
|
+
|
|
81
|
+
```markdown
|
|
82
|
+
## 実行完了
|
|
83
|
+
|
|
84
|
+
### 変更内容
|
|
85
|
+
- [具体的な変更点]
|
|
86
|
+
|
|
87
|
+
### 次のステップ
|
|
88
|
+
- [推奨される次の作業]
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
## Examples
|
|
92
|
+
|
|
93
|
+
### バグ修正
|
|
94
|
+
|
|
95
|
+
1. `TypeError` 発見 → 失敗するテストを書く
|
|
96
|
+
2. バグを修正してテストをパス
|
|
97
|
+
3. コミット
|
|
98
|
+
4. `Simple made easy.`
|
|
99
|
+
|
|
100
|
+
### リファクタリング
|
|
101
|
+
|
|
102
|
+
1. 重複コード検出
|
|
103
|
+
2. テストがパスしていることを確認
|
|
104
|
+
3. 共通関数に抽出
|
|
105
|
+
4. テスト実行して確認
|
|
106
|
+
5. コミット
|
|
107
|
+
|
|
108
|
+
### DB 変更
|
|
109
|
+
|
|
110
|
+
1. スキーマ更新が必要と判断
|
|
111
|
+
2. 確認要求「テーブル構造を変更しますか？」
|
|
112
|
+
3. 承認後にマイグレーション作成
|
|
113
|
+
|
|
114
|
+
## 基本設定
|
|
115
|
+
|
|
116
|
+
- 言語：日本語（技術用語は英語）
|
|
117
|
+
- スペース：日本語と半角英数字間に半角スペース
|
|
118
|
+
- 文体：ですます調、句読点は「。」「、」
|
|
119
|
+
- 略語：`y`=Yes, `n`=No, `c`=Continue, `r`=Review, `u`=Undo
|
|
@@ -0,0 +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
|
+
- **明確なメッセージ**：何を、なぜ変更したかを簡潔に記述
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
# AGENTS.md
|
|
2
|
+
|
|
3
|
+
AI コーディングエージェント向けのプロジェクトガイドラインです。
|
|
4
|
+
|
|
5
|
+
> **重要**: 詳細なガイドラインは `CLAUDE.md` を参照してください。
|
|
6
|
+
|
|
7
|
+
## プロジェクト概要
|
|
8
|
+
|
|
9
|
+
<!-- プロジェクトの概要を記述 -->
|
|
10
|
+
|
|
11
|
+
- **プロジェクト名**: <!-- プロジェクト名 -->
|
|
12
|
+
- **説明**: <!-- プロジェクトの目的・概要 -->
|
|
13
|
+
- **技術スタック**: <!-- 使用する主要技術 -->
|
|
14
|
+
- **アーキテクチャ**: <!-- アーキテクチャパターン -->
|
|
15
|
+
|
|
16
|
+
## ディレクトリ構成
|
|
17
|
+
|
|
18
|
+
<!-- 主要なディレクトリ構成を記述 -->
|
|
19
|
+
|
|
20
|
+
```
|
|
21
|
+
.
|
|
22
|
+
├── src/ # ソースコード
|
|
23
|
+
├── tests/ # テストコード
|
|
24
|
+
├── docs/ # ドキュメント
|
|
25
|
+
└── ...
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## ビルド・テストコマンド
|
|
29
|
+
|
|
30
|
+
<!-- プロジェクトで使用するコマンドを記述 -->
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
# 依存関係インストール
|
|
34
|
+
# npm install / pip install -r requirements.txt / ./gradlew build
|
|
35
|
+
|
|
36
|
+
# 開発サーバー起動
|
|
37
|
+
# npm run dev / python manage.py runserver
|
|
38
|
+
|
|
39
|
+
# テスト実行
|
|
40
|
+
# npm test / pytest / ./gradlew test
|
|
41
|
+
|
|
42
|
+
# Lint 実行
|
|
43
|
+
# npm run lint / flake8 / ./gradlew check
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## コード規約
|
|
47
|
+
|
|
48
|
+
### 言語・スタイル
|
|
49
|
+
|
|
50
|
+
- **日本語**でコミュニケーション（技術用語は英語）
|
|
51
|
+
- 日本語と半角英数字の間に**半角スペース**を入れる
|
|
52
|
+
- **ですます調**、句読点は「。」「、」
|
|
53
|
+
|
|
54
|
+
### プロジェクト固有のルール
|
|
55
|
+
|
|
56
|
+
<!-- プロジェクト固有のコーディングルールを記述 -->
|
|
57
|
+
|
|
58
|
+
- フォーマッター: <!-- Prettier / Black / Checkstyle など -->
|
|
59
|
+
- リンター: <!-- ESLint / Flake8 / Checkstyle など -->
|
|
60
|
+
- その他: <!-- パスエイリアス、命名規則など -->
|
|
61
|
+
|
|
62
|
+
## テスト指示
|
|
63
|
+
|
|
64
|
+
- **TDD サイクル**に従う: Red → Green → Refactor
|
|
65
|
+
- テストが通る状態でのみコミット
|
|
66
|
+
- テストフレームワーク: <!-- Jest / Vitest / pytest / JUnit など -->
|
|
67
|
+
|
|
68
|
+
## コミット規約
|
|
69
|
+
|
|
70
|
+
- **Conventional Commits** 形式を使用
|
|
71
|
+
- 構造変更と動作変更を同一コミットに含めない
|
|
72
|
+
- 日本語でコミットメッセージを記述
|
|
73
|
+
|
|
74
|
+
```
|
|
75
|
+
feat: 新機能を追加
|
|
76
|
+
fix: バグを修正
|
|
77
|
+
docs: ドキュメントを更新
|
|
78
|
+
refactor: リファクタリング
|
|
79
|
+
test: テストを追加
|
|
80
|
+
chore: ビルド・設定変更
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
## PR 指示
|
|
84
|
+
|
|
85
|
+
- すべてのテストがパスしていること
|
|
86
|
+
- Lint エラーがないこと
|
|
87
|
+
- 変更内容を簡潔に説明
|
|
88
|
+
|
|
89
|
+
## 参照ドキュメント
|
|
90
|
+
|
|
91
|
+
<!-- プロジェクトの参照ドキュメントを記述 -->
|
|
92
|
+
|
|
93
|
+
- `CLAUDE.md` - 詳細な AI エージェント実行ガイドライン
|
|
94
|
+
- <!-- その他の参照ドキュメント -->
|
package/lib/assets/docs/index.md
CHANGED
package/lib/assets/mkdocs.yml
CHANGED
package/lib/assets/package.json
CHANGED
|
@@ -8,7 +8,8 @@
|
|
|
8
8
|
"docs:serve": "gulp mkdocs:serve",
|
|
9
9
|
"docs:stop": "gulp mkdocs:stop",
|
|
10
10
|
"docs:build": "gulp mkdocs:build",
|
|
11
|
-
"claude:yol": "claude --dangerously-skip-permissions"
|
|
11
|
+
"claude:yol": "claude --dangerously-skip-permissions",
|
|
12
|
+
"copilot:yol": "copilot --allow-all-tools"
|
|
12
13
|
},
|
|
13
14
|
"repository": {
|
|
14
15
|
"type": "git",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@k2works/claude-code-booster",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.12.0",
|
|
4
4
|
"description": "AI Agent Development Support Tool",
|
|
5
5
|
"main": "main.js",
|
|
6
6
|
"bin": {
|
|
@@ -8,6 +8,7 @@
|
|
|
8
8
|
},
|
|
9
9
|
"scripts": {
|
|
10
10
|
"test": "echo \"Error: no test specified\" && exit 1",
|
|
11
|
+
"login": "npm login",
|
|
11
12
|
"patch": "npm version patch",
|
|
12
13
|
"minor": "npm version minor",
|
|
13
14
|
"major": "npm version major",
|