Communitygithub.com

curiositech/windags-skills

アクターが非同期メッセージパッシングのみを介して通信する、基礎的な並行計算モデル

windags-skills とは?

このスキルは、Aghaアクターモデルに基づく並行エージェントシステム設計のための包括的なガイドです。アクターモデルは、各アクターが自身の状態をカプセル化し、メッセージパッシングのみで通信する並行計算の枠組みであり、特にAIエージェントや複雑なワークフローシステムにおいて、スケーラビリティ、耐障害性、そして正しい合成動作を実現するために不可欠です。本スキルでは、タスクの種類に応じたアクター作成戦略(顧客パターン、非感性アクター、リソースマネージャー)、メッセージ送信と状態置き換えの選択基準、5つの主要な障害モード(中央オーケストレーターアンチパターン、同期ブロッキングの誤謬、共有状態汚染、出力のみの検証、静的トポロジー仮定)とその修正方法を詳述しています。また、顧客パターンを用いたタスク分解と監視付き障害回復の2つの具体的な例を通じて、初心者のアプローチとエキスパートの実装の違いを示します。このスキルは、Claude Code、Cursor、Codexなど、任意のAIエージェントプラットフォームで活用でき、システムの正しさと合成可能性を重視する開発者にとって強力な設計指針を提供します。

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

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

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

ドキュメント

SKILL.md — Agha Actor Model: 並行エージェントシステム設計

決定ポイント

タスクタイプに基づくアクター作成戦略の選択

タスクに逐次依存関係がある場合:
├─ 顧客パターンを使用: 応答アドレス付きで子アクターを作成
├─ 子アクターに顧客アドレスをパラメータとして渡す
└─ 子アクターは結果を(親ではなく)顧客に直接送信

タスクに長時間計算が必要な場合:
├─ 計算用の非感受性アクターを作成
├─ 受信メッセージをバッファアクターに転送
└─ 計算完了時にバッファから再開

タスクに動的リソース割り当てが必要な場合:
├─ オンデマンドでリソースマネージャーアクターを作成
├─ 機能(アドレス)をメッセージデータとして渡す
└─ 中央レジストリなし - アドレスはシステム内を流れる

タスクに障害分離要件がある場合:
├─ リスクの高い操作には監視付き子アクターを生成
├─ 監視者は応答の欠如によって障害を検出
└─ 他のアクターに影響を与えずに障害アクターを交換

既存のエージェントシステムを構成する場合:
├─ インターフェースが因果構造を維持しているか検証
├─ (単独動作だけでなく)合成下での動作をテスト
└─ メッセージプロトコルを(共有状態ではなく)境界として使用

メッセージ送信 vs 状態置き換えの決定木

他のエージェントとの調整が必要な場合:
├─ メッセージを**送信**(先にローカル状態を変更しない)
├─ 応答が必要な場合は応答アドレスを含める
└─ メッセージの順序を決して仮定しない

ローカル計算が必要な場合:
├─ 置き換え動作を**指定**
├─ 新しい状態をカプセル化(内部を公開しない)
└─ 一度に一つのメッセージ処理を保証

動的スケーリングが必要な場合:
├─ 特定の動作を持つ新しいアクターを**作成**
├─ 必要なアドレスを新しいアクターに渡す
└─ 共有初期化状態なし

障害モード

1. 中央オーケストレーターアンチパターン

検出方法: 一つのアクターがすべてのメッセージをルーティングしたり、すべてのシステム状態を保持している場合 症状: 単一障害点、負荷時のボトルネック、無限再帰問題 修正方法: それぞれがローカルコンテキストのみを知るアクターコミュニティに分解し、機能ルーティングを使用

2. 同期ブロッキングの誤謬

検出方法: アクターが置き換え動作を指定する代わりに、応答を待機/ブロックする場合 症状: 負荷時のデッドロック、隠れたタイミング仮定、並行性の低下 修正方法: リクエスト-リプライメッセージペアとしてモデル化し、依存関係には顧客パターンを使用し、非感受性アクターパターンを適用

3. 共有状態汚染

検出方法: 複数のアクターが同じデータ構造を読み書きする場合(ロックを使用していても) 症状: 競合状態、逐次ボトルネック、隠れたグローバル状態 修正方法: 単一アクターに状態をカプセル化し、調整にはメッセージパッシングを使用、相互排除は無料

4. 出力のみの検証

検出方法: テストが相互作用パターンをチェックせずに最終出力のみを比較する場合 症状: Brock-Ackerman異常 - 同じ出力でも異なる合成動作 修正方法: 因果構造の保存を検証し、合成下での動作をテストし、観測等価性を使用

5. 静的トポロジーの仮定

