CCJKスキルシステム：AIアシスタントの機能を拡張する

スキルシステムは、CCJKを単純なAIアシスタントから強力でカスタマイズ可能な開発プラットフォームに変換するものです。スキルは、ベストプラクティスをエンコードし、標準を強制し、複雑なワークフローを自動化する再利用可能なプロンプトテンプレートです。

スキルを理解する

スキルとは？

スキルは、以下を行う事前定義されたプロンプトテンプレートです：

• ドメインの専門知識をカプセル化
• 一貫性のある再現可能な結果を提供
• カスタマイズのためのパラメータを受け入れ
• 開発ワークフローと統合

ビルトインスキル

CCJKには22種類以上のプリビルトスキルが付属しています：

スキル	コマンド	説明
コードレビュー	/review	包括的なコードレビュー
コミット	/commit	セマンティックコミットメッセージを生成
テスト	/test	ユニットテストを生成
ドキュメント	/doc	ドキュメントを生成
リファクタリング	/refactor	リファクタリングの改善を提案
セキュリティ	/security	セキュリティ脆弱性スキャン
パフォーマンス	/perf	パフォーマンス分析
デバッグ	/debug	体系的なデバッグ支援

ビルトインスキルの使用

/review スキル

徹底的なコードレビューを実行：

hljs bash
# ステージされた変更をレビュー
/review

# 特定のファイルをレビュー
/review src/components/UserProfile.tsx

# フォーカスエリアを指定してレビュー
/review --focus security src/auth/

出力には以下が含まれます：

• 重大な問題（修正必須）
• 提案（検討すべき）
• 細かい指摘（オプションの改善）
• ポジティブな観察

/commit スキル

意味のあるコミットメッセージを生成：

hljs bash
# ステージされた変更から自動生成
/commit

# スコープを指定
/commit --scope auth

# Conventional Commitsフォーマット
/commit --conventional

出力例：

feat(auth): JWTリフレッシュトークンローテーションを実装

- セキュアなローテーションを備えたリフレッシュトークンエンドポイントを追加
- 再利用検出のためのトークンファミリー追跡を実装
- リフレッシュトークンメタデータのRedisストレージを追加
- 包括的なテストカバレッジを含む

BREAKING CHANGE: リフレッシュトークンは1回の使用後に期限切れになります

/test スキル

包括的なテストを生成：

hljs bash
# ファイルのテストを生成
/test src/utils/validation.ts

# 特定の関数のテストを生成
/test --function validateEmail src/utils/validation.ts

# カバレッジ目標を指定
/test --coverage 90 src/services/UserService.ts

生成されるテスト：

• ハッピーパスのテストケース
• エッジケースとエラーケース
• モックとスタブ
• 適切なアサーション
• 説明的なテスト名

/debug スキル

体系的なデバッグアプローチ：

hljs bash
# 問題を説明
/debug "ユーザーがログアウトした後もセッションが持続する"

# ファイルを指定
/debug --file src/auth/session.ts "セッションがクリアされない"

# ログを含める
/debug --logs error.log "500エラーがランダムに発生"

デバッグプロセス：

1. 問題の理解と再現
2. 診断ログの追加
3. 根本原因の特定
4. 修正の提案と実装
5. ソリューションの検証

/refactor スキル

コード改善の提案：

hljs bash
# ファイルをリファクタリング
/refactor src/components/Dashboard.tsx

# 特定の側面に焦点を当てる
/refactor --focus performance src/api/client.ts

# パターンを指定
/refactor --pattern "repository" src/data/

リファクタリングの提案：

• コードの臭いの特定
• デザインパターンの適用
• パフォーマンスの最適化
• 可読性の向上
• テストの保持

/security スキル

セキュリティ脆弱性スキャン：

hljs bash
# プロジェクト全体をスキャン
/security

# 特定のディレクトリをスキャン
/security src/api/

# 重要度でフィルタリング
/security --severity high

チェック項目：

• SQLインジェクション
• XSS脆弱性
• 認証の問題
• データ露出
• 依存関係の脆弱性

/perf スキル

パフォーマンス分析：

hljs bash
# パフォーマンスを分析
/perf src/components/DataTable.tsx

# ボトルネックを特定
/perf --bottlenecks src/services/

# 最適化を提案
/perf --optimize src/utils/processing.ts

分析内容：

• 時間計算量
• 空間計算量
• レンダリングパフォーマンス
• メモリリーク
• 最適化の機会

カスタムスキルの作成

スキルの構造

カスタムスキルは ~/.claude/skills/ ディレクトリに保存されます：

~/.claude/skills/
├── my-skill.md
├── team-review.md
└── deploy-check.md

