スキルを1つ作って、発火を試す

スキルは「手順をひとまとめにしたもの」

毎回同じ説明を書いているなら、それはスキルにできます。スキルは、決まった手順・使う資料・必要なスクリプトをひとまとめにした置き場所です。

指示ファイルとの違いは、読み込まれるタイミングです。指示ファイルは毎回読まれます。スキルは、必要だと判断されたときだけ読み込まれます。

説明文が、そのまま起動条件になります

スキルが使われるかどうかは、短い説明文で決まります。ここが曖昧だと、必要なときに使われず、要らないときに使われます。

弱い説明

「テストに関する作業を助けます」。範囲が広すぎて、いつ呼ぶべきか分かりません。

強い説明

「このリポジトリで新しい API ルートを追加するとき、必要なテストと登録先を揃えるために使う」。

何をするかだけでなく、どんなときに使うかを書いてください。

中身は、その手順だけで完結させます

スキルを読んだ時点で作業ができる状態にします。前提を別の場所に置いたままにすると、読み込まれた側は途中で行き止まりになります。

一方で、全部を1ファイルに詰め込む必要はありません。入口は短く保ち、長い資料は参照にします。この考え方は、指示ファイルと同じです。

発火しないことも、確かめます

作ったスキルは、2通り試してください。

使われてほしい場面

想定どおり読み込まれ、手順どおりに進むか。

使われてほしくない場面

関係のない作業で、勝手に読み込まれないか。

どちらか片方しか試していないスキルは、本番で驚きを生みます。