スキル作成コマンド

目的

Hospedaプロジェクト向けの新しいスキルを作成するためのガイドを提供します。スキルは、タスク実行中にエージェントによって呼び出される、特殊な再利用可能なワークフローです。このウィザードは、スキルがプロジェクト標準に従い、エージェントと適切に統合され、明確で実行可能なワークフローを提供することを確保します。

使用する場合

再利用可能なワークフロー: 複数のエージェントで使用されるプロセスの場合
ドメイン専門知識: 専門知識をコード化する必要がある場合
複雑な手順: 複数ステップのワークフローにドキュメント化が必要な場合
ベストプラクティス: プロジェクト全体でのアプローチを標準化する場合

使用方法

/create-skill [options]

オプション

--name <name>: スキル名（ケバブケース）
--category <category>: スキルカテゴリ（testing、development、validation、documentation）
--interactive: フルインタラクティブモード（デフォルト）
--template <type>: テンプレートを使用（workflow、validation、utility）

例

/create-skill                                    # インタラクティブモード
/create-skill --name api-testing --category testing
/create-skill --template validation --interactive

スキル作成プロセス

ステップ1: スキル検出と計画

質問事項:

スキル名（ケバブケース）:
- 例: api-integration-testing、git-workflow-helper、performance-profiling
- 一意で、説明的で、アクション指向である必要があります
- 検証: 小文字、ハイフンのみ
スキルカテゴリ:
- testing - テストワークフローと検証
- development - 開発ツールとヘルパー
- validation - 品質とコンプライアンス検証
- documentation - ドキュメント生成と管理
- automation - プロセスオートメーション
- analysis - コードとアーキテクチャ分析
1行の説明:
- スキルの目的を明確かつ簡潔に説明
- スキル一覧で使用
- スキルが何をするかを説明する必要があります
詳細な目的（2〜3段落）:
- このスキルはどのような問題を解決するか？
- どのような専門知識を提供するか？
- どのようなワークフローを自動化するか？
主要ユーザー（このスキルを使用するエージェント）:
- 例: qa-engineer、tech-lead、all-agents
- スキルの文書化場所を決定します
スキルタイプ:
- workflow - マルチステップのプロセスオートメーション
- validation - チェックと検証
- utility - ヘルパー関数とツール
- template - テンプレート生成
- analysis - コード/アーキテクチャ分析

ステップ2: ワークフロー定義

ワークフローステップ:

入力要件:
- どのような情報が必要か？
- どのファイルが存在すべきか？
- プロジェクトはどのような状態であるべきか？
プロセスステップ:
- ステップバイステップのワークフロー
- 決定ポイント
- エラーハンドリング
- 成功基準
出力/成果物:
- スキルは何を生成するか？
- どのファイルが作成/修正されるか？
- どのような情報が返されるか？
成功基準:
- スキルが正常に完了したことをどのようにして確認するか？
- どのような検証が合格すべきか？

ステップ3: スキルファイル生成

作成されるファイル: .claude/skills/{category}/{skill-name}.md

YAMLフロントマターテンプレート:

---
name: { skill-name }
category: { category }
description: { one-line description }
usage: このスキルをどのような場合にいつ呼び出すべきか
input: スキルが実行するために必要なもの
output: スキルが生成するもの
---

Markdownの構造:

# {Skill Name}

## 概要

**目的**: {このスキルが何をするか} **カテゴリ**: {category} **主要ユーザー**:
{このスキルを使用するエージェント}

## このスキルをいつ使用するか

{このスキルを使用するシナリオと条件}

## 前提条件

**必須:**

- {prerequisite-1}
- {prerequisite-2}

**オプション:**

- {optional-1}

## 入力

{スキルが必要とするもの}

## ワークフロー

### ステップ1: {ステップ名}

**目的**: {このステップが何を達成するか}

**アクション**:

1. {action-1}
2. {action-2}

**検証**:

- [ ] {check-1}
- [ ] {check-2}

**出力**: {このステップが生成するもの}

