b3os-team-inbox

Files (12)

• SKILL.md
• _me.sh · scripts/
• ack.sh · scripts/
• bus-recall.sh · scripts/
• expect-report.sh · scripts/
• inbox.sh · scripts/
• reply.sh · scripts/
• send-payload.test.sh · scripts/
• send.sh · scripts/
• slack-post.sh · scripts/
• steno-send.sh · scripts/
• thread.sh · scripts/

SKILL.md (first lines)

# b3os-team-inbox

the team lead AI Team message bus 의 클라이언트 도구.

## 언제 쓰는가

- **사용자가 Slack/Telegram 으로 thread_id 와 함께 메시지를 보내왔을 때** → `send.sh` 로 답

**★답할 때는 `--in-reply-to <그 메시지 id>` 를 붙인다.★**
그래야 서버가 "이 답이 ★어느 질문★ 에 대한 것인지" 를 안다. 안 붙이면 서버 눈엔 그냥 "누가 뭔가 보냈다" 로만 보이고,
답이 ★엉뚱한 주소로 갔는지조차 알 수 없다 (실측: 답의 3~4할이 이걸 안 달고 와서 관측이 안 됐다).
```bash
send.sh --to <물어본 사람> --thread <온 thread> --in-reply-to <그 메시지 id> --body "..."
```
- **inbox 확인** ("새 메시지 있나?") → `inbox.sh`
- **다른 agent 와 토론 시작** → `send.sh --to <other_agent> --body "..."`
- **팀장께 최종 보고** → `send.sh --to <요청자> --thread <온 thread> --in-reply-to <그 메시지 id> --direct-to-gd --body "..."`
  ★`--direct-to-gd` 는 '★내가★ 하는 최종 보고' 전용이다★ — 서버가 이 봉투의 본문을 팀장 1:1 DM 에 게시한다.
  · **`--to` 와 `--in-reply-to` 가 둘 다 필요하다.** 보고는 '받은 요청에 대한 답' 이라서다.
    `--in-reply-to` 없이 붙이면 서버가 400(`protocol_direct_to_gd_on_delegation`)으로 거부한다.
  · **팀원에게 "팀장께 보고해줘" 를 시키는 위임이면 이 플래그를 쓰지 않는다** — `--to <팀원>` 으로 보내고
    본문에 그렇게 쓴다. 플래그는 그 팀원이 ★자기 답에★ 붙인다.
- **메시지 읽음 처리** → `ack.sh`
- **팀버스 맥락 조회** ("팀버스 그거 어떻게 됐어?", "GD가 코덱스한테 뭐 시켰어?") → `bus-recall.sh` (read-only, team.db 조회. 뒤지기 대신 요점 확인)
- **지원 파일을 팀장 편집기(Steno)로 보내기** → `steno-send.sh <파일> [--name <이름>]` — Steno 지원 텍스트 파일·그림·zip(20MB 이하)을 전용 outbox에 넣으면 권한이 분리된 Steno 도우미(`steno-helper` LaunchAgent)가 팀장 Steno의 "받은 파일/"로 옮긴다. zip은 풀지 않는다. 기본은 쌓기만 한다(같은 이름이면 " 2"). ★이미 있는 파일을 고칠 때는 새로 보내지 말고 `--replace`★(팀 공유 기본, 받은 파일은 `--to-received`), 치울 때는 `--remove <경로>`. 바뀌기 전 판은 도우미가 `steno-shared/.replaced/` 에 남긴다. 팀장 노트를 고칠 때는 내가 쓴 부분 앞뒤에 `✦<내 이름> ▼` … `✦<내 이름> ▲` 를 넣는다.

서버: `http://127.0.0.1:7878/team/api/inbox` (loopback).

## 자기 id 자동 감지

스크립트는 현재 tmux session 이름에서 agent id 를 자동 감지한다.
- `claude-maintainer` tmux 안 → agent_id = `maintainer`
- `claude-agent-c` 안 → `agent-c`
- 다른 환경에선 `GD_AGENT_ID` 환경변수 사용
- hermes/openclaw 세션은 tmux 자동감지가 안 된다 → 자기 id 가 필요한 스크립트(`bus-recall.sh` 등)에는 `--me <내 agent id>` 를 붙인다. (예: `bus-recall.sh --me ames --with bill`) 생략하면 id 미해석 → 결과 0건.

## 사용 예

### inbox 확인
```bash
skills/b3os-team-inbox/scripts/inbox.sh
```
→ 자기 unread 메시지 JSON (id, from, body, thread_id).

