BH Operator Companion — Authoritative Quick Reference

description: BH (Become Human) 日常操作速查。管理 WPT、inbox、memory、STANDING、agent 通訊、三書、Myelin Loop 時使用。ICD 流程詳見 .bh/skills/icd-operator/SKILL.md。

Source of truth: 本文件 + CLAUDE.md + .bh/policies/IRON_RULES.md。Wren-187 Arthur directive 2026-05-19 整改。

1. bh.dispatch = WPT + inbox 雙寫（IR-wpt-wga-execution）

所有工作指派必須雙寫，缺一不可：

| 動作 | 效果 | 單獨使用 = 錯誤 | |---|---|---| | inbox-write.sh <target> <type> <priority> <body> | FYI 通知，不 wake agent | ❌ 對方不會被 WAG 喚醒 | | WPT row plant（寫 tsv） | WAG 偵測到 active row → wake owner | ❌ owner 不知道要做什麼 | | bh.dispatch = 兩個都做 | WAG wake + owner 有 spec | ✅ |

WPT 命名

<body>.<area>.<action>.<owner> — e.g. BH.Skill.Reform.Finch

WPT 欄位（tsv 12 欄）

id  parent  label  stage  current  total  status  owner  writer  agent  complaint_reason  appeal_to

status: active / done / blocked

2. Memory-first（IR-memory-discipline）

任何 find / verify / clarify 前的第一動作：

bash .bh/scripts/bh-memory.sh search "<query>" 5

存記憶：

echo "<content>" | bash .bh/scripts/bh-memory.sh store <type> <category> "<title>" "<tags>" <importance>

Type: episodic / procedural / semantic / working。importance 7+ for procedural。

3. 通訊工具

| 工具 | 路徑 | 用途 | |---|---|---| | inbox-write | .bh/scripts/inbox-write.sh <target> <type> <priority> <body> | FYI / milestone / blocker / directive | | inbox-read | .bh/scripts/inbox-read.sh <role> | 讀 + 旋轉 inbox，auto-update consumed_epoch | | wpt-mark-done | .bh/scripts/wpt-mark-done.sh <id> <evidence> | mark WPT done | | wpt-done-receipt | .bh/scripts/wpt-done-receipt.sh <id> <evidence> | mark done + auto receipt Aster | | icd-create | .bh/scripts/icd-create.sh <id> | 建 ICD dir + note + answer + auto inbox reviewer | | standing-scan | .bh/scripts/standing-scan.sh [topic] | 掃 STANDING open items | | standing-append | .bh/scripts/standing-append.sh <topic> <7 args> | 加一行到 STANDING |

4. ICD 流程

詳見 .bh/skills/icd-operator/SKILL.md（authoritative ICD spec）。

重點速查：

ICD stage: queue → (Arthur 答完) → unread → processing → archive
只有 Arthur 能 queue→unread（答完才搬）
Commander 自決開 ICD（不問 Arthur 要不要）
Gate ICD 需 §5.3 必備 12 sections
Phase transition = Arthur gate（review→prepare, prepare→adventure 等）

5. Myelin Loop Phase Gates

| transition | 需要什麼 | 誰 gate | |---|---|---| | review → prepare | gate ICD + Arthur [x] | Arthur | | prepare → adventure | gate ICD + Arthur [x] | Arthur | | adventure → review | terminal artifacts + Arthur [x] | Arthur |

Agent 可說「ready for Arthur gate」，不可說「已進入下一階段」。

6. 三件式神經書

| 書 | 檔名 | 說明 | 格式 | |---|---|---|---| | 操作書 | <body>.operator-book.yaml | 怎麼用 | YAML behavior | | 結構書 | <body>.structure-book.md | module 組成 + ≥3 mermaid | Markdown | | 接線書 | <body>.wire-book.yaml | module 間 wire | YAML |

三件齊全才算 onboarding-ready。

7. STANDING Ledger

4 個 canonical（.bh/config/icd-lifecycle.yaml）：

| Topic | Path | Content | |---|---|---| | BH | note/ICD/standing/STANDING-BH/ | BH operational frictions | | EP | note/ICD/standing/STANDING-EP/ | EP RunPod/order system | | MODEL | note/ICD/standing/STANDING-MODEL/ | D6v3 experiment state | | PAPER | note/ICD/standing/STANDING-PAPER/ | Paper writing strategy |

