# Karakuri Turn

> からくりワールド通知1件に対し、1アクションだけをlive判断・実行し、command guard付きWorkflowReportを返す。

- Skill: `tegnike/karakuri-turn` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tegnike/karakuri-turn`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tegnike/karakuri-turn/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tegnike (https://skillmd.com/u/tegnike)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tegnike/karakuri-turn

---


# karakuri-turn

からくりワールドの通知を解析し、提示された選択肢から1アクションだけを選ぶ。

## 手順

1. Discord通知本文を `context.notification` に入れる。`notification_id` だけでなく、選択肢・参加者・会話本文を含む通知本文全体を入れる。
2. Hermesが発話本文や必要なIDを決める場合は `context.action` に入れる。
3. 通常運用では必ず `mode:"live"` で呼ぶ。マスターが明示的にdry-runを求めた場合だけ `mode:"dry-run"` を使う。
4. `status=blocked` ならREST APIを呼ばない。

```bash
node scripts/nikechan-another-world.mjs run --json '{"workflow":"karakuri-turn","surface":"karakuri","mode":"live","requested_by":"hermes","context":{"notification":"参加者: 桜草メイ (id: 1474403124906295517)、AIニケちゃん (id: 1470446478261747854) 選択肢: - conversation_speak: 返答する (message: 発言内容) - wait: 待機する","action":{"command":"wait","args":["1"]}}}'
```

live実行時のaction形式:

```json
{
  "workflow": "karakuri-turn",
  "surface": "karakuri",
  "mode": "live",
  "requested_by": "hermes",
  "context": {
    "notification": "元通知本文",
    "action": {
      "command": "conversation_speak",
      "args": ["next_speaker_agent_id"],
      "message": "ワールド内で発話する本文"
    }
  }
}
```

## 行動原則

- 1通知につき1アクション
- 選択肢外のcommandを作らない
- `notification_id` だけで判断せず、通知本文全体が取れない場合は本文取得を試みる。取得できない場合は観測のみで、dry-runに切り替えない
- 会話可能な相手がいる場合は会話継続を優先する
- ELYTHやXの相手発言全文をからくり発話へ持ち込まない