基本的なスキルテンプレート

hljs markdown
---
name: my-skill
description: カスタムスキルの説明
version: 1.0.0
author: あなたの名前
tags: [custom, automation]
---

# スキル名

## 目的
このスキルが何をするかを説明

## パラメータ
- `param1`: パラメータ1の説明
- `param2`: パラメータ2の説明

## プロンプト

あなたは{{param1}}の専門家です。以下のタスクを実行してください：

1. {{param2}}を分析
2. 改善を提案
3. 実装を提供

## 出力フォーマット

期待される出力形式を説明

実践例：カスタムAPIレビュースキル

hljs markdown
---
name: api-review
description: RESTful API設計をレビュー
version: 1.0.0
author: CCJK Team
tags: [api, review, rest]
---

# API設計レビュー

## 目的
RESTful APIエンドポイントをベストプラクティスに照らしてレビュー

## パラメータ
- `file`: レビューするAPIファイルのパス

## プロンプト

以下のRESTful API設計をレビューしてください：{{file}}

以下の観点から分析してください：

1. **RESTful原則**
   - 適切なHTTPメソッドの使用
   - リソース指向のURL設計
   - ステートレス性

2. **セキュリティ**
   - 認証と認可
   - 入力検証
   - レート制限

3. **パフォーマンス**
   - ページネーション
   - キャッシング戦略
   - N+1クエリ問題

4. **ドキュメント**
   - エンドポイントの説明
   - リクエスト/レスポンス例
   - エラーコード

5. **バージョニング**
   - APIバージョニング戦略
   - 後方互換性

## 出力フォーマット

各カテゴリについて：
- ✅ 良い点
- ⚠️ 改善が必要な点
- ❌ 重大な問題
- 💡 推奨事項

使用方法

hljs bash
/api-review src/api/users.ts

高度なスキル機能

パラメータの使用

スキルは動的パラメータを受け入れることができます：

hljs markdown
## プロンプト

{{language}}で{{feature}}を実装してください。

要件：
- フレームワーク：{{framework}}
- テストフレームワーク：{{test_framework}}
- スタイル：{{style_guide}}

使用：

hljs bash
/my-skill --language TypeScript --feature "ユーザー認証" --framework Express --test_framework Jest --style_guide Airbnb

条件付きロジック

