よくある質問

チームでスキルをどう共有しますか

適用対象のリポジトリに置き、配布はバージョン管理に任せてください。クローンした全員が同じリビジョンの同じスキルを受け取り、変更はほかの変更と同じくレビューを通って届き、ずれていく別のコピーが存在しません。

配布の仕組みはバージョン管理

スキルはディレクトリに置かれたプレーンテキストであり、リポジトリが得意とするものそのものです。コミットしておけば、プルリクエストがエージェントの振る舞いを変え、レビュアーが異議を出せ、悪い指示を差し戻せます。フォルダを配って回る方式では、一か月もすれば全員が少しずつ違う版を持ちます。

置き場所は適用範囲が決める

このコードベースの動き方を書いたスキルは、このコードベースに置きます。会社全体の進め方を書き、複数のリポジトリにまたがるスキルは、一か所にまとめて他から取りに行く形が向いています。規約が変わったときに直すべきコピーが一つで済むからです。

description も指示と同じ厳しさで見る

二つのチームが別々にスキルを足していくことが、説明の重複が始まる典型的な経路であり、重複こそが意図しないスキルを勝たせる原因です。取り込む前に、新しいスキルの description を既存のものと突き合わせて読む価値があります。あとから衝突を追いかけるより安い習慣です。