### ステップ2: {ステップ名}

[同様の構造...]

## 出力

**生成されるもの**:

- {output-1}
- {output-2}

**成功基準**:

- {criterion-1}
- {criterion-2}

## 例

### 例1: {シナリオ}

**コンテキスト**: {situation} **呼び出し**: {スキルの呼び出し方} **プロセス**:
{発生すること} **結果**: {outcome}

## エラーハンドリング

### エラー: {エラータイプ}

**原因**: {なぜ発生するか} **解決方法**: {修正方法}

## ベストプラクティス

{使用上のベストプラクティス}

## 関連スキル

{関連スキル}

## 注記

{追加注記}

ステップ4: 統合とドキュメント

必要な更新:

.claude/skills/README.md:
- カテゴリセクションにスキルを追加
- スキルカウントを更新
- 必要に応じて使用例を追加
エージェントドキュメント（スキルがエージェント固有の場合）:
- エージェントのツール一覧を更新して、スキルを含める
- エージェントのワークフローセクションでスキルを参照
.claude/docs/quick-start.md（広く使用されている場合）:
- 共通スキルセクションに追加

ステップ5: 検証とテスト

検証チェック:

スキル名が規約に従っている
YAMLフロントマターが有効
すべてのセクションが完全
ワークフローステップが明確で実行可能
前提条件が明確に定義されている
成功基準が測定可能
エラーハンドリングが文書化されている
ファイルが正しいディレクトリにある
ドキュメントが更新されている

テスト実行:

エージェントコンテキストからスキルを呼び出します:

{skill-name}スキルを使用して{task}を実行してください

確認事項:

スキルが正しく読み込まれる
ワークフローが明確で実行可能
出力がドキュメント通り
エラーハンドリングが機能する

ステップ6: コミットとドキュメント

コミットメッセージの形式:

feat(skills): {skill-name}スキルを追加

- {category}カテゴリに{skill-name}を追加
- {機能の簡単な説明}
- 主要ユーザー: {agents}

ワークフロー:
  {重要なワークフローステップ}

出力:
  {スキルが生成するもの}

更新:
- .claude/skills/{category}/{skill-name}.md (新規)
- .claude/skills/README.md (更新)

PF004-XX (P-004ワークフロー中の場合)

インタラクティブウィザードフロー

🎯 スキル作成ウィザード
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📝 ステップ1: スキルアイデンティティ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

スキル名（ケバブケース）: api-integration-testing
カテゴリ:
  1. testing - テストワークフロー ✓
  2. development - 開発ツール
  3. validation - 品質検証
  4. documentation - ドキュメント管理
  5. automation - プロセスオートメーション
  6. analysis - コード分析

カテゴリを選択（1-6）: 1

1行の説明:
> APIインテグレーション用の包括的なテストワークフロー
> 検証、エラーケース、ドキュメント作成を含む

スキルタイプ:
  1. workflow - マルチステップのプロセス ✓
  2. validation - チェックと検証
  3. utility - ヘルパー関数
  4. template - テンプレート生成
  5. analysis - 分析ツール

タイプを選択（1-5）: 1

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 ステップ2: 目的とユーザー
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

詳細な目的（2〜3段落）:
> APIインテグレーション用の体系的なテストアプローチを提供します。
> すべてのエンドポイントが適切にテストされ、ポジティブテストと
> ネガティブテストケースが実施され、ドキュメントが正確であることを
> 確保します。

主要ユーザー（カンマ区切りのエージェント）:
> qa-engineer, hono-engineer, tech-lead

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔧 ステップ3: ワークフロー定義
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

ワークフローステップを定義:

ステップ1タイトル: テスト計画
  アクション（1行につき1つ、完了時は空行）:
  - テスト対象のすべてのAPIエンドポイントを特定する
  - APIドキュメントとスキーマを確認する
  - テストシナリオを定義する（正常系、エラーケース、エッジケース）
  - テストデータとモックを準備する
  -