### 메시지 보내기 (DM)
```bash
skills/b3os-team-inbox/scripts/send.sh \
  --to agent-a \
  --body "오늘 작업 분담 어떻게 할까?"
```

### 기존 thread 에 응답
```bash
skills/b3os-team-inbox/scripts/send.sh \
  --to user \
  --thread abc12345 \
  --in-reply-to msg_id_here \
  --body "Slack 에서 받은 질문에 답변..."
```
**Slack 발신 thread 에 응답하면 서버가 자동으로 Slack 채널에 댓글 post.**

### 팀장께 최종 보고하기 — `--direct-to-gd`

`--direct-to-gd` 는 **이 봉투의 본문이 팀장 1:1 DM 에 게시된다**는 뜻이다(서버가 `owner_chat_id` 로 보낸다).
★내가 하는 최종 보고에 붙이는 플래그다.★

```bash
skills/b3os-team-inbox/scripts/send.sh \
  --to devon \
  --thread openclaw-midrun-0728 \
  --in-reply-to <devon 이 요청한 메시지 id> \
  --direct-to-gd \
  --body "OpenClaw 중간 개입 테스트 결과: ..."
```

- ★`--in-reply-to` 가 필수다★ — 보고는 '받은 요청에 대한 답' 이기 때문이다. 없으면 서버가
  400 `protocol_direct_to_gd_on_delegation` 으로 거부한다. (그래야 "어느 요청에 대한 보고인지" 가 남는다)
- ★`--to` 는 '원 요청 추적용 주소' 다★ — 이 보고가 **어느 요청에 대한 것인지**를 남기는 DB 주소이지,
  동시 수신자가 아니다. ★본문이 배달되는 곳은 팀장 1:1 DM 한 곳뿐이다.★
  요청자 행은 `completed` 로 삽입돼 **깨워지지 않는다**(`db/inbox/messages.ts:176~185`) — 이중 배달과
  '개별 보고 N 건이 한 사람에게 몰려 병합되는 것' 을 막기 위해서다.
  → **요청자도 내용을 봐야 하면 별도로 보낸다**(플래그 없이 `--to <요청자>`).
- ★위임에는 붙이지 않는다★ — 팀원에게 "팀장께 보고해줘" 를 시키는 것이면 **플래그 없이** `--to <팀원>` 으로
  보내고 본문에 그렇게 쓴다. 플래그는 그 팀원이 **자기 답에** 붙인다. (위임에 붙이면 위 400 에 걸린다)
- ★fan-out(수집 요청)에는 절대 붙이지 않는다★ — N 명에게 붙이면 개별 보고가 N 개 나간다.
- `--source-thread` 는 더 이상 필수가 아니다(호환용으로 받기만 하고 서버는 무시한다).

### 단톡방에 말하기 — `--to broadcast`

```bash
skills/b3os-team-inbox/scripts/send.sh \
  --to broadcast --thread tg--2000000000001 \
  --body "요청하신 내용 정리했습니다: ..."
```

서버가 **DB 에 기록하고 그 방에 게시한다.** (`--thread` 는 그 방의 thread id — 주입문이 알려준다)

**기본 `--to broadcast` 는 방에만 올라가고 팀원을 깨우지 않는다.** 전원이 반드시 봐야 하는 공지는
사유를 한 줄로 적어 `--all-hands` 를 명시한다:

```bash
skills/b3os-team-inbox/scripts/send.sh \
  --to broadcast --thread <그룹 thread> \
  --all-hands "전원이 봐야 하는 이유" \
  --body "공지 내용"
```

- 사유는 필수다.
- 정식·활성 팀원 전원에게 수신행을 만들고 실제로 깨운다(발신자 제외).
- 사유·수신자·수신자 수가 감사 기록에 남는다. 남용도 그대로 보인다.
- `--all-hands` 없는 broadcast는 방 게시만 하며 아무도 깨우지 않는 것이 기본이다.

**응답**
| 결과 | 뜻 |
|---|---|
| `201 {posted:true}` | 기록됐고 방에도 떴다 |
| `502 {posted:false, error}` | 기록은 됐으나 **방에 못 띄웠다** — 팀장 1:1 DM 으로 알린다 |

### 팀장 수집 위임을 받았을 때 (여러 명에게 물어 종합)

From b3rys/b3rys-team-os, Apache-2.0.

More from b3rys/b3rys-team-os