element-definition-convention

# Element Definition Convention

## 概要

このSkillは、プラグイン要素（エージェント、スキル、コマンド）の定義ルールを明確化する。命名規則、フロントマターの必須項目、必須セクション、ドキュメント記述フォーマットについて標準を定義し、一貫性のあるプラグイン要素の作成を実現することを目的とする。

## 責任範囲

このSkillは以下の範囲をカバーする:

- プラグイン要素（エージェント、スキル、コマンド）の命名規則
- フロントマターの必須項目と記述ルール
- 必須セクション（概要、責任範囲、基本方針など）の定義
- ドキュメント記述フォーマットと記述原則
- チェックリストの作成ガイドライン

## 基本方針

- 命名はケバブケース（kebab-case）を使用する
- フロントマターにはname、descriptionを必須とする
- 必須セクションを統一し、一貫性を保つ
- ドキュメントは日本語・常体で記述する
- 簡潔で明確な文章を使用する
- 箇条書きを活用して情報を整理する

## 命名規則

### エージェントの命名

エージェントの役割を表す名前を使用する。

**命名パターン:**

- `[役割]-agent`の形式を使用する
- 責任範囲が明確にわかる名前にする
- ケバブケース（例: requirements-agent, design-agent）を使用する

良い例:

```text
requirements-agent
design-agent
implementation-agent
test-agent
```

悪い例:

```text
RequirementsAgent (キャメルケースは使用しない)
req-agent (省略形は避ける)
requirements_agent (スネークケースは使用しない)
agent-requirements (順序が逆)
```

### スキルの命名

スキルの目的を表す名前を使用する。

**Workflow Skillの命名パターン:**

- 動詞を含む名前にする（例: code-generator, api-designer）
- 「何を生成するか」「何を設計するか」を明確にする
- ケバブケース（例: database-schema-designer）を使用する

**Convention Skillの命名パターン:**

- 規約の対象を表す名前にする（例: coding-conventions, documentation-standards）
- 複数形を使用することが多い（conventions, standards, guidelinesなど）
- ケバブケース（例: security-guidelines）を使用する

良い例（Workflow Skill）:

```text
code-generator
api-designer
database-schema-designer
requirements-structurer
```

良い例（Convention Skill）:

```text
coding-conventions
documentation-standards
security-guidelines
interaction-guidelines
```

悪い例:

```text
CodeGenerator (キャメルケースは使用しない)
api_designer (スネークケースは使用しない)
gen-code (省略形は避ける)
generator (目的が不明確)
```

### コマンドの命名

コマンドの機能を表す名前を使用する。

**命名パターン:**

- ユーザーが覚えやすい簡潔な名前にする
- 動詞または名詞を使用する（例: requirements, design, generate）
- ケバブケース（例: test-run）を使用する
- 複数単語の場合は、意味が明確になるようにする

良い例:

```text
requirements
design
task
implement
test-run
generate-plugin
```

悪い例:

```text
req (省略形は避ける)
RequirementsCommand (キャメルケースは使用しない)
requirements_command (スネークケースは使用しない)
command-requirements (順序が逆)
```

## フロントマターの定義

すべてのプラグイン要素のマークダウンファイルには、フロントマターを記述する。

**必須