---
name: add-maf-active
description: maf-command-generatorのsavedataにアクティブ（魔法/スペル）を追加するスキル。active, 魔法, スペル, 呪文, アクティブスキル などの追加・新規作成が出たら使う。savedata/active/ai_workspace.json への書き込みを担う。
disable-model-invocation: true
---

# アクティブ追加

**対象ファイル:** `maf-command-generator/savedata/active/ai_workspace.json`

ユーザー生成物とAI生成物を分けるため、ai_workspace.json に必ず出力すること。ファイルがなければ新規作成する。

**実装方針:** `savedata/` 配下のJSONのみ参照・編集する。`maf-command-generator/app/` の Goコードは読まない。

## 要件整理

実装前に AskUserQuestion で不明点を確認する。

- アクティブID（例: thunder01 ／ 小文字・アンダースコア・ハイフンのみ）
- スペル名（表示名）
- 効果（範囲・対象・強さ）
- 演出（パーティクル・サウンド）の有無・種類

## 手順

1. `ai_workspace.json` が存在すれば読み込む。なければ `{"entries": []}` として扱う
2. `entries` に新エントリを追加
3. ファイルに書き戻す
4. `cd maf-command-generator && make run/export` でエクスポート
5. `make mc-cmd CMD='reload'` でデータパックリロード
6. `make mc-cmd CMD='function maf:generated/active/give/[id]'` を実行し、"Unknown or incomplete command" が出ないことを確認（アイテム生成の文法チェック）
7. `make mc-cmd CMD='function maf:generated/active/effect/[id]'` を実行してスクリプトを実際に発動し、エラーログ・"Unknown or incomplete command" が出ないことを確認（`give` チェックではスクリプト側のコマンドミスを検出できないため必須）

## JSONスキーマ

```json
{
  "entries": [
    {
      "id": "spell_name01",        // 必須: 小文字・アンダースコア・ハイフンのみ、ユニーク
      "castTime": 40,              // 必須: 詠唱時間(tick)。通常40(2秒)
      "coolTime": 20,              // 必須: クールダウン(tick)。通常20(1秒)
      "mpCost": 10,                // 必須: 消費MP(0〜60程度)
      "script": [                  // 必須: 発動時mcfunctionコマンド(1行以上)
        "execute as @e[type=#maf:enemymob,distance=..8,nbt={OnGround:1b}] run damage @s 6 minecraft:magic",
        "playsound minecraft:entity.evoker.cast_spell master @a ~ ~ ~ 2 2",
        "tellraw @a[distance=..50] [{\"selector\":\"@s\"},{\"text\":\" は スペル名 を唱えた！\"}]"
      ],
      "title": "スペル名",         // 必須: 表示名
      "description": "効果説明"    // 任意
    }
  ]
}
```

## scriptの典型パターン

```mcfunction

# 味方バフ
effect give @e[type=#maf:friendmob,distance=..10] minecraft:regeneration 10 0

# 視線先円範囲（sight亜種）
function maf:common/sight/eyes_circle_tagged {forward:4.0,radius:3.5,particleCount:80}
effect give @e[type=#maf:enemymob,tag=maf_sight_circle_target] minecraft:poison 10 10

# 演出
playsound minecraft:entity.blaze.shoot master @a ~ ~ ~ 1.0 0.5
tellraw @a[distance=..50] [{"selector":"@s"},{"text":" は スペル名 を唱えた！"}]
```

`eyes_circle_tagged` は `forward` / `radius` / `particleCount` が必須。共通側で `witch` が出るため、同じ中心演出を重複させない。

## エンティティタグ

| タグ | 意味 |
|------|------|
| `#maf:undead` | アンデッド（ゾンビ・スケルトン等） |
| `#maf:enemymob` | 敵モブ全般 |
| `#maf:friendmob` | 味方モブ |

## コスト設定

実装は試作とし、細かな数値は後に調整するため、ユーザーからの指定がなければ以下の数値で固定する。

mpCost: 10
castTime: 20
coolTime: 20

## 参照スキル

| スキル | 用途 |
|--------|------|
| `active` | アクティブNBT構造・ランタイムフロー・set_count等の詳細 |
| `magic-casting` | castTime/coolTime/mpCostの制約・詠唱パイプライン全体像 |
| `rcon` | RCONコマンド発行方法（make mc-cmd の使い方） |