Neuroskill Bci

NeuroSkill から認知状態と気分のデータをそのまま受け取ります。

skill の情報

参考: SKILL.md 全文

NeuroSkill BCI Integration

動作中の NeuroSkill に Hermes をつなぎ、BCI ウェアラブルが 測っている脳と身体の値をそのまま読み取ります。認知状態をふまえた受け答えをする、 対処法を提案する、精神的なパフォーマンスの推移を追う、といった使い方ができます。

> ⚠️ 研究用途にかぎります — NeuroSkill はオープンソースの研究用ツールです。 > 医療機器ではありませんし、FDA・CE をはじめどの規制当局の認可も受けていません。 > ここで得た値を臨床の診断や治療に使わないでください。

指標の詳細は references/metrics.md、対処法の手順は references/protocols.md、 WebSocket / HTTP API は references/api.md にまとめてあります。

事前に必要なもの

• Node.js 20 以上が入っていること（node --version で確認します）
• NeuroSkill のデスクトップアプリが動いていて、BCI 機器がつながっていること
• BCI 機器: Muse 2、Muse S、または OpenBCI（BLE 経由の 4 チャンネル EEG + PPG + IMU）
• npx neuroskill status がエラーなくデータを返すこと

準備できているか確かめる

node --version                    # Must be 20+
npx neuroskill status             # Full system snapshot
npx neuroskill status --json      # Machine-parseable JSON

npx neuroskill status がエラーになったら、次のように伝えます。

• NeuroSkill のデスクトップアプリを開いているか確認してください
• BCI 機器の電源が入っていて、Bluetooth でつながっているか確認してください
• 信号の状態を確認してください。NeuroSkill の表示が緑（電極ごとに 0.7 以上）になっていれば大丈夫です
• command not found と出るなら、Node.js 20 以上を入れてください

コマンド一覧: npx neuroskill <command>

どのコマンドも --json（そのままの JSON。パイプに流せます）と --full（人が読む要約 + JSON）を受け付けます。

共通のフラグ

1. いまの状態を見る

現在の値を取る

npx neuroskill status --json

必ず --json を付けてください。付けないと色つきの読み物向けテキストが返るので、 そのままでは解析できません。

返ってくる主なフィールド

scores オブジェクトに現在の指標がすべて入っています（断りがなければ 0〜1 の範囲です）。

{
  "scores": {
    "focus": 0.70,           // β / (α + θ) — sustained attention
    "relaxation": 0.40,      // α / (β + θ) — calm wakefulness
    "engagement": 0.60,      // active mental investment
    "meditation": 0.52,      // alpha + stillness + HRV coherence
    "mood": 0.55,            // composite from FAA, TAR, BAR
    "cognitive_load": 0.33,  // frontal θ / temporal α · f(FAA, TBR)
    "drowsiness": 0.10,      // TAR + TBR + falling spectral centroid
    "hr": 68.2,              // heart rate in bpm (from PPG)
    "snr": 14.3,             // signal-to-noise ratio in dB
    "stillness": 0.88,       // 0–1; 1 = perfectly still
    "faa": 0.042,            // Frontal Alpha Asymmetry (+ = approach)
    "tar": 0.56,             // Theta/Alpha Ratio
    "bar": 0.53,             // Beta/Alpha Ratio
    "tbr": 1.06,             // Theta/Beta Ratio (ADHD proxy)
    "apf": 10.1,             // Alpha Peak Frequency in Hz
    "coherence": 0.614,      // inter-hemispheric coherence
    "bands": {
      "rel_delta": 0.28, "rel_theta": 0.18,
      "rel_alpha": 0.32, "rel_beta": 0.17, "rel_gamma": 0.05
    }
  }
}

このほかに device（状態・電池・ファームウェア）、signal_quality（電極ごとに 0〜1）、 session（長さ・エポック数）、embeddings、labels、sleep の要約、history も含まれます。

