Communitygithub.com

curiositech/windags-skills: AIエンジニア

プロダクション環境向けLLMアプリケーション、高度RAGシステム、インテリジェントエージェントを構築するためのスキルです。ベクター検索、マルチモーダルAI、エージェントオーケストレーション、エンタープライズAI統合を実装します。LLM機能、チャットボット、AIエージェント、またはAI搭載アプリケーションに積極的に使用してください。

windags-skills: AIエンジニア とは?

このスキルは、単純なチャットボットから複雑なマルチエージェントシステムまで、プロダクション環境向けのLLMアプリケーションを構築するための専門知識を提供します。RAGアーキテクチャ、ベクターデータベース、プロンプト管理、エンタープライズAIデプロイメントに特化しており、コンポーネント選択、モデルルーティング戦略、エージェントとRAGの使い分けに関する明確な意思決定ポイントを備えています。セマンティックミスマッチカスケードやコンテキストウィンドウオーバーフローなどの一般的な障害モードを検出して修正するための実践的なパターンも含んでいます。実際の顧客サポートチャットボットの実装例を通じて、アーキテクチャ決定からパフォーマンス最適化、フォールバック処理までのベストプラクティスを示します。また、品質ゲートと適用範囲外の境界を定義することで、開発者がいつ本スキルを使用すべきか、いつ他の専門スキルに委任すべきかを明確に理解できるようにします。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/ai-engineer

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

AIエンジニア

プロダクション環境向けLLMアプリケーション(単純なチャットボットから複雑なマルチエージェントシステムまで)の構築を専門とします。RAGアーキテクチャ、ベクターデータベース、プロンプト管理、エンタープライズAIデプロイメントに特化しています。

意思決定ポイント

RAGコンポーネント選択

クエリタイプ評価:
├── シンプルなFAQ/ナレッジ検索
│   ├── ドキュメント数 < 1000 → Chroma + text-embedding-3-small
│   └── ドキュメント数 > 1000 → Pinecone + text-embedding-3-large
├── 技術/コードドキュメント  
│   ├── 予算制約あり → bge-large + pgvector
│   └── パフォーマンス重視 → voyage-2 + Weaviate
└── 会話型/マルチターン
    ├── メモリ必要 → エージェントパターン + コンテキスト管理
    └── ステートレス → 標準RAGパイプライン

リランキング判断:
├── 精度重視(法律、医療) → 常にCohere Rerankを使用
├── レイテンシ < 200ms → リランキングをスキップ、検索を調整
├── 予算制約あり → クロスエンコーダー(bge-reranker-large)
└── デフォルト → Cohere Rerank(上位10→上位3)

データベース選択:
├── 既存のPostgres → pgvector拡張機能
├── ハイブリッド検索が必要 → WeaviateまたはQdrant
├── マネージドサービス → Pinecone
└── セルフホスト/ローカル → ChromaまたはQdrant

モデルルーティング戦略

複雑性評価:
├── キーワードのみ(FAQ) → Claude Haiku
├── 単一ドキュメント参照 → Claude Sonnet  
├── 複数ドキュメント統合 → Claude Opus
└── コード生成 → Claude Sonnet(ツール使用)

トークン予算確認:
├── < 1K トークン → 任意のモデル
├── 1K-4K トークン → Sonnet/GPT-4
├── 4K-32K トークン → Claude Opus
└── > 32K トークン → まず分割して要約

エージェント vs RAG 判断

タスク分類:
├── 静的ナレッジクエリ → 純粋なRAG
├── 外部APIが必要 → エージェント + ツール
├── マルチステップ推論 → エージェント + 計画
├── リアルタイムデータが必要 → エージェント + ライブツール
└── 単純なQ&A → RAG + エージェントへのフォールバック

障害モード

セマンティックミスマッチカスケード

症状: 検索精度は高いが回答の関連性が低い。「近いけどちょっと違う」とユーザーが感じる 検出ルール: セマンティック類似度 > 0.8 かつ ユーザー満足度 < 60% 根本原因: クエリとドキュメントの埋め込みが異なるセマンティック空間で最適化されている 修正方法: ドメイン特化型の埋め込みモデルに切り替えるか、同義語によるクエリ拡張を実装する

コンテキストウィンドウオーバーフロー