検出方法: 通信グラフが起動時に固定され、実行時の再構成がない場合 症状: オープンシステムを処理できず、動的リソース管理がなく、変更に対して脆弱 修正方法: アドレスを第一級データとして扱い、機能ルーティングを実装し、実行時のトポロジー変更をサポート

実践例

例1: 顧客パターンによるタスク分解

シナリオ: エージェントが逐次サブタスク A → B → C を必要とする複雑なリクエストを処理するが、他のメッセージに対して応答性を維持する必要がある。

初心者のアプローチ:

リクエストを受信 →
  サブタスクAを呼び出してブロック
  サブタスクBを呼び出してブロック
  サブタスクCを呼び出してブロック
  最終結果を送信

アクターモデルのエキスパート適用:

リクエストを受信 →
  アドレスB、C、最終受信者を持つ顧客_BCアクターを作成
  サブタスクAリクエストをA_プロセッサに送信し、顧客_BCを応答アドレスとして指定
  置き換え動作を指定: 次のリクエストの準備完了

顧客_BCがAの結果を受信 →
  結果をB_プロセッサに送信し、顧客_Cを応答アドレスとして指定

顧客_CがBの結果を受信 →
  結果をC_プロセッサに送信し、最終_受信者を応答アドレスとして指定

行われた主要な決定:

  • ブロックを避けるために顧客パターンを使用
  • 各ステップがチェーン内の次の顧客を作成
  • 元のエージェントは全体を通して応答性を維持
  • サブタスクの障害はそのチェーンのみに影響

例2: 監視による障害回復

シナリオ: システムがエージェント障害をシステム全体にカスケードさせずに処理する必要がある。

初心者のアプローチ: エージェント呼び出しをtry-catchで囲み、障害時にすべてを再起動。

エキスパートの適用:

監視者がワーカー_アクターを作成 →
  応答タイムアウト付きでワーカーにタスクを送信
  置き換えを指定: "応答待ち"

タイムアウト内に応答を受信した場合 →
  結果をクライアントに転送
  置き換えを指定: "準備完了"

タイムアウトが切れた場合 →
  新しいワーカー_アクターを作成(古いものは障害)
  新しいワーカーにタスクを再送信
  置き換えを指定: "応答待ち"

対処されたトレードオフ:

  • 監視はビジネスロジックとは別の関心事
  • 障害アクターは修復ではなく、分離され交換される
  • タイムアウト検出と保証付き配信のバランス
  • 監視者とワーカーの間に共有状態なし

品質ゲート

  • いかなるアクターもそのメッセージ処理ループをブロックしない(必要に応じて非感受性アクターパターンを適用)
  • すべての調整にメッセージパッシングを使用(アクター間の可変共有状態なし)
  • メッセージ配信は保証されるが、順序は仮定しない
  • アドレスは機能ルーティングのために第一級データとして扱われる
  • 各アクターはすべてのメッセージタイプに対して置き換え動作を指定する
  • アクター作成は計算ニーズに基づいて動的に行われる
  • 障害分離はアクター境界を越えたカスケード障害を防ぐ
  • システムトポロジーは中央レジストリなしで実行時に再構成可能
  • 合成動作は検証されており、単独コンポーネントの動作だけではない
  • 同期操作はリクエスト-リプライメッセージペアとしてモデル化される

NOT-FOR 境界

このスキルは以下の用途には使用すべきではない:

  • 単純な逐次計算 → 代わりに関数型プログラミングを使用
  • 物理的に共有メモリが必要なシステム → 代わりにロックベースの並行パターンを使用
  • 厳しいタイミング制約のあるリアルタイムシステム → 正式なタイミング分析を伴う同期メッセージパッシングを使用
  • 調整を必要としない数学計算 → 純粋関数型アプローチを使用

以下の場合は他のスキルに委任する:

  • 特定のアクターフレームワークの実装 → プラットフォーム固有の実装ガイドを使用
  • アクターシステムのパフォーマンスチューニング → [パフォーマンス最適化]スキルを使用
  • アクタープロパティの形式的検証 → [形式手法]スキルを使用
  • アクター永続化のデータベース設計 → [データアーキテクチャ]スキルを使用

範囲に関する一般的な誤解:

  • アクターは単なる「非同期メソッドを持つオブジェクト」ではない - 完全な3タプル応答が必要
  • アクターモデルは分散システムのためだけではない - あらゆる並行計算に適用可能
  • 主にパフォーマンス最適化ではない - 正しさと合成可能性のためのフレームワークである

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

Build production-ready LLM applications, advanced RAG systems, and intelligent agents. Implements vector search, multimodal AI, agent orchestration, and enterprise AI integrations. Use PROACTIVELY for LLM features, chatbots, AI agents, or AI-powered applications.

curiositech/windags-skills

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

関連スキル