# 発火する description の作り方

Skill が選ばれる手がかりは `description` の文章だけです。名前は手がかりになりません。

## 入れるもの

1. 何をするものか（動詞で）
2. どういう言い方をされたときに使うか（実際に打ちそうな日本語を2つか3つ、そのまま入れる）
3. 対象を絞る語（プロジェクト名、ファイルの種類、作業の場面）

## 例

発火しにくい書き方です。

```
description: コードの品質を改善します。
```

「品質」という語で依頼する人はほとんどいません。実際に打つ言葉が入っていません。

直した例です。

```
description: 業務ルールの記述と実装の食い違いを探します。「ルールと実装が合っているか調べて」「仕様と違う挙動を探して」「業務ルールと突き合わせて」のときに使います。Java と Thymeleaf の画面表示を対象にします。
```

## 誤発火するとき

広すぎる description は、関係ない依頼でも選ばれます。

```
description: コードを見て問題を指摘します。
```

これだと「このコードを整形して」でも発火します。対象を絞る語を足します。

```
description: 業務ルールと実装の食い違いだけを探します。整形・命名・スタイルの指摘はしません。
```

「しないこと」を description に1文入れると、誤発火が減ります。

## 発火しないとき

description の言葉と、実際に打った言葉が離れています。直し方は2つです。

1. 実際に打った言葉を description にそのまま足す
2. 言い換えを2つか3つ並べる（「調べて」「探して」「突き合わせて」）

言葉を増やすほど発火しやすくなりますが、増やしすぎると誤発火します。実際に使いながら削るのが早道です。