ステップ2タイトル: テスト実装
  アクション:
  - 各エンドポイント用のインテグレーションテストを作成する
  - 認証と認可をテストする
  - リクエスト/レスポンススキーマを検証する
  - エラーハンドリングをテストする
  -

ステップ3タイトル: 検証とドキュメント
  アクション:
  - すべてのテストを実行してカバレッジを確認する
  - テスト結果をドキュメント化する
  - 不一致が見つかった場合はAPIドキュメントを更新する
  -

ステップ4タイトル:

入力要件（スキルが必要とするもの）:
> - 定義済みのAPIルート
> - 利用可能なZodスキーマ
> - 設定済みのテストフレームワーク（Vitest）

出力/成果物（スキルが生成するもの）:
> - インテグレーションテストファイル
> - テストカバレッジレポート
> - APIドキュメント検証

成功基準:
> - すべてのエンドポイントにテストがある
> - 90%以上のテストカバレッジ
> - すべてのテストが合格
> - ドキュメントが実装と一致している

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📝 ステップ4: 確認と確定
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

スキルサマリー:
  名前: api-integration-testing
  カテゴリ: testing
  タイプ: workflow
  説明: APIインテグレーション用の包括的な...

  主要ユーザー:
    - qa-engineer
    - hono-engineer
    - tech-lead

  ワークフローステップ: 3つ定義済み
  入力: APIルート、スキーマ、テストフレームワーク
  出力: テストファイル、カバレッジ、ドキュメント

ファイルは以下に作成されます:
  .claude/skills/testing/api-integration-testing.md

ドキュメント更新:
  - .claude/skills/README.md

作成を進めますか？（y/n）: y

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✨ スキル作成中
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✓ スキルファイルを生成しました
✓ スキルREADMEを更新しました
✓ 検証に合格しました

📄 スキルが正常に作成されました!

ファイル: .claude/skills/testing/api-integration-testing.md

次のステップ:
1. 生成されたコンテンツを確認し、カスタマイズしてください
2. ユースケース用の具体的な例を追加してください
3. エージェントコンテキストからスキル呼び出しをテストしてください
4. 変更内容をコミットしてください

使用方法（エージェントから）:
  「api-integration-testingスキルを使用して予約APIをテストしてください」

推奨コミットメッセージ:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
feat(skills): api-integration-testingスキルを追加

- testingカテゴリにapi-integration-testingを追加
- APIエンドポイント用の体系的なテストワークフロー
- ポジティブテスト、ネガティブテスト、エッジケースに対応
- 主要ユーザー: qa-engineer, hono-engineer, tech-lead

ワークフロー:
  - テスト計画とシナリオ定義
  - スキーマ検証を含むテスト実装
  - 検証とドキュメント作成

出力:
  - インテグレーションテストファイル
  - カバレッジレポート
  - ドキュメント検証

更新:
- .claude/skills/testing/api-integration-testing.md (新規)
- .claude/skills/README.md (更新)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

スキルテンプレート

ワークフロースキルテンプレート

---
name: { skill-name }
category: { category }
description: { description }
usage: {usage-context}の場合にこのスキルを呼び出します
input: { input-requirements }
output: { output-produced }
---

# {Skill Name}

## 概要

**目的**: {what-skill-does} **カテゴリ**: {category} **主要ユーザー**:
{agents}

## このスキルをいつ使用するか

{Use-case scenarios}

## 前提条件

**必須:**

- {required-1}

**オプション:**

- {optional-1}

## 入力

{Input-details}

## ワークフロー

### ステップ1: {Step-Name}

**目的**: {objective}

**アクション**:

1. {action}

**検証**:

- [ ] {check}

**出力**: {step-output}

## 出力

**生成されるもの**:

- {output}

**成功基準**:

- {criterion}

## 例

### 例: {Scenario}

**コンテキスト**: {context} **プロセス**: {process} **結果**: {result}

## エラーハンドリング

### エラー: {Error-Type}

**原因**: {cause} **解決方法**: {resolution}

## ベストプラクティス

{practices}

## 関連スキル

