cs-concurrency

cs-concurrency

目的

このスキルは、スレッドと非同期プログラミングの違い、ロックやアトミックなどの同期プリミティブ、アクターモデル、STM、デッドロック回避などの高度なトピックを含む、コンピューターサイエンスの並行処理の概念について OpenClaw が支援できるようにします。コードの生成、落とし穴の説明、問題のデバッグに利用できます。

使用するタイミング

マルチスレッドアプリケーション（C++ や Python など）の開発時、競合状態を防ぐために共有リソースを扱うとき、I/O バウンドのタスクを async/await で最適化するとき、本番コードのデッドロックを分析するときに、このスキルを適用してください。並行処理が重要なリアルタイムシステム、Web サーバー、分散コンピューティングにも利用できます。

主な機能

• 違いを説明します：スレッド（ブロッキング、OS レベル）と非同期処理（ノンブロッキング、イベントループベース）。
• 同期処理を実演します：共有データに対するミューテックス、RW ロック、アトミックを実装します。
• 高度なパターンに対応します：アクターモデルのコード（Erlang スタイルのアクターを使用するものなど）や、トランザクショナルメモリ向けの STM を生成します。
• 問題を検出します：提示されたコードスニペットから、デッドロックや競合状態の可能性を特定します。
• 最適化します：並行キューなどのロックフリーデータ構造を提案します。

使用パターン

簡単な説明やコード生成には CLI 経由で OpenClaw を呼び出し、スクリプトに統合するには API を使用します。対象を絞った回答を得るため、サブトピック（「threads」や「locks」など）を必ず指定してください。対話型セッションでは、コマンドの先頭に「openclaw cs-concurrency」を付けます。プログラムから使用する場合は、topic や language などの必須パラメーターを含む JSON ペイロードを渡してください。

主なコマンド/API

次のような CLI コマンドを使用します：
openclaw cs-concurrency explain threads --lang python（Python の例を使ってスレッドを説明します）。
openclaw cs-concurrency generate lock --type mutex --code c++（C++ のミューテックスの例を生成します）。

API の場合は、次の JSON ボディを指定して /api/cs-concurrency/explain に POST リクエストを送信します：
{ "topic": "atomics", "lang": "rust", "detail": "high" }
ヘッダー：Authorization: Bearer $OPENCLAW_API_KEY（認証用の環境変数として設定します）。

カスタムセッションの設定形式：
--config path/to/file.json で渡す JSON ファイル（例：{ "defaultLang": "go", "focus": ["deadlock", "async"] }）。

統合に関する注意

認証が必要な API 呼び出しを行うには、環境変数に $OPENCLAW_API_KEY を設定して統合します。たとえば、bash スクリプトでは export OPENCLAW_API_KEY=your_api_key_here とします。出力をパイプで渡すことで、デバッガー（スレッド用の gdb など）と組み合わせられます：openclaw cs-concurrency explain deadlock | gdb -ex "run"。Node.js や Python のイベントループに応答を埋め込む場合は、アプリケーションが非同期コンテキストを適切に処理することを確認してください。

エラー処理

このスキルを使用するときは、コードを try-except ブロックで囲むなどして、デッドロックのような並行処理のエラーを確認してください。たとえば、Python では次のようにします：

import threading
lock = threading.Lock()
try:
    with lock:
        # Critical section
        pass
except threading.LockError:
    print("Lock acquisition failed")

API 呼び出しでは、レスポンスのステータスコードを確認して、HTTP エラー（無効な $OPENCLAW_API_KEY に対する 401 など）を処理します。OpenClaw コマンドのデバッグには --verbose フラグを使用します：openclaw cs-concurrency explain async --verbose を実行すると、詳細なエラーが記録されます。

具体的な使用例

例 1： C++ で簡単なスレッドの例を生成するには：
実行：openclaw cs-concurrency generate threads --lang c++
出力例：

#include <thread>
void task() { /* code */ }
int main() {
    std::thread t1(task);
    t1.join();
}

これは、基本的なスレッドの作成と結合の理解に役立ちます。

例 2： アトミックを使った競合状態を説明して修正するには：
コマンド：openclaw cs-concurrency explain race --fix --lang rust
応答：問題を説明し、次の内容を提示します：

use std::sync::atomic::{AtomicUsize, Ordering};
static COUNTER: AtomicUsize = AtomicUsize::new(0);
COUNTER.fetch_add(1, Ordering::SeqCst);

これを使用すると、ロックを使わずに共有カウンターを安全にインクリメントできます。

グラフ上の関係

• 関連：cs-algorithms（並列アルゴリズムに関する concurrency タグ経由）
• 接続：programming-languages（言語固有の実装に関する「threads」などのタグを共有）
• リンク：software-engineering（システム設計におけるデッドロック関連）
• 関連付け：cs（コンピューターサイエンスのトピックにおけるクラスターの重複）