菜单
Guard skill for the WebRTC repo. Keep useStreamReceiver.js as a thin orchestrator. Do not add feature logic, polling, timers, Maps, DOM search helpers, or monitoring state there. Put feature logic in sub composables or services instead.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
WebRTC のローカル音声ノイズ抑制を、安全な最小差分で導入・修正するための Skill。現行の実動作 mode は standard / suppressor とし、次の拡張候補は rnnoise とする。
変更差分の妥当性と検証の正確性を担保し、実行したことと未実行のことを混同せずに完了報告するための Skill。
UI の見た目、文言、表示有無、補助説明を、既存ロジックを壊さず最小差分で修正するための Skill。
DTLN ベースの音声抑制を扱う場合だけ、適用条件と制約を明確にして誤採用を防ぐための Skill。現行では既定提案にしない。
WebRTC の音声抑制トグル変更後に、実装実態と UI 表示、フォールバック、相互音声が一致しているかを確認するための Skill。
単独 AudioWorklet + WASM 配信構成を扱う場合だけ、適用条件と制約を明確にして誤採用を防ぐための Skill。現行では既定提案にしない。
| name | webrtc-orchestrator-guard |
| description | Guard skill for the WebRTC repo. Keep useStreamReceiver.js as a thin orchestrator. Do not add feature logic, polling, timers, Maps, DOM search helpers, or monitoring state there. Put feature logic in sub composables or services instead. |
この Skill は、useStreamReceiver.js を orchestrator として維持するためのガードである。
WebRTC の機能追加や不具合修正のたびに、
が useStreamReceiver.js に流れ込みやすい。
この Skill は、それを防ぎ、
useStreamReceiver.js を「配線と順序制御」に限定することを目的とする。
次のような依頼で使う。
useStreamReceiver.js に新しい処理を足したくなった特に、次のような変更では必ず意識する。
setInterval / setTimeoutgetAudioLevel() のような定期 pollingMap / Set を使う feature stateuseStreamReceiver.js は orchestrator のまま維持するuseStreamReceiver.js の責務は次に限定する。
useStreamReceiver.js に置かない次は useStreamReceiver.js に置いてはいけない。
Map / Set / 状態テーブルによる監視管理新しい機能や復元処理の本体は、次のどれかへ置く。
判断基準は「その責務がどこに最も近いか」で決める。
useStreamReceiver.js に追加してよいのは原則として次だけである。
useStreamReceiver.js に置いてよいものuseXxxSession() の呼び出しuseXxxSession() に渡す callbackuseStreamReceiver.js に置いてはいけないものstartXxxMonitor()stopXxxMonitor()findXxxElement()applyXxxEffect()computeXxxState()readXxxLevel()setInterval(() => ...)setTimeout(() => ...)new Map()new Set()新しい処理をどこへ置くか迷ったら、次の順で考える。
useStreamReceiver.js に最小 bridge を置くuseStreamReceiver.js に本体を書き始める前に、
「これは bridge か、feature 本体か」を明示的に判定する。
feature 本体なら、useStreamReceiver.js には置かない。
話者ハイライトを戻すために useStreamReceiver.js に以下を追加する。
SPEAKING_POLL_INTERVAL_MSSPEAKING_LEVEL_THRESHOLDspeakingMonitorsfindTileContainerByMemberIdapplySpeakingHighlightstartSpeakingMonitorstopSpeakingMonitorこれは orchestrator への責務逆流である。
remote attach のたびに、useStreamReceiver.js で feature 専用 wrapper を増やし続ける。
attachRemoteWithSpeaking()attachRemoteWithBadge()attachRemoteWithSomethingElse()小さく見えても、feature ごとの橋渡し wrapper が増殖すると orchestrator が太る。
「今回は最小修正だから」という理由で、sub composable を作らずに監視本体を直書きする。
最小差分と責務逸脱は別問題である。 最小差分でも、置き場所は正しくなければならない。
話者ハイライトの監視本体を useSpeakingHighlightSession.js に置く。
useStreamReceiver.js 側では、
だけを行う。
remote publication に密接な処理なら useRemotePublications.js に寄せる。
は remote 側責務として閉じられるならその方が自然である。
編集前に必ず次を整理する。
useStreamReceiver.js に必要なのは bridge だけかuseStreamReceiver.js の差分が小さいuseStreamReceiver.js に新規定数が増えるuseStreamReceiver.js に監視 helper が増えるuseStreamReceiver.js に DOM 探索処理が入るuseStreamReceiver.js に feature 専用 state が増える変更後は次を確認する。
useStreamReceiver.js に feature 本体が入っていないか必要なら次を先頭に付ける。
useStreamReceiver.js は orchestrator のまま維持することuseStreamReceiver.js に置かないことuseStreamReceiver.js には import / 初期化 / callback配線だけを許可する完了時は必ず簡潔に次を報告する。
useStreamReceiver.js に追加したのが配線だけかどうかuseStreamReceiver.js に「とりあえず書く」を許さない。
新機能の本体は、必ず下位へ置く。