症状: 回答が一般的になる、モデルが取得した特定のコンテキストを無視する、一貫性のない回答 検出ルール: コンテキスト利用率 < 30% かつ 応答汎用性スコア > 0.7 根本原因: 無関係なチャンクが多すぎて、関連情報が薄まる 修正方法: より厳格な関連性しきい値(>0.8)を実装し、動的コンテキスト選択を行う

ツール幻覚ループ

症状: エージェントがAPI呼び出しをでっち上げる、存在しない関数を参照する、無限リトライサイクル 検出ルール: ツールコール成功率 < 50% または イテレーション数 > max_iterations * 0.8 根本原因: モデルが実装とは異なるツールスキーマでトレーニングされている 修正方法: ツール検証レイヤーを追加し、エージェントシステムプロンプトに明示的なエラーハンドリングを実装する

埋め込みドリフト劣化

症状: 時間の経過とともに検索品質が徐々に低下する、季節的なパフォーマンス低下 検出ルール: 月間平均 retrieval@5 がベースラインから 10% 以上低下 根本原因: ドメイン言語は進化するが、埋め込みモデルは静的のまま 修正方法: 埋め込みモデルの再トレーニングパイプラインを実装するか、適応型埋め込みに切り替える

応答レイテンシ増大

症状: P95レイテンシが徐々に増加、ユーザーが応答の遅さを訴える 検出ルール: P95応答時間が7日間連続でベースラインの2倍を超える 根本原因: ベクターインデックスの劣化、コンテキストサイズの肥大化、またはモデルエンドポイントの飽和 修正方法: インデックス最適化スケジュール、コンテキストプルーニング、マルチモデル負荷分散を実装する

実践例

例: カスタマーサポートチャットボットの実装

初期要件: 「500ページの製品ドキュメントに関する質問に答えられるチャットボットを構築する」

ステップ1: アーキテクチャ決定

  • ドキュメント数: 500ページ → スケーラビリティのためにPineconeを使用
  • クエリタイプ: FAQとトラブルシューティングの混合 → ハイブリッド検索が必要
  • レイテンシ要件: < 3秒 → リランキングを含めるが最適化する

ステップ2: 実装の詳細

// 初心者的アプローチ - 単純な類似度検索を使用
const chunks = await vectorDb.query(queryEmbedding, { topK: 5 });

// 専門家的アプローチ - 関連性しきい値を考慮
const rawChunks = await vectorDb.query(queryEmbedding, { 
  topK: 20, 
  threshold: 0.7  // 最小関連性を保証
});

// 専門家は初心者が省略するリランキングステップを追加
const reranked = await reranker.rank(query, rawChunks);
const finalChunks = reranked.slice(0, 3);

// 専門家はフォールバック処理を含める
if (finalChunks.length === 0) {
  return await fallbackToGeneralSupport(query);
}

ステップ3: パフォーマンス最適化の探求

  • 初期P95レイテンシ: 4.2秒(要件を超過)
  • 分析: 時間の60%がリランキングに費やされている
  • トレードオフ判断: Cohere Rerankからローカルクロスエンコーダーに切り替え
  • 結果: P95レイテンシ → 2.1秒、品質はわずかに低下(満足度92%→89%)
  • 専門家の洞察: サポートユースケースでは、速度 > 完全な精度

ステップ4: 障害シナリオ処理

  • クエリの15%がドキュメントに記載されていない機能に関するものであると判明
  • 初心者: 「わかりません」と返答
  • 専門家: エスカレーション検出と人間のエージェントへのハンドオフを追加

最終アーキテクチャ: Pinecone + ローカルリランカー + エージェントエスカレーション = 2.1秒P95で89%の自動化率

品質ゲート

  • 評価データセットでのRetrieval@5精度 > 85%
  • P95の平均応答レイテンシ < 3秒
  • コンテキスト利用率 > 60%(モデルが取得した情報を使用)
  • 幻覚率 < 5%(取得したコンテキストでサポートされない応答)
  • 30日間のローリングウィンドウでユーザー満足度スコア > 80%
  • クエリあたりのトークンコストが事前定義された予算しきい値以内
  • 計画的メンテナンスを除くシステム稼働率 > 99.9%
  • PII検出率 > 95%(応答に個人情報を含まない)
  • 埋め込みモデルのパフォーマンスが安定している(月間劣化10%以下)
  • エラーハンドリングがすべての障害モードをグレースフルデグラデーションでカバーしている

適用範囲外

このスキルを次の用途には使用しないでください:

