Skills:口調・事実・規約をBriksに

#スキルとは

Skillsページには、次のようにまとめられています。“Guidance the builder follows on your workspace's projects when a task fits it: your tone, your facts, your conventions. The studio's own design and code rules always come first.”

スキルはすべて3つの部分でできています。

スキルはワークスペースに属します。オンのスキルは、そのワークスペースのすべてのプロジェクトに適用され、他のワークスペースには適用されません。同時にオンにできるのは25個までです。一覧の上に、たとえば「3 of 4 on. The builder receives the ones that are on with every job in this workspace, and only here.」のように件数が表示されます。

#スキルが使われるときと、使われないとき

スキルが加えるのは知識であり、デザインではありません。黒いフッターのように見た目を固定したいルールには、Settings、Preferences の Rules in your own words を使ってください。これは “Kept to, build after build.” という設定です。

新しいスキルや編集したスキルは、次のビルドまたは変更から反映されます。それまで公開済みサイトは変わりません。

#スキルを管理できる人

OwnerとAdminは、スキルの追加、編集、切り替え、更新、削除ができます。Adminの役割は「Manages members, settings, templates and skills, and moves projects.」と表示されます。EditorとViewerは Skills ページを開いて一覧を読めますが、スイッチはグレー表示で、Add skill ボタンはありません。メンバーと権限をご覧ください。

#スキルを追加

Add skillをクリックします。Add a skillというボックスが開き、始め方が3つ表示されます。「Choose how to start. You read and can edit every skill before the builder receives it.」

AIで下書きする

Draft a skill with AI の What the skill should do に、Briks に知っておいてほしいことや、いつも行ってほしいことを20〜4,000文字で書きます。Draft it をクリックすると、スタジオに「Usually under a minute.」と表示されます。下書きは Review the drafted skill で開くので、読んで編集してください。Add skill の後は、「added. It stays off until you turn it on.」と表示されます。

GitHubからインポート

Import a skill from GitHubに、公開リポジトリのSKILL.md、フォルダー、またはリポジトリ全体へのGitHub linkを貼り付けて、Read itをクリックしてください。リンク先に複数のスキルがある場合は、一覧から1つ選んでRead this oneをクリックします。Review the imported skillには、コミットとともに全文が表示されます。「Read it all: the builder follows it as written.」インポートは1時間に30件まで読み込めます。

取り込んだスキルは、読み込んだコミットに固定されたままです。新しいものを取り込むには、スキルのメニューを開いて Check for update を選びます。最新の状態であると表示されるか、保存する前に確認できるよう新しいバージョンが開きます。

#安全性の確認

スキルは、入力するときと保存するときに、毎回内容が確認されます。危険そうな点があると、Read these before adding itというパネルに見つかった内容が一覧で表示され、「I have read the instructions and they are safe to follow.」にチェックを入れるまで、Add skillは押せません。その後、スキルには一覧でRead before useのタグが付き、同じ注意書きが表示されます。確認する内容は次のとおりです。

• 「ビルダーに、先に設定したルールや指示を無視するよう求めている。」
• 「ビルダーの正体や、そのシステムの内容を変えようとしている。」
• 「キー、シークレット、認証情報に触れている。」
• 「他のアドレスへのリクエストを求めています。」
• 「別のアドレスのスクリプトをページに追加します。」
• 「テキストをコードとして実行したり、生のHTMLを設定したりするコードを求めています。」
• 挙げられたウェブアドレスの数です。

#オフにする、編集する、削除する

各スキルの右側にはスイッチがあり、メニューにはEdit、インポートしたスキル用のCheck for update、Deleteがあります。新しいスキルはすべてオフで始まるので、Briksが使う前にご自身で内容を読めます。オフにしても、スキルは後のために残ります。25個がオンのときは、他のスキルのスイッチはグレーアウトされ、どれかをオフにするまで操作できません。削除する前に確認が表示されます。「The builder stops receiving it from the next change on.」

#コピーして使える3つのスキル

#うまく動くスキルの書き方

• When to use it には、「メニューページや料理の一覧」のように、作業内容を書いてください。あいまいな書き方だと、Briksがそのスキルを使わないことがあります。
• ルールは、やるべきこととして書き、理由が分かりにくい場合は理由も添えましょう。
• 良い例と悪い例を挙げましょう。よい例が1つあれば、ルール5つより効くことがよくあります。
• 情報は常に最新に保ちましょう。価格や住所が変わったらスキルを編集し、変更を依頼して公開中のサイトに反映させます。
• スキルは1つにつき1つの主題にしましょう。トーンのスキルと事実のスキルは、両方を詰め込んだ長いスキルよりも、切り替えや更新が簡単です。