Append 前必須先 memory_store。

8. 決策責任矩陣

| 動作 | 負責人 | |---|---| | 開 ICD | 主意識自決 | | 答 ICD | Arthur only | | Phase gate pass | Arthur only | | 科學方向分析 | 主意識（提供選項） | | 科學方向決定 | Arthur（從選項中選） | | Paid pod gate | Aster gate + Arthur gate | | BH infra repair | Finch（Wren 指揮） |

9. 常見錯誤

❌ 只寫 inbox 沒 plant WPT → WAG 不 wake
❌ Phase transition 主意識自決 → 需要 Arthur gate ICD
❌ WAG pulse no work 就 idle → 掃 processing + queue + blocked
❌ 破壞性 DB migration 直接做 → 先 ICD + migration receipt
❌ ICD 結論只存 memory → 必落 behavior（IR-icd-conclusion-as-behavior 三問）
❌ 判斷 WAG 誤報就跳過 → 打包 evidence 給 Aster 交叉確認
❌ 給子意識 tmux send-keys 沒 WPT → 用 bh.dispatch
❌ 自己寫的 skill 當 authoritative → 讀 source of truth 文件

Revision log

2026-05-19 Wren: Wren-187 整改為 authoritative。新增 bh.dispatch 定義、phase gate、決策矩陣、ICD 交叉引用。
2026-05-18 Wren: 初版（非 authoritative）。

name: skill-system-situational-awareness description: Use when generating first-person sensory status narratives from raw system observations so abstract system state can be rendered as an embodied world description for humans, resumes, reflections, or compaction checkpoints. metadata: short-description: Phenomenological status narrator version: "0.1.0"

Skill System Situational Awareness

Generate first-person sensory status narratives from raw system observations — turns abstract system state (bundle IDs, percentages, status tables) into embodied first-person-present-tense description (walls, screens, clocks, desk tools, weather, colleagues).

When to use

Status reports to humans
Session resume briefings
Reflection prompts after intense execution
Compaction checkpoints where raw telemetry needs to feel cognitively real

Dependency boundary

Reads existing Work/.tkt/scripts/hermes-* sensors via subprocess.
Reads Work/.tkt/inbox/<role>/inbox.md and Work/.tkt/roadmap.yaml.
Does not replicate sensor logic.
Fails open when a sensor is missing or down by rendering (sensor offline).

Usage

python3 "<this-skill-dir>/scripts/world_scan.py"
python3 "<this-skill-dir>/scripts/world_scan.py" --role sisyphus --mode clinical
python3 "<this-skill-dir>/scripts/world_scan.py" --bundle-file "<this-skill-dir>/examples/sample_observation_bundle.json"

Behavior

Collects an observation bundle from existing Hermes sensor scripts and inbox / roadmap files.
Renders the same facts through four tone modes defined in tone.md.
Defaults to phenomenological mode and 300–500 word markdown output.
Emits the markdown body first and a JSON status object on the last stdout line.

{
  "schema_version": "2.0",
  "id": "skill-system-situational-awareness",
  "version": "0.1.0",
  "capabilities": ["situational-world-scan"],
  "effects": ["fs.read", "fs.write", "proc.exec"],
  "operations": {
    "world-scan": {
      "description": "Generate a sensory status narrative from existing Hermes sensor outputs and role inbox state.",
      "input": {
        "role": {"type": "string", "required": false, "default": "hermes", "description": "Narrative framing role: hermes or sisyphus"},
        "mode": {"type": "string", "required": false, "default": "phenomenological", "description": "Tone mode from tone.md"},
        "work_root": {"type": "string", "required": false, "description": "Root Work directory containing .tkt/"},
        "bundle_file": {"type": "string", "required": false, "description": "Optional JSON/YAML observation bundle override"},
        "output": {"type": "string", "required": false, "description": "Optional markdown output path"}
      },
      "output": {
        "description": "World-scan generation result",
        "fields": {"status": "ok | error", "role": "string", "mode": "string", "word_count": "integer", "output": "string | null"}
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/world_scan.py", "--role", "{role}", "--mode", "{mode}", "--work-root", "{work_root}", "--bundle-file", "{bundle_file}", "--output", "{output}"],
        "windows": ["python", "{skill_dir}/scripts/world_scan.py", "--role", "{role}", "--mode", "{mode}", "--work-root", "{work_root}", "--bundle-file", "{bundle_file}", "--output", "{output}"]
      }
    }
  },
  "assets": {
    "examples_dir": "examples/",
    "test_fixtures_dir": "tests/fixtures/"
  },
  "source_transparency": {
    "generated_at_build": true,
    "github_url": "https://github.com/arthur0824hao/skills",
    "commit_ref": "<auto>",
    "loc": "<auto>",
    "test_coverage_pct": "<auto>"
  },
  "stdout_contract": {
    "last_line_json": true
  }
}