{related}

## 注記

{notes}

検証スキルテンプレート

---
name: { skill-name }
category: validation
description: { description }
usage: {what-is-validated}を検証するために使用します
input: { what-needs-validation }
output: パス/フェイル状態の検証レポート
---

# {Skill Name}

## 概要

**目的**: {validation-purpose} **カテゴリ**: validation **主要ユーザー**:
{agents}

## このスキルをいつ使用するか

{When-to-validate}

## 前提条件

{Prerequisites}

## 入力

{What-to-validate}

## 検証チェックリスト

### カテゴリ1: {Category}

- [ ] {check-1}
- [ ] {check-2}

### カテゴリ2: {Category}

- [ ] {check-1}

## 検証プロセス

{Process-steps}

## 出力形式

{example-output}


## エラーハンドリング

{error-handling}

## 例

{examples}

## 関連スキル

{related}

ユーティリティスキルテンプレート

---
name: { skill-name }
category: { category }
description: { description }
usage: {what-it-does}するために使用します
input: { input }
output: { output }
---

# {Skill Name}

## 概要

**目的**: {purpose} **カテゴリ**: {category} **主要ユーザー**: {agents}

## いつ使用するか

{when-to-use}

## 使用方法

{how-to-use}

## プロセス

{process}

## 出力

{output}

## 例

{examples}

## 注記

{notes}

検証ルール

スキル名

形式: ケバブケースのみ
長さ: 3〜40文字
パターン: ^[a-z][a-z0-9-]*[a-z0-9]$
一意性: 既存のスキルとの競合がないこと
説明的: 機能を明確に示すべき

YAMLフロントマター

必須フィールド: name、category、description、usage、input、output
有効なカテゴリ: testing、development、validation、documentation、automation、analysis
説明: 1行の概要
使用方法: 呼び出すタイミング
入力: 必要なもの
出力: 生成されるもの

ディレクトリ構造

.claude/skills/
├── testing/          # テストワークフロー
├── development/      # 開発ユーティリティ
├── validation/       # 検証ワークフロー
├── documentation/    # ドキュメント管理
├── automation/       # プロセスオートメーション
└── analysis/         # 分析ツール

ファイル命名

パターン: {skill-name}.md
場所: .claude/skills/{category}/{skill-name}.md
ケース: すべて小文字
拡張子: .mdのみ

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

再利用性

汎用的: 複数のユースケース向けに設計
パラメータ化: コンテキスト固有の入力を受け入れる
モジュラー: 複雑なワークフローをステップに分割

明確さ

明確なステップ: 各ステップが明確な目的を持つ
実行可能: ステップは具体的で実行可能
検証済み: 各ステップで検証を含める

ドキュメント

例: 現実的な例を含める
エラーケース: エラーシナリオを文書化する
前提条件: 要件を明確に記述

統合

エージェント対応: エージェント呼び出し向けに設計
ツール互換: 利用可能なツールと連携
ワークフロー統合: 既存のワークフローに適合

一般的なスキルパターン

テストワークフロー

前提条件チェック
テスト計画
テスト実装
検証
ドキュメント

検証ワークフロー

入力検証
基準チェック
結果コンパイル
レポート生成

ユーティリティワークフロー

入力処理
操作実行
出力フォーマット

注記

スキルとコマンド: スキルはエージェントが呼び出し、コマンドはユーザーが呼び出す
スコープ: スキルを単一責任に焦点を当てる
ドキュメント: 包括的なドキュメントはエージェントの理解に重要
テスト: 実際のエージェントコンテキストからスキル呼び出しをテスト
進化: パターンが出現するにつれてスキルは進化できる
命名: アクション指向の名前を使用（動詞-名詞パターンが推奨）

このコマンドは、スキル作成を合理化し、再利用性、明確さ、エージェントシステムとの適切な統合を確保します。

変更履歴

バージョン	日付	変更内容	著者	関連
1.0.0	2025-10-31	初版	@tech-lead	P-004

ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ

create-skill

SKILL.md 本文