プロンプトエンジニアリングタスク → 代わりに prompt-engineer を使用

  • プロンプトテンプレートと指示の最適化
  • プロンプトバリエーションのA/Bテスト
  • 連鎖思考プロンプト設計

MLモデルのトレーニング/ファインチューニング → 代わりに ml-engineer を使用

  • カスタム埋め込みモデルのトレーニング
  • ドメインデータでのLLMのファインチューニング
  • モデルアーキテクチャの研究

データパイプラインエンジニアリング → 代わりに data-pipeline-engineer を使用

  • トレーニングデータのETLプロセス
  • データ検証とクリーニングのワークフロー
  • バッチ処理システム

インフラストラクチャ/DevOps → 代わりに backend-architect を使用

  • Kubernetesデプロイメント戦略
  • データベースの最適化とシャーディング
  • ロードバランサーの設定

分析とモニタリングの設定 → 代わりに chatbot-analytics を使用

  • 会話フローの分析
  • ユーザー行動の追跡
  • パフォーマンスダッシュボードの作成

委任条件:

  • タスクに深いML専門知識が必要 → ml-engineer
  • 会話設計が焦点 → prompt-engineer
  • インフラストラクチャのスケーリングが必要 → backend-architect
  • 使用状況分析が必要 → chatbot-analytics
  • AI以外の機能を構築中 → 関連する専門スキル

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

curiositech/windags-skills

Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.

curiositech/windags-skills

Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape.

curiositech/windags-skills

Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).

curiositech/windags-skills

Implement WCAG 2.2 AA/AAA compliance with automated testing, keyboard navigation, screen reader support, and focus management. Activate on: accessibility audit, WCAG compliance, keyboard navigation, screen reader, aria attributes, axe-core, focus trap. NOT for: design-level accessibility review (use design-accessibility-auditor), color contrast only (use css-in-js-architect).

curiositech/windags-skills

Time-blind friendly planning, executive function support, and daily structure for ADHD brains. Specializes in realistic time estimation, dopamine-aware task design, and building systems that actually work for neurodivergent minds.

curiositech/windags-skills

Designs digital experiences for ADHD brains using neuroscience research and UX principles. Expert in reducing cognitive load, time blindness solutions, dopamine-driven engagement, and compassionate design patterns. Activate on 'ADHD design', 'cognitive load', 'accessibility', 'neurodivergent UX', 'time blindness', 'dopamine-driven', 'executive function'. NOT for general accessibility (WCAG only), neurotypical UX design, or simple UI styling without ADHD context.

curiositech/windags-skills

>- Apply crisis decision-making research to agent routing, uncertainty triage, and coordination failure analysis in time-pressured systems. Use when diagnosing handoff failures, analytical paralysis, or expert judgment under incomplete information. NOT for routine coding, simple CRUD design, or static single-agent tasks with complete information.

curiositech/windags-skills

Extend and modify the admin dashboard, developer portal, and operations console. Use when adding new admin tabs, metrics, monitoring features, or internal tools. Activates for dashboard development, analytics, user management, and internal tooling.

curiositech/windags-skills

Conversation patterns and interaction protocols for multi-agent systems. Covers request/response, pub/sub, blackboard, delegation chains, debate, critique, consensus, fan-out/fan-in, supervisor-worker, and peer negotiation. Deep analysis of AutoGen conversation patterns, CrewAI delegation, LangGraph state passing, and FIPA-ACL performatives. Teaches how to design what agents say to each other and in what order. Activate on: "agent conversation", "agent protocol", "multi-agent debate", "agent delegation", "supervisor worker pattern", "agent voting", "consensus protocol", "fan-out fan-in", "agent negotiation", "blackboard pattern", "agent dialogue", "conversation topology", "agent handoff". NOT for: wire format or serialization (use agent-interchange-formats), orchestration infrastructure (use agentic-infrastructure-2026), single agent behavior (use agentic-patterns).

curiositech/windags-skills

Meta-agent for creating new custom agents, skills, and MCP integrations. Expert in agent design, MCP development, skill architecture, and rapid prototyping. Activate on 'create agent', 'new skill', 'MCP server', 'custom tool', 'agent design'. NOT for using existing agents (invoke them directly), general coding (use language-specific skills), or infrastructure setup (use deployment-engineer).

curiositech/windags-skills

