Skip to content

ベストプラクティス

1. 適切なSkillの選択

タスクタイプに基づいてSkillを選択:

タスクタイプ推奨組み合わせ
高速Gitコミットdelegate_task(category='quick', load_skills=['git-master'])
UIインターフェースデザインdelegate_task(category='visual-engineering', load_skills=['frontend-ui-ux'])
ブラウザ検証delegate_task(category='quick', load_skills=['playwright'])
複雑なブラウザワークフローdelegate_task(category='quick', load_skills=['dev-browser'])

2. 複数Skillsの組み合わせ

複数のSkillsを同時に読み込むことができます:

typescript
delegate_task(
  category="quick",
  load_skills=["git-master", "playwright"],
  prompt="ログイン機能をテストし、完了後にコードをコミット"
)

3. よくある間違いの回避

警告

  • 間違いgit-master 使用時に手動でコミットメッセージを指定

    • 正しいgit-master にプロジェクトスタイルに合ったコミットメッセージの自動検出と生成を任せる
  • 間違いfrontend-ui-ux 使用時に「普通でいい」と要求

    • 正しい:エージェントにデザイナー能力を最大限発揮させ、独自のデザインを創造させる
  • 間違いdev-browser スクリプトでTypeScript型アノテーションを使用

    • 正しいpage.evaluate() 内では純粋なJavaScriptを使用(ブラウザはTS構文を認識しない)

本レッスンのまとめ

本レッスンでは4つの組み込みSkillsを紹介しました:

Skill中核的価値典型的シナリオ
playwright完全なブラウザ自動化UIテスト、スクリーンショット、クローリング
frontend-ui-uxデザイナー視点、美観優先UIコンポーネントデザイン、インターフェース美化
git-masterGit操作の自動化、原子コミットコードコミット、履歴検索
dev-browser永続化セッション、複雑なワークフロー複数回のブラウザ操作

中核ポイント

  1. Skill = 専門知識 + ツール:エージェントに特定領域のベストプラクティスを注入
  2. 組み合わせ使用delegate_task(category=..., load_skills=[...]) で精密マッチングを実現
  3. コスト最適化:単純なタスクには quick categoryを使用し、高価なモデルを避ける
  4. アンチパターンワーニング:各Skillには明確な「何をしないか」の指針がある

次回レッスン予告

次回は ライフサイクルフック を学びます。

学ぶ内容:

  • 32個のライフサイクルフックの役割と実行順序
  • コンテキスト注入とエラー回復の自動化方法
  • よく使用するフックの設定方法(todo-continuation-enforcer、keyword-detector など)

付録:ソースコード参照

ソースコードの場所を表示

更新日:2026-01-26

機能ファイルパス行番号
playwright Skill定義src/features/builtin-skills/skills.ts4-16
createBuiltinSkills関数src/features/builtin-skills/skills.ts1723-1729
BuiltinSkill型定義src/features/builtin-skills/types.ts3-16
組み込みSkills読み込みロジックsrc/index.ts51, 311-319
ブラウザエンジン設定src/config/schema.ts-

重要な設定

  • browser_automation_engine.provider: ブラウザ自動化エンジン(デフォルト playwright、オプション agent-browser
  • disabled_skills: 無効にするSkillリスト

重要な関数

  • createBuiltinSkills(options): ブラウザエンジン設定に基づき対応するSkills配列を返す