ベストプラクティス
効果的でメンテナンス可能なAgent Skillsを作成するためのガイドラインです。
概要
よく設計されたスキルは、役立つAIアシスタントとイライラさせるものの違いを生みます。これらのベストプラクティスに従って、信頼性の高いスキルを作成しましょう。
基本原則
1. 曖昧ではなく具体的に
良い例：
「見出しにはセンテンスケースを使用。最初の単語と固有名詞のみを大文字に。」
悪い例：
「適切な大文字を使用。」
2. 例を提供する
単に伝えるのではなく、見せましょう。期待される動作の具体例を含めます。
良い例：
日付のフォーマット時：
- こう書く：「2024年1月15日」
- こう書かない：「01/15/24」または「15 Jan 2024」
3. スコープを明確に定義
スキルがカバーするものとカバーしないものを明示的に述べます。
良い例：
このスキルがカバーするもの：
- Reactコンポーネント設計
- 状態管理
- パフォーマンス最適化
このスキルがカバーしないもの：
- バックエンドAPI設計
- データベーススキーマ
- DevOps/デプロイメント
4. 一貫した構造を使用
AIが素早く情報を見つけられるように、コンテンツを予測可能な形で整理します。
推奨セクション：
- コンテキスト/概要
- ガイドライン
- すべきこと・すべきでないこと
- 例
- 参考資料
5. 焦点を絞る
1つのスキル = 1つのドメイン。すべてをカバーしようとしないでください。
良い例： 「React コンポーネントガイドライン」 悪い例： 「完全なWeb開発ガイド」
よくある間違い
過度なエンジニアリング
価値を提供しない複雑さを追加しない：
- 互いに矛盾する多すぎるルール
- めったに発生しないエッジケース
- 冗長な情報
不十分な仕様
重要な詳細を曖昧にしない：
- 主要な概念の例がない
- 「適切に」などの曖昧な表現
- エッジケースのガイダンスがない
矛盾する指示
ガイドラインが互いに矛盾しないようにする：
問題：
「回答は簡潔に」と「詳細な説明を提供」
解決策：
「回答は簡潔に。複雑なトピックについては、展開可能なセクションで詳細な説明を提供。」