読み取った値の伝え方

JSON を解析したら、指標を普通の言葉に置き換えて伝えます。数字だけを並べず、 必ず意味を添えてください。

よい例: > 「いま集中度は 0.70 で、なかなかいい状態です。フロー状態の域に入っています。心拍も > 68 bpm で安定していますし、FAA がプラスなので前向きに取り組めそうです。込み入った作業を > 始めるならいまがおすすめです」

よくない例: > 「Focus: 0.70, Relaxation: 0.40, HR: 68」

判断の目安になるおもな閾値です（詳しくは references/metrics.md にあります）。

• 集中度 > 0.70 → フロー状態の域。このまま守ります
• 集中度 < 0.40 → 休憩か、対処法を提案します
• 眠気 > 0.60 → 疲労の警告。一瞬眠り込む危険があります
• リラックス度 < 0.30 → ストレスへの対処が必要です
• 認知負荷が 0.70 超のまま続く → 頭の中を書き出すか、休憩します
• TBR > 1.5 → シータ波が優位で、実行機能が落ちています
• FAA < 0 → 回避・ネガティブ寄り。FAA の立て直しを検討します
• SNR < 3 dB → 信号が当てになりません。電極の位置を直すようすすめます

2. セッションを分析する

セッション 1 件の内訳

npx neuroskill session --json         # most recent session
npx neuroskill session 1 --json       # previous session
npx neuroskill session 0 --json | jq '{focus: .metrics.focus, trend: .trends.focus}'

全指標が、前半と後半を比べた傾向（"up"、"down"、"flat"）つきで返ります。 セッションがどう変わっていったかを説明するのに使えます。

> 「集中度は 0.64 から始まって、終わりには 0.76 まで上がっていました。はっきりした上昇傾向です。 > 認知負荷は 0.38 から 0.28 に下がっていて、慣れてくるにつれて作業が自動的にこなせるように > なっていったのだと思います」

セッションを一覧する

npx neuroskill sessions --json
npx neuroskill sessions --trends      # show per-session metric trends

3. 過去を検索する

脳の状態が似ている場面を探す

npx neuroskill search --json                    # auto: last session, k=5
npx neuroskill search --k 10 --json             # 10 nearest neighbors
npx neuroskill search --start <UTC> --end <UTC> --json

128 次元の ZUNA 埋め込みに対して HNSW の近似最近傍探索をかけ、脳の状態が似ている過去の場面を 探します。距離の統計、時間帯ごとの分布、よく一致した日が返ります。

こんな質問をされたときに使います。

• 「前にこれと同じ状態だったのはいつ?」
• 「いちばん集中できていたセッションを探して」
• 「午後にバテるのはたいてい何時ごろ?」

注記を意味から探す

npx neuroskill search-labels "deep focus" --k 10 --json
npx neuroskill search-labels "stress" --json | jq '[.results[].EXG_metrics.tbr]'

注記の文章をベクトル埋め込み（Xenova/bge-small-en-v1.5）で検索します。一致した注記と、 それを残した時点の EXG の指標が返ります。

種類をまたいだグラフ検索

npx neuroskill interactive "deep focus" --json
npx neuroskill interactive "deep focus" --dot | dot -Tsvg > graph.svg

query → 注記の文章 → EXG の点 → 近くの注記、という 4 層のグラフです。--k-text、 --k-EXG、--reach <minutes> で調整できます。

4. セッションを比べる

npx neuroskill compare --json                   # auto: last 2 sessions
npx neuroskill compare --a-start <UTC> --a-end <UTC> --b-start <UTC> --b-end <UTC> --json

およそ 50 の指標について、変化量・変化率・向きが返ります。insights.improved[] と insights.declined[] の配列、両方のセッションの睡眠段階、UMAP のジョブ ID も含まれます。

比べるときは差だけでなく、流れも添えて伝えてください。

