메뉴
プロジェクトを分析してAsyncAPI 3.0.0仕様書を自動生成するスキル。CLAUDE.mdやAGENT.mdからプロジェクト概要を読み取り、使用プロトコル/基盤を検出し、チャンネル・メッセージ・オペレーション定義を抽出する。以下の場合に使用:(1) 既存プロジェクトのAsyncAPI仕様書を作成したい時、(2) イベント/メッセージAPIドキュメントを自動生成したい時、(3) AsyncAPI仕様書が必要な時
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
TerraformプロジェクトのAWSインフラにおけるネットワーク接続性と権限設定を分析します。セキュリティグループ、IAMポリシー、NACLなどを解析し、リソース間の通信可否、不要な接続、権限の過不足を検出します。Terraformファイルやtfstateがあるプロジェクトで、インフラのセキュリティレビューやネットワーク接続の検証が必要な場合に使用します。
要求定義書のレビューを行うスキル。品質チェック・矛盾検出・抜け漏れ検出・曖昧性分析を実施し、 構造化レポートを出力する。以下の場合に使用: (1) 要求定義書・要件定義書をレビューしたい時、 (2) 要求の品質や完全性を確認したい時、 (3) 矛盾・抜け漏れ・曖昧な表現を検出したい時
言語非依存のプログラミングベストプラクティスとガイドライン。コードを書く・関数/クラス/モジュールを実装する・プログラムを新規作成するあらゆる場面でPROACTIVELYに使用すること。コーディング開始前に必ずこのスキルを読み込む。コードレビュー・設計レビューにも使用する。
言語非依存の単体テストベストプラクティスとガイドライン。テストコードを書く・テストケースを追加する・テストスイートを作成するあらゆる場面でPROACTIVELYに使用すること。テストコーディング開始前に必ずこのスキルを読み込む。既存テストのレビューにも使用する。
仕様からテストケースを体系的に生成するスキル。状態機械・自然言語・Mermaid・シーケンス図など多様な入力形式に対応し、CSP安定失敗モデルに基づいて受理テストケース（トレース集合内）と拒否テストケース（トレース集合外）を網羅的に導出する。活性・到達可能性・安全性の3性質を検証するテストスイートを生成する。要求定義・仕様記述・設計成果物からのテストケース生成、テスト設計レビュー、テストカバレッジ分析に使用する。
CSPの安定失敗モデルに基づく状態機械ベースの形式仕様書を作成するスキル。 機能要求（活性・到達可能性・安全性）を入力として、 状態変数・遷移（イベント[ガード]/事後条件）・失敗集合を定義する トップレベル仕様およびコンポーネント仕様を生成する。 画面表示を持つシステムでは画面表示関数も定義する。
| name | asyncapi-spec-generator |
| description | プロジェクトを分析してAsyncAPI 3.0.0仕様書を自動生成するスキル。CLAUDE.mdやAGENT.mdからプロジェクト概要を読み取り、使用プロトコル/基盤を検出し、チャンネル・メッセージ・オペレーション定義を抽出する。以下の場合に使用:(1) 既存プロジェクトのAsyncAPI仕様書を作成したい時、(2) イベント/メッセージAPIドキュメントを自動生成したい時、(3) AsyncAPI仕様書が必要な時 |
| disable-model-invocation | true |
プロジェクトを分析してAsyncAPI 3.0.0形式のAPI仕様書を自動生成します。
目的: プロジェクトドキュメントから全体像と使用プロトコルを理解する
プロジェクトドキュメントの検索と読み取り
find . -maxdepth 2 \( -name 'AGENTS.md' -o -name 'CLAUDE.md' -o -name 'README.md' \) -type f 2>/dev/null
優先順位: AGENTS.md > CLAUDE.md > README.md
各ファイルを読み込み、以下の情報を抽出:
a) 基本情報 (AsyncAPI仕様書に使用)
info.titleinfo.descriptioninfo.versioninfo.contactdefaultContentTypeb) メッセージ基盤/プロトコル情報 (検出に使用)
プロトコル検出結果の確認
ドキュメントから1つ以上のプロトコルが特定できた場合:
✓ プロトコル検出: [Kafka/MQTT/...]
→ Phase 3へ進む
ドキュメントから特定できなかった場合:
⚠ ドキュメントからプロトコルを特定できませんでした
→ Phase 2でフォールバック検出を実行します
→ Phase 2へ進む
プロジェクト構造のスキャン
tree -L 3 -I 'node_modules|venv|.git|__pycache__|vendor|target' 2>/dev/null
find . -maxdepth 3 -type d \
-not -path '*/node_modules/*' \
-not -path '*/venv/*' \
-not -path '*/.git/*' \
-not -path '*/__pycache__/*' \
-not -path '*/vendor/*' \
-not -path '*/target/*' \
2>/dev/null | head -50
find . -maxdepth 4 -type d \( -name 'src' -o -name 'app' -o -name 'services' -o -name 'handlers' -o -name 'consumers' -o -name 'producers' \) 2>/dev/null
出力先の確認
asyncapi.yaml)目的: Phase 1で特定できなかった場合、設定ファイルからプロトコルを検出する
注意: Phase 1で特定できた場合、このPhaseはスキップして Phase 3へ進む
| 基盤/プロトコル | 検出ファイル | 検索パターン |
|---|---|---|
| Kafka | package.json, pom.xml, build.gradle, go.mod, requirements.txt, pyproject.toml | kafka, kafkajs, spring-kafka, segmentio/kafka-go, confluent-kafka |
| RabbitMQ/AMQP | 同上 | rabbitmq, amqp, amqplib, spring-amqp |
| MQTT | 同上 | mqtt, paho-mqtt, hbmqtt |
| NATS | 同上 | nats, nats.js, nats.go |
| Redis Streams | 同上 | redis, ioredis, spring-data-redis |
| AWS SNS/SQS | 同上 | sns, sqs, aws-sdk, boto3 |
| WebSocket | 同上 | websocket, ws, socket.io, spring-websocket |
設定ファイルの検索
find . -maxdepth 2 \( \
-name 'package.json' -o \
-name 'requirements.txt' -o \
-name 'pyproject.toml' -o \
-name 'pom.xml' -o \
-name 'build.gradle' -o \
-name 'go.mod' -o \
-name 'Gemfile' -o \
-name 'composer.json' \
\) -type f 2>/dev/null
設定ファイルの読み取りと検索
検出できなかった場合
目的: 検出されたプロトコルに対応するリファレンスのみを読み込む
プロトコル別リファレンスの読み込み
| 検出されたプロトコル | 読み込むリファレンス |
|---|---|
| Kafka | references/protocols/kafka.md |
| RabbitMQ/AMQP | references/protocols/amqp.md |
| MQTT | references/protocols/mqtt.md |
| NATS | references/protocols/nats.md |
| Redis Streams | references/protocols/redis-streams.md |
| AWS SNS/SQS | references/protocols/aws-sns-sqs.md |
| WebSocket | references/protocols/websocket.md |
重要: Progressive Disclosure設計に従い、検出されたプロトコルのリファレンスのみを読み込むこと。
AsyncAPIスキーマリファレンスの読み込み
全プロトコル共通で references/asyncapi-schema.md を読み込む:
読み込み確認
✓ リファレンス読み込み完了:
- references/protocols/[protocol].md
- references/asyncapi-schema.md
目的: プロトコル固有のパターンを使用してチャンネルとオペレーションを抽出する
ルーティング/購読/発行ファイルの特定
チャンネル定義の検索
主要なメッセージハンドラ/プロデューサの読み込み
目的: メッセージペイロード/ヘッダーのスキーマを推定する
型定義・モデルファイルの検索
バリデーション定義の検索
主要なモデルファイルの読み込み
目的: 収集した情報を基にAsyncAPI 3.0.0形式のYAMLを生成する
asyncapi: 3.0.0
info:
title: <プロジェクト名>
version: <バージョン>
description: <プロジェクト説明>
contact:
name: <連絡先名>
email: <メールアドレス>
defaultContentType: application/json
servers:
production:
host: <host>
protocol: <protocol>
description: 本番環境
channels:
# ここにチャンネルを追加
operations:
# ここに送受信オペレーションを追加
components:
schemas:
# ここにスキーマ定義を追加
messages:
# ここにメッセージ定義を追加
securitySchemes:
# ここにセキュリティスキームを追加
channels:
user/signedup:
description: ユーザー登録イベント
messages:
userSignedUp:
$ref: '#/components/messages/UserSignedUp'
operations:
receiveUserSignedUp:
action: receive
channel:
$ref: '#/channels/user/signedup'
messages:
- $ref: '#/components/messages/UserSignedUp'
components:
messages:
UserSignedUp:
name: UserSignedUp
title: User Signed Up
payload:
$ref: '#/components/schemas/User'
schemas:
User:
type: object
required:
- id
- email
properties:
id:
type: string
email:
type: string
format: email
servers, channels, operations, messages に追加Write: <出力ファイル名>
type: object とするsecurity と securitySchemes を設定- で表記publish(, subscribe(, send(, emit(, on( 等を検索