hljs markdown
{{#if security_focus}}
セキュリティに特に注意を払ってください：
- 入力検証
- SQLインジェクション防止
- XSS保護
{{/if}}

{{#if performance_focus}}
パフォーマンスを最適化してください：
- キャッシング戦略
- データベースクエリの最適化
- 遅延読み込み
{{/if}}

スキルの連鎖

複数のスキルを順番に実行：

hljs bash
# コードを実装してテストしてレビュー
/implement "ユーザー登録" && /test && /review

スキルのエイリアス

頻繁に使用するスキルのショートカットを作成：

hljs json
// ~/.claude/config.json
{
  "aliases": {
    "fr": "/review --focus security",
    "qt": "/test --coverage 90",
    "dc": "/commit --conventional"
  }
}

使用：

hljs bash
/fr src/auth/
/qt src/services/
/dc

チームでスキルを共有

スキルリポジトリの作成

hljs bash
# チームスキルリポジトリを作成
mkdir team-skills
cd team-skills
git init

# スキルを追加
cp ~/.claude/skills/custom-*.md ./
git add .
git commit -m "チームスキルを追加"
git push origin main

スキルのインストール

hljs bash
# チームスキルをインストール
claude skills install https://github.com/your-team/team-skills

# または特定のスキルをインストール
claude skills install https://github.com/your-team/team-skills/api-review.md

スキルの更新

hljs bash
# すべてのスキルを更新
claude skills update

# 特定のスキルを更新
claude skills update api-review

スキルのベストプラクティス

1. 明確な目的

各スキルは単一の明確な目的を持つべきです。

良い例：

hljs markdown
name: validate-api-response
description: APIレスポンス構造を検証

悪い例：

hljs markdown
name: do-everything
description: コードに関するすべてを行う

2. パラメータ化

ハードコードされた値の代わりにパラメータを使用：

hljs markdown
# 悪い例
React 18を使用してコンポーネントを作成

# 良い例
{{framework}} {{version}}を使用してコンポーネントを作成

3. 明確な出力フォーマット

期待される出力を指定：

hljs markdown
## 出力フォーマット

```json
{
  "issues": [
    {
      "severity": "high|medium|low",
      "file": "ファイルパス",
      "line": 行番号,
      "description": "問題の説明",
      "suggestion": "修正方法"
    }
  ]
}

### 4. 例を含める

使用例を提供：

```markdown
## 使用例

```bash
# 基本的な使用
/my-skill src/app.ts

# オプション付き
/my-skill --strict --format json src/app.ts

### 5. バージョン管理

スキルをバージョン管理：

```markdown
---
name: my-skill
version: 2.1.0
changelog:
  - 2.1.0: パフォーマンスチェックを追加
  - 2.0.0: 新しい出力フォーマット
  - 1.0.0: 初期リリース
---

スキルのデバッグ

ドライラン

スキルを実行せずにテスト：

hljs bash
/my-skill --dry-run src/app.ts

詳細モード

詳細な出力を表示：

hljs bash
/my-skill --verbose src/app.ts

スキルの検証

スキルの構文を検証：

hljs bash
claude skills validate my-skill.md

実践的なスキル例

例1：データベースマイグレーションスキル

hljs markdown
---
name: db-migration
description: データベースマイグレーションファイルを生成
version: 1.0.0
---

# データベースマイグレーション生成

## プロンプト

{{database}}用のマイグレーションファイルを生成してください：

変更内容：{{changes}}

要件：
- アップとダウンの両方のマイグレーションを含める
- トランザクションを使用
- ロールバック可能にする
- インデックスを適切に追加
- 外部キー制約を処理

ファイル名：{{timestamp}}_{{description}}.sql

例2：コンポーネントジェネレータースキル

hljs markdown
---
name: gen-component
description: Reactコンポーネントを生成
version: 1.0.0
---

# Reactコンポーネント生成

## プロンプト

以下の仕様で{{component_name}}コンポーネントを生成：

タイプ：{{type}} (functional/class)
Props：{{props}}
State：{{state}}

含めるもの：
- TypeScript型定義
- PropTypes（該当する場合）
- デフォルトProps
- スタイルファイル（{{style_type}}）
- Storybookストーリー
- ユニットテスト

プロジェクト構造：

src/components/{{component_name}}/ ├── {{component_name}}.tsx ├── {{component_name}}.module.css ├── {{component_name}}.stories.tsx ├── {{component_name}}.test.tsx └── index.ts

例3：パフォーマンス監査スキル

hljs markdown
---
name: perf-audit
description: パフォーマンス監査を実行
version: 1.0.0
---

# パフォーマンス監査

## プロンプト

{{target}}のパフォーマンス監査を実行：

チェック項目：

1. **バンドルサイズ**
   - 総サイズ
   - コード分割の機会
   - 未使用の依存関係

2. **レンダリングパフォーマンス**
   - 不要な再レンダリング
   - メモ化の機会
   - 仮想化の必要性

3. **ネットワーク**
   - APIコールの最適化
   - キャッシング戦略
   - 並列リクエスト

4. **メモリ**
   - メモリリーク
   - 大きなオブジェクト
   - クリーンアップの問題

各問題について：
- 現在の状態
- パフォーマンスへの影響
- 推奨される修正
- 実装の優先度

スキルマーケットプレイス

公式スキルライブラリ

CCJKは公式スキルライブラリを提供：

hljs bash
# ライブラリを参照
claude skills browse

# カテゴリで検索
claude skills search --category testing

# スキルをインストール
claude skills install official/advanced-testing

コミュニティスキル

コミュニティが作成したスキルを探索：

hljs bash
# コミュニティスキルを検索
claude skills search --community "react hooks"

# 評価でフィルタリング
claude skills search --min-rating 4.5

まとめ

CCJKスキルシステムは、繰り返しのタスクを自動化し、ベストプラクティスを強制し、チーム全体で知識を共有する強力な方法を提供します。ビルトインスキルから始めて、ニーズに合わせてカスタムスキルを作成し、チームと共有してください。

効果的なスキルは：

• 明確な目的を持つ
• 適切にパラメータ化されている
• 一貫した出力を提供
• 十分に文書化されている
• バージョン管理されている

次へ：AIエージェントを使用して、さらに複雑なタスクを自動化する方法を学びます。

よくある質問

スキルとエージェントの違いは？

スキルは事前定義されたプロンプトテンプレートで、エージェントは複数のステップを自律的に実行できます。スキルは一貫性のために、エージェントは複雑なタスクのために使用します。

スキルを他の人と共有できますか？

はい！スキルファイルをGitリポジトリで共有したり、CCJKマーケットプレイスに公開したりできます。

スキルは他のツールと統合できますか？

はい、スキルはシェルコマンドを実行し、APIを呼び出し、他のツールと統合できます。

スキルのパフォーマンスを測定するには？

--metricsフラグを使用して、実行時間、トークン使用量、成功率を追跡します。