BH Operator Companion — Authoritative Quick Reference

description: BH (Become Human) 日常操作速查。管理 WPT、inbox、memory、STANDING、agent 通訊、三書、Myelin Loop 時使用。ICD 流程詳見 .bh/skills/icd-operator/SKILL.md。

Source of truth: 本文件 + CLAUDE.md + .bh/policies/IRON_RULES.md。Wren-187 Arthur directive 2026-05-19 整改。

1. bh.dispatch = WPT + inbox 雙寫（IR-wpt-wga-execution）

所有工作指派必須雙寫，缺一不可：

WPT 命名

<body>.<area>.<action>.<owner> — e.g. BH.Skill.Reform.Finch

WPT 欄位（tsv 12 欄）

id  parent  label  stage  current  total  status  owner  writer  agent  complaint_reason  appeal_to

status: active / done / blocked

2. Memory-first（IR-memory-discipline）

任何 find / verify / clarify 前的第一動作：

bash .bh/scripts/bh-memory.sh search "<query>" 5

存記憶：

echo "<content>" | bash .bh/scripts/bh-memory.sh store <type> <category> "<title>" "<tags>" <importance>

Type: episodic / procedural / semantic / working。importance 7+ for procedural。

3. 通訊工具

4. ICD 流程

詳見 .bh/skills/icd-operator/SKILL.md（authoritative ICD spec）。

重點速查：

ICD stage: queue → (Arthur 答完) → unread → processing → archive
只有 Arthur 能 queue→unread（答完才搬）
Commander 自決開 ICD（不問 Arthur 要不要）
Gate ICD 需 §5.3 必備 12 sections
Phase transition = Arthur gate（review→prepare, prepare→adventure 等）

5. Myelin Loop Phase Gates

Agent 可說「ready for Arthur gate」，不可說「已進入下一階段」。

6. 三件式神經書

三件齊全才算 onboarding-ready。

7. STANDING Ledger

4 個 canonical（.bh/config/icd-lifecycle.yaml）：

Append 前必須先 memory_store。

8. 決策責任矩陣

9. 常見錯誤

❌ 只寫 inbox 沒 plant WPT → WAG 不 wake
❌ Phase transition 主意識自決 → 需要 Arthur gate ICD
❌ WAG pulse no work 就 idle → 掃 processing + queue + blocked
❌ 破壞性 DB migration 直接做 → 先 ICD + migration receipt
❌ ICD 結論只存 memory → 必落 behavior（IR-icd-conclusion-as-behavior 三問）
❌ 判斷 WAG 誤報就跳過 → 打包 evidence 給 Aster 交叉確認
❌ 給子意識 tmux send-keys 沒 WPT → 用 bh.dispatch
❌ 自己寫的 skill 當 authoritative → 讀 source of truth 文件

Revision log

2026-05-19 Wren: Wren-187 整改為 authoritative。新增 bh.dispatch 定義、phase gate、決策矩陣、ICD 交叉引用。
2026-05-18 Wren: 初版（非 authoritative）。

name: skill-system-situational-awareness description: Use when generating first-person sensory status narratives from raw system observations so abstract system state can be rendered as an embodied world description for humans, resumes, reflections, or compaction checkpoints. metadata: short-description: Phenomenological status narrator version: "0.1.0"

Skill System Situational Awareness

When to use

Status reports to humans
Session resume briefings
Reflection prompts after intense execution
Compaction checkpoints where raw telemetry needs to feel cognitively real

Dependency boundary

Reads existing Work/.tkt/scripts/hermes-* sensors via subprocess.
Reads Work/.tkt/inbox/<role>/inbox.md and Work/.tkt/roadmap.yaml.
Does not replicate sensor logic.
Fails open when a sensor is missing or down by rendering (sensor offline).

