ビルダーエージェントガイド

---
# 公式フィールド (Official Fields)
name: my-custom-skill # スキル識別子 (kebab-case、最大 64 文字)
description: > # 目的説明 (50～1024 文字、3 人称)
  カスタムスキルの説明。何に使用するか、どのような専門知識を提供するか
  3 人称で作成。
allowed-tools: # 許可ツール (カンマ区切りまたはリスト)
  - Read
  - Grep
  - Glob
model: claude-sonnet-4-20250514 # 使用するモデル (省略時は現在のモデル)
context: fork # サブエージェントコンテキストで実行
agent: general-purpose # context: fork 時に使用するエージェント
hooks: # スキルライフサイクルフック
  PreToolUse: ...
user-invocable: true # スラッシュコマンドメニュー表示設定
disable-model-invocation: false # false なら Claude も直接呼び出し可能
argument-hint: "[issue-number]" # 自動補完ヒント
 
# MoAI-ADK 拡張フィールド (Extended Fields)
version: 1.0.0 # セマンティックバージョン (MAJOR.MINOR.PATCH)
category: domain # 8 カテゴリーの中から 1 つ選択
modularized: false # modules/ ディレクトリ使用設定
status: active # active | experimental | deprecated
updated: "2025-01-28" # 最終更新日
tags: # 発見用タグ配列
  - graphql
  - api
related-skills: # 関連スキル
  - moai-domain-backend
  - moai-lang-typescript
context7-libraries: # MCP Context7 ライブラリ ID
  - graphql
aliases: # 代替名
  - graphql-expert
author: YourName # 作成者
---

.claude/skills/my-skills/
└── my-graphql-patterns/
    ├── SKILL.md            # メインスキルドキュメント (500 行以下)
    ├── modules/            # 深層ドキュメント (無制限)
    │   ├── schema-design.md
    │   └── resolver-patterns.md
    ├── examples.md         # 実戦例
    └── reference.md        # 外部参照

---
# YAML
---
 
# プロジェクト情報
プロジェクト名: !basename $(pwd) Git ブランチ: !git branch --show-current

# Claude Code で builder-skill 呼び出し
> GraphQL API 設計パターンに関するカスタムスキルを作成して

---
name: my-graphql-patterns
description: >
  GraphQL API 設計専門家。スキーマ設計、リゾルバパターン、N+1 問題解決、DataLoader
  パターンを提供する。GraphQL API 開発時に使用。
version: 1.0.0
category: domain
status: active
triggers:
  keywords: ["graphql", "schema", "resolver", "dataloader"]
  agents: ["expert-backend"]
allowed-tools: ["Read", "Grep", "Glob"]
---
 
# GraphQL API 設計専門家
 
## Quick Reference
 
- スキーマファースト設計 (Schema-First)
- N+1 問題防止のための DataLoader 必須
- ページネーションは Relay Cursor 方式使用
 
## Implementation Guide
 
(詳細実装ガイド)
 
## Advanced Patterns
 
(高度なパターン)
 
## Works Well With
 
- moai-domain-backend
- moai-lang-typescript

---
name: my-data-analyst
description: >
  データ分析専門家。データパイプライン設計、ETL プロセス、分析クエリ最適化を
  担当。PROACTIVELY 使用してデータ分析作業時に自動委任。
tools: Read, Write, Edit, Grep, Glob, Bash, TodoWrite
disallowedTools: Task, Skill # 選択肢: 除外するツール
model: sonnet # sonnet | opus | haiku | inherit
permissionMode: default # 権限モード
skills: # 事前ロードするスキル
  - moai-lang-python
  - moai-domain-database
hooks: # エージェントライフサイクルフック
  PostToolUse:
    - matcher: "Write|Edit"
      hooks:
        - type: command
          command: "echo 'File modified'"
---
 
あなたはデータ分析専門家です。
 
## Primary Mission
 
データパイプライン設計および実装を通じてデータ主導のインサイトを提供します。
 
## Core Capabilities
 
- データパイプライン設計および実装
- ETL プロセス自動化
- 分析クエリ最適化
- データ可視化
 
## Scope Boundaries
 
IN SCOPE:
 
- データ分析および可視化
- ETL プロセス設計
- クエリパフォーマンス最適化
 
OUT OF SCOPE:
 
- ML モデル開発 (expert-data-science に委任)
- インフラ構成 (expert-devops に委任)
 
## Delegation Protocol
 
- ML モデル必要時: expert-data-science
- インフラ設定時: expert-devops
 
## Quality Standards
 
- TRUST 5 フレームワーク準拠
- データ完全性検証
- クエリパフォーマンス最適化

my-plugin/
├── .claude-plugin/
│   └── plugin.json         # プラグインマニフェスト
├── commands/               # スラッシュコマンド (ルートレベル!)
│   └── analyze.md
├── agents/                 # エージェント定義 (ルートレベル!)
│   └── data-expert.md
├── skills/                 # スキル定義 (ルートレベル!)
│   └── my-skill/
│       └── SKILL.md
├── hooks/                  # Hooks 設定 (ルートレベル!)
│   └── hooks.json
├── .mcp.json               # MCP サーバー設定
├── .lsp.json               # LSP サーバー設定
├── LICENSE
├── CHANGELOG.md
└── README.md

{
  "name": "my-data-plugin",
  "version": "1.0.0",
  "description": "データ分析作業のための総合プラグイン",
  "author": {
    "name": "My Team",
    "email": "[email protected]",
    "url": "https://example.com"
  },
  "homepage": "https://example.com/docs",
  "repository": {
    "type": "git",
    "url": "https://github.com/owner/repo"
  },
  "license": "MIT",
  "keywords": ["data", "analytics", "etl"],
  "commands": ["./commands/"],
  "agents": ["./agents/"],
  "skills": ["./skills/"],
  "hooks": "./hooks/hooks.json",
  "mcpServers": "./.mcp.json",
  "lspServers": "./.lsp.json",
  "outputStyles": "./output-styles/"
}

{
  "name": "my-marketplace",
  "owner": {
    "name": "My Organization",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "plugin-one",
      "source": "./plugins/plugin-one"
    },
    {
      "name": "plugin-two",
      "source": {
        "type": "github",
        "repo": "owner/repo"
      }
    }
  ]
}

# GitHub からプラグインインストール
$ /plugin install owner/repo
 
# ローカルプラグイン検証
$ /plugin validate .
 
# プラグイン有効化
$ /plugin enable my-data-plugin
 
# Marketplace 追加
$ /plugin marketplace add ./path/to/marketplace
 
# インストール済みプラグインリスト
$ /plugin list

# プラグイン作成リクエスト
> データ分析プラグインを作成して。
> スキル、エージェント、コマンドをすべて含めて。

# スキル作成
> @"builder-skill (agent)" GraphQL パターンに関するカスタムスキルを作成して
 
# エージェント作成
> @"builder-agent (agent)" データ分析専門家エージェントを作成して
 
# プラグイン作成
> @"builder-plugin (agent)" データ分析総合プラグインを作成して