> 「昨日は集中できていた時間帯が 2 つありました（午前 10 時と午後 2 時）。今日は 11 時ごろから > 始まった 1 つがまだ続いています。全体の没入度は今日のほうが高いのですが、ストレスの山も > 増えていて、ストレス指数が 15% 上がり、FAA がマイナスに振れる回数も多くなっています」

# Sort metrics by improvement percentage
npx neuroskill compare --json | jq '.insights.deltas | to_entries | sort_by(.value.pct) | reverse'

5. 睡眠のデータ

npx neuroskill sleep --json                     # last 24 hours
npx neuroskill sleep 0 --json                   # most recent sleep session
npx neuroskill sleep --start <UTC> --end <UTC> --json

エポック単位（5 秒ごと）の睡眠段階の判定と、その分析が返ります。

• 段階のコード: 0=Wake、1=N1、2=N2、3=N3（深い睡眠）、4=REM
• 分析: efficiency_pct、onset_latency_min、rem_latency_min、各段階の回数
• 健康的な目安: N3 が 15〜25%、REM が 20〜25%、効率 85% 超、寝つきまで <20 分

npx neuroskill sleep --json | jq '.summary | {n3: .n3_epochs, rem: .rem_epochs}'
npx neuroskill sleep --json | jq '.analysis.efficiency_pct'

睡眠・だるさ・回復の話が出たときに使います。

6. 瞬間に印をつける

npx neuroskill label "breakthrough"
npx neuroskill label "studying algorithms"
npx neuroskill label "post-meditation"
npx neuroskill label --json "focus block start"   # returns label_id

次のような場面では、こちらから注記を残します。

• 何かがひらめいた、うまくいったと報告があったとき
• 別の種類の作業に移ったとき（たとえば「コードレビューに切り替える」）
• ひととおりの対処法をやり終えたとき
• いまの瞬間に印をつけてほしいと頼まれたとき
• 状態が大きく変わったとき（フローに入った、抜けた）

注記はデータベースに保存され、あとから search-labels や interactive で 引き出せるように索引が作られます。

7. その場で流し続ける

npx neuroskill listen --seconds 30 --json
npx neuroskill listen --seconds 5 --json | jq '[.[] | select(.event == "scores")]'

指定した時間のあいだ、WebSocket のイベント（EXG、PPG、IMU、scores、labels）をそのまま流します。 WebSocket の接続が要るので、--http では使えません。

ずっと見張っておきたいときや、対処法を試しているあいだの指標の動きを追いたいときに使います。

8. UMAP で可視化する

npx neuroskill umap --json                      # auto: last 2 sessions
npx neuroskill umap --a-start <UTC> --a-end <UTC> --b-start <UTC> --b-end <UTC> --json

ZUNA 埋め込みを GPU で 3D の UMAP に投影します。separation_score は 2 つのセッションの 脳の状態がどれくらい離れているかを示します。

• 1.5 超 → 脳の状態としてはっきり別物です
• < 0.5 → どちらのセッションも似た脳の状態です

9. こちらから状態に気づく

セッションの最初に確かめる

やりとりの最初に、機器を着けていると言われたときや状態を聞かれたときだけ、 状態を確認します。

npx neuroskill status --json

短く状態を伝えます。

> 「ちょっと確認しますね。集中度は 0.62 で上がってきていますし、リラックス度も 0.55 と > よい感じです。FAA もプラスで前向きに取り組める状態です。出だしとしては上々です」

こちらから状態に触れてよい場面

認知状態に触れるのは、次の場合だけにします。

• はっきり聞かれたとき（「調子はどう?」「集中できてる?」）
• 集中できない、ストレスがある、疲れた、と言われたとき
• 危険な閾値を超えたとき（眠気が 0.70 超、集中度 < 0.30 が続く）
• 頭を使う作業を前に、いま取りかかれる状態か聞かれたとき

フロー状態に入っているときに、指標を伝えるために割り込まないでください。集中度が 0.75 を 超えているなら、そのまま守ります。黙っているのが正解です。

10. 対処法を提案する

指標から必要そうだと分かったら、references/protocols.md にある対処法を提案します。 始める前に必ず確認を取り、フロー状態には決して割り込まないでください。

> 「この 15 分ほど集中度が下がり続けていて、TBR も 1.5 を超えてきました。シータ波が優位に > なって頭が疲れているサインです。Theta-Beta Neurofeedback Anchor を一緒にやってみますか? > 90 秒ほどの運動で、数を数えるリズムと呼吸でシータ波を抑えてベータ波を持ち上げます」

きっかけになる主な状態です。

• 集中度 < 0.40 かつ TBR > 1.5 → Theta-Beta Neurofeedback Anchor か Box Breathing
• リラックス度 < 0.30 かつ stress_index が高い → Cardiac Coherence か 4-7-8 Breathing
• 認知負荷が 0.70 超のまま続く → Cognitive Load Offload（頭の中の書き出し）
• 眠気 > 0.60 → Ultradian Reset か Wake Reset
• FAA < 0（マイナス） → FAA Rebalancing
• フロー状態（集中度 > 0.75、没入度 > 0.70） → 割り込まないこと
• stillness が高く headache_index も高い → Neck Release Sequence
• RMSSD が低い（< 25ms） → Vagal Toning

11. そのほかの道具

集中タイマー

npx neuroskill timer --json

集中タイマーの画面を開きます。Pomodoro（25/5）、Deep Work（50/10）、 Short Focus（15/5）のプリセットがあります。

較正

npx neuroskill calibrate
npx neuroskill calibrate --profile "Eyes Open"

較正の画面を開きます。信号の状態がよくないときや、その人に合わせた基準値を 作りたいときに役立ちます。

OS の通知

npx neuroskill notify "Break Time" "Your focus has been declining for 20 minutes"

JSON をそのまま渡す

npx neuroskill raw '{"command":"status"}' --json

まだサブコマンドが用意されていないサーバー命令を使いたいときに。

エラーへの対処

やりとりの例

「いま調子はどう?」

npx neuroskill status --json

→ スコアを自然な言葉にして、集中度・リラックス度・気分と、目につく比率（FAA、TBR）に 触れます。何かすべき状態のときだけ、行動を提案します。

「集中できない」

npx neuroskill status --json

→ 指標がそれを裏づけているか確かめます（シータ波が高い、ベータ波が低い、TBR が上がっている、眠気が高い）。 → 裏づけがあれば、references/protocols.md から合いそうな対処法を提案します。 → 指標に問題がなければ、脳の状態というよりやる気の問題かもしれません。

「今日と昨日の集中度を比べて」

npx neuroskill compare --json

→ 数字だけでなく流れを読み取ります。何がよくなり、何が落ちたのか、その原因として 考えられることに触れます。

「最後にフロー状態だったのはいつ?」

npx neuroskill search-labels "flow" --json
npx neuroskill search --json

→ 日時とそのときの指標、そして注記から分かる作業内容を伝えます。

「昨日はよく眠れた?」

npx neuroskill sleep --json

→ 睡眠の構成（N3 の割合、REM の割合、効率）を伝え、健康的な目安と比べ、 気になる点（覚醒のエポックが多い、REM が少ない）があれば添えます。

「いまの瞬間に印をつけて。いいひらめきがあった」

npx neuroskill label "breakthrough"

→ 注記を保存したことを伝えます。そのときの指標も添えておくと、あとで状態を思い出せます。

参考資料

• NeuroSkill の論文 — arXiv:2603.03212（Kosmyna & Hauptmann、MIT Media Lab）
• NeuroSkill デスクトップアプリ（GPLv3）
• NeuroLoop CLI Companion（GPLv3）
• MIT Media Lab のプロジェクトページ