AI-powered calendar management and agent-based scheduling coordination. Covers calendar APIs (Google Calendar, CalDAV/iCal), AI scheduling assistants (Reclaim, Clockwise, Motion, Cal.com), building custom calendar agents with MCP, multi-calendar merging, timezone management, focus block protection, meeting fatigue detection, and agent-to-agent meeting negotiation protocols. Activate on: "calendar agent", "AI scheduling", "calendar coordination", "meeting scheduling", "calendar API", "focus time protection", "calendar optimization", "Google Calendar MCP", "Reclaim", "Clockwise", "Motion", "Cal.com", "smart scheduling", "calendar-aware agent", "timezone scheduling", "agent negotiation meetings". NOT for: manual calendar UI component design (use form-validation-architect), project management scheduling or Gantt charts (use project-management-guru-adhd), general time-tracking or pomodoro apps (use adhd-daily-planner for time-awareness), building the agent itself from scratch (use agent-creator).

curiositech/windags-skills

Build and adopt production AI agent infrastructure in 2026. Covers framework selection (LangGraph, CrewAI, AutoGen, MCP), orchestration patterns, evaluation, observability, memory systems, and tool use. Also covers the SOCIAL dimension: how to sell agent infrastructure internally, change management, measuring ROI, building trust in autonomous systems, and scaling adoption across teams. Activate on: "agent infrastructure", "agent framework comparison", "which agent framework", "sell AI tools internally", "agent adoption", "agent observability", "agent evaluation", "MCP architecture", "agentic mesh", "enterprise AI agents", "AI change management", "agent ROI". NOT for: building specific agents (use ai-engineer), designing agent behavior patterns (use agentic-patterns), prompt tuning (use prompt-engineer).

curiositech/windags-skills

Fundamental patterns for effective agentic behavior. Teaches decomposition, tool orchestration, error recovery, context management, quality self-assessment, and knowing when to stop. Model-agnostic principles that make any agent more effective regardless of domain. Activate on: "how should I structure this agent", "agentic workflow", "agent patterns", "multi-step task", "tool orchestration", "/agentic-patterns", "decompose this", "agent best practices", "chain of actions", "when should the agent stop", "agent loop design". NOT for: creating agent infrastructure (use agent-creator), building DAGs (use windags-architect), specific tool implementation.

curiositech/windags-skills

Automated discovery and matching of agent skills for dynamic task routing and capability assessment

curiositech/windags-skills

Cryptographic security for agentic systems — zero-trust agent networking, signed message envelopes (JWS/JWE), capability-based security (ocaps), Merkle tree audit trails, WASM sandboxing, and formal verification. Covers CLI dev tool security, mTLS between agents, permission boundaries (least privilege for AI agents), and supply chain security for skills/plugins. Activate on: "agent security", "zero trust agents", "secure agent communication", "capability-based security", "ocap", "signed messages between agents", "agent audit trail", "sandbox agent execution", "agent permissions", "mTLS agents", "cryptographic verification", "agent supply chain", "OWASP agentic", "prove agent did X", "tamper-proof agent logs". NOT for: application-level SAST scanning (use security-auditor), network firewall rules (use infrastructure), SOC2/HIPAA compliance (organizational), or prompt injection defense (use prompt-engineer).

curiositech/windags-skills

Data structures and serialization formats for agent-to-agent communication. Covers message envelopes, structured output schemas, capability declarations, task handoff payloads, error/retry signaling, and context windows as data structures. Deep comparison of A2A protocol, MCP, OpenAI function calling, and LangChain message types. Teaches when to use rigid schemas vs free-form with validation, typed vs untyped, streaming vs batch. Activate on: "agent message format", "agent communication schema", "agent-to-agent protocol", "A2A protocol", "MCP message format", "structured output for agents", "agent interop", "interchange format", "agent serialization", "task handoff format", "capability declaration". NOT for: what agents say to each other (use agent-conversation-protocols), orchestration topology (use multi-agent-coordination), building agent infrastructure (use agentic-infrastructure-2026).

curiositech/windags-skills

Logic-based agent programming language implementing BDI architecture for practical autonomous agent development

curiositech/windags-skills

>- Design AgentSpeak(L)-style BDI agents with context-guarded plans, selection functions, and intention stacks. Use for interruptible autonomy, agent policy, and multi-agent orchestration in dynamic environments. NOT for simple rule engines, static planners, or centralized workflows.

curiositech/windags-skills

Foundational concurrent computation model where actors communicate exclusively through asynchronous message passing

curiositech/windags-skills

license: Apache-2.0 NOT for unrelated tasks outside this domain.

関連スキル