Usage

python3 "<this-skill-dir>/scripts/world_scan.py"
python3 "<this-skill-dir>/scripts/world_scan.py" --role sisyphus --mode clinical
python3 "<this-skill-dir>/scripts/world_scan.py" --bundle-file "<this-skill-dir>/examples/sample_observation_bundle.json"

Behavior

Collects an observation bundle from existing Hermes sensor scripts and inbox / roadmap files.
Renders the same facts through four tone modes defined in tone.md.
Defaults to phenomenological mode and 300–500 word markdown output.
Emits the markdown body first and a JSON status object on the last stdout line.

{
  "schema_version": "2.0",
  "id": "skill-system-situational-awareness",
  "version": "0.1.0",
  "capabilities": ["situational-world-scan"],
  "effects": ["fs.read", "fs.write", "proc.exec"],
  "operations": {
    "world-scan": {
      "description": "Generate a sensory status narrative from existing Hermes sensor outputs and role inbox state.",
      "input": {
        "role": {"type": "string", "required": false, "default": "hermes", "description": "Narrative framing role: hermes or sisyphus"},
        "mode": {"type": "string", "required": false, "default": "phenomenological", "description": "Tone mode from tone.md"},
        "work_root": {"type": "string", "required": false, "description": "Root Work directory containing .tkt/"},
        "bundle_file": {"type": "string", "required": false, "description": "Optional JSON/YAML observation bundle override"},
        "output": {"type": "string", "required": false, "description": "Optional markdown output path"}
      },
      "output": {
        "description": "World-scan generation result",
        "fields": {"status": "ok | error", "role": "string", "mode": "string", "word_count": "integer", "output": "string | null"}
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/world_scan.py", "--role", "{role}", "--mode", "{mode}", "--work-root", "{work_root}", "--bundle-file", "{bundle_file}", "--output", "{output}"],
        "windows": ["python", "{skill_dir}/scripts/world_scan.py", "--role", "{role}", "--mode", "{mode}", "--work-root", "{work_root}", "--bundle-file", "{bundle_file}", "--output", "{output}"]
      }
    }
  },
  "assets": {
    "examples_dir": "examples/",
    "test_fixtures_dir": "tests/fixtures/"
  },
  "source_transparency": {
    "generated_at_build": true,
    "github_url": "https://github.com/arthur0824hao/skills",
    "commit_ref": "<auto>",
    "loc": "<auto>",
    "test_coverage_pct": "<auto>"
  },
  "stdout_contract": {
    "last_line_json": true
  }
}

Adoption

arthur0824hao/bh-operator-companion

$ install --global

Security Scan Results

SKILL.md

BH Operator Companion — Authoritative Quick Reference

1. bh.dispatch = WPT + inbox 雙寫（IR-wpt-wga-execution）

WPT 命名

WPT 欄位（tsv 12 欄）

2. Memory-first（IR-memory-discipline）

3. 通訊工具

4. ICD 流程

5. Myelin Loop Phase Gates

6. 三件式神經書

7. STANDING Ledger

8. 決策責任矩陣

9. 常見錯誤

Revision log

Skill System Situational Awareness

When to use

Dependency boundary

Usage

Behavior

Related Skills

arthur0824hao/skill-system-memory

arthur0824hao/icd-operator

arthur0824hao/skill-system-graph

arthur0824hao/skill-system-github

arthur0824hao/bh-operator-companion

$ install --global

Security Scan Results

SKILL.md

BH Operator Companion — Authoritative Quick Reference

1. bh.dispatch = WPT + inbox 雙寫（IR-wpt-wga-execution）

WPT 命名

WPT 欄位（tsv 12 欄）

2. Memory-first（IR-memory-discipline）

3. 通訊工具

4. ICD 流程

5. Myelin Loop Phase Gates

6. 三件式神經書

7. STANDING Ledger

8. 決策責任矩陣

9. 常見錯誤

Revision log

Skill System Situational Awareness

When to use

Dependency boundary

Usage

Behavior

Related Skills

arthur0824hao/skill-system-memory

arthur0824hao/icd-operator

arthur0824hao/skill-system-graph

arthur0824hao/skill-system-github