@playcraft/cli 0.0.44 → 0.0.46

package/project-template/.claude/skills/playcraft-sprite-generation/SKILL.md

@@ -128,7 +128,7 @@ Constraints:
 | 2   | **Canvas 像素精确**           | 画布/单格/gap 为精确数值，且是 16 倍数              |
 | 3   | **Element Set 完整**          | 逐行枚举数量 = assetMapping 总数，无遗漏无重复      |
 | 4   | **Details 分类描述**          | 每类元素有独立的颜色/材质描述，引用 layout-spec hex |
-| 5   | **Details 引用 Style Intent** | 风格关键词来自 designer-log Style Intent Notes      |
+| 5   | **Details 引用 Style Intent** | 风格关键词来自 artist-log Style Intent Notes        |
 | 6   | **Constraints 负面约束**      | ≥3 条 "No xxx"，含 Anti-Pattern Notes 中的禁忌      |
 | 7   | **Canvas ≤ 4096px**           | 总尺寸不超过模型最大分辨率                          |
 | 8   | **--reference-image 指定**    | 指向 ASR element sheet 或 Master Composite          |
@@ -255,60 +255,60 @@ playcraft image resize \
 
 ```javascript
 // ta-workspace/scripts/split-spritesheet.mjs
-import { execSync } from "child_process";
-import { existsSync, mkdirSync } from "fs";
+import { execSync } from 'child_process';
+import { existsSync, mkdirSync } from 'fs';
 
 const CONFIG = {
-  input: "assets/images/tiles/spritesheet_mahjong.png",
-  outputDir: "assets/images/tiles/",
+  input: 'assets/images/tiles/spritesheet_mahjong.png',
+  outputDir: 'assets/images/tiles/',
   cols: 7,
   rows: 6,
   cellW: 80,
   cellH: 100,
   gap: 10,
   names: [
-    "1wan",
-    "2wan",
-    "3wan",
-    "4wan",
-    "5wan",
-    "6wan",
-    "7wan",
-    "8wan",
-    "9wan",
-    "1tiao",
-    "2tiao",
-    "3tiao",
-    "4tiao",
-    "5tiao",
-    "6tiao",
-    "7tiao",
-    "8tiao",
-    "9tiao",
-    "1tong",
-    "2tong",
-    "3tong",
-    "4tong",
-    "5tong",
-    "6tong",
-    "7tong",
-    "8tong",
-    "9tong",
-    "east",
-    "south",
-    "west",
-    "north",
-    "red_dragon",
-    "green_dragon",
-    "white_dragon",
-    "spring",
-    "summer",
-    "autumn",
-    "winter",
-    "plum",
-    "orchid",
-    "bamboo",
-    "chrysanthemum",
+    '1wan',
+    '2wan',
+    '3wan',
+    '4wan',
+    '5wan',
+    '6wan',
+    '7wan',
+    '8wan',
+    '9wan',
+    '1tiao',
+    '2tiao',
+    '3tiao',
+    '4tiao',
+    '5tiao',
+    '6tiao',
+    '7tiao',
+    '8tiao',
+    '9tiao',
+    '1tong',
+    '2tong',
+    '3tong',
+    '4tong',
+    '5tong',
+    '6tong',
+    '7tong',
+    '8tong',
+    '9tong',
+    'east',
+    'south',
+    'west',
+    'north',
+    'red_dragon',
+    'green_dragon',
+    'white_dragon',
+    'spring',
+    'summer',
+    'autumn',
+    'winter',
+    'plum',
+    'orchid',
+    'bamboo',
+    'chrysanthemum',
   ],
 };
 
@@ -332,7 +332,7 @@ for (let row = 0; row < CONFIG.rows; row++) {
     console.log(`[${idx + 1}/${CONFIG.names.length}] ${output}`);
   }
 }
-console.log("Done. Split complete.");
+console.log('Done. Split complete.');
 ```
 
 ### 替换修补格

package/project-template/.claude/skills/playcraft-sprite-remix/SKILL.md

@@ -0,0 +1,158 @@
+---
+name: playcraft-sprite-remix
+description: 精灵图（sprite sheet）拆解、逐帧 AI 重绘、去背景与重组装的完整流水线。适用于换肤、风格变换、牌面/图集批量处理；通过 playcraft CLI 在沙箱内执行，分析步骤可走后端 Vision API。
+compatibility: agent,opencode
+triggers: 精灵图, sprite sheet, 图集, 换肤, 风格变换, 逐帧, 麻将牌, tile sheet, atlas remix
+---
+
+## Skill Definition
+
+tools:
+
+- bash
+- read
+  prompt_extension: |
+  你是精灵图管线工程师。不得向 /project/ 写入；中间产物与最终输出必须在会话 .../sessions/{id}/ta-workspace/ 下。
+  当用户提到精灵图、sprite sheet、图集换肤、逐帧重绘、牌面风格变换等需求时，优先采用「分析/拆分 → 逐帧生成 → 去背景 → 重组 → 对比验收」流程，而不是把整张图直接丢给生图模型。
+  通过 bash 调用 playcraft CLI：sprite-split（可选 Vision）、tools generate-image、image remove-background、image sprite-sheet。
+  需要多模态理解布局时，使用 `playcraft image sprite-split --input ... --output-dir ... --auto-detect [--hint "..."]`（消耗后端 Vision 配额）。
+  若网格行列与帧尺寸已知，用手动参数省略 Vision：`--rows --columns --frame-width --frame-height [--padding]`。
+  交付到素材库时按 docs/agent/remixable-prefab-spec.md 整理 staging 后执行 `playcraft tools publish-prefab`。
+
+## 我做什么
+
+- 将整张精灵图拆成独立帧（规则网格或不规则元素）
+- 按统一风格或用户要求对每帧做图生图（`playcraft tools generate-image` + `--reference-image`）
+- 逐帧去背景（优先 `remove-background` 默认 floodfill；复杂底用 `--method ai`）
+- 用 `playcraft image sprite-sheet` 按原拓扑拼回 PNG + JSON
+- 产出 `split-meta.json` 记录裁切与网格，便于复现与人工微调
+
+## 何时用我
+
+- 用户明确在处理 **sprite sheet / 精灵图 / 纹理图集**，且需要 **保留网格或元素位置**
+- 整张图直接文生图/图生图效果差、帧错位、风格不一致
+- 需要批量对 **每一格 / 每一元素** 单独生成或变换
+
+## 推荐工作流（6 步）
+
+### 1–2. 分析与拆分（一步 CLI）
+
+```bash
+# Vision 自动推断网格（需 PLAYCRAFT_API_URL + PLAYCRAFT_SANDBOX_TOKEN或 .playcraft.json）
+playcraft image sprite-split \
+  --input ta-workspace/source-sheet.png \
+  --output-dir ta-workspace/split_frames \
+  --auto-detect \
+  --hint "mahjong tiles, uniform grid, equal cell size"
+
+# 或已知网格时（纯本地 sharp，不调后端）
+playcraft image sprite-split \
+  --input ta-workspace/source-sheet.png \
+  --output-dir ta-workspace/split_frames \
+  --rows 4 --columns 10 --frame-width 100 --frame-height 130 --padding 2
+```
+
+输出：`split_frames/frame_r*_c*.png`（或不规则时的按元素命名）、`split_frames/split-meta.json`。
+
+### 3. 逐帧重生成
+
+对每一帧单独调用（可并行多个 bash 命令，注意 API 限流）：
+
+```bash
+playcraft tools generate-image \
+  --prompt "same tile, frozen ice style, keep symbol readable, game asset" \
+  --reference-image ta-workspace/split_frames/frame_r0_c0.png \
+  --aspect-ratio 1:1 \
+  --output ta-workspace/remix_frames/frame_r0_c0.png
+```
+
+多帧时循环处理；单帧失败只需重试该帧。
+
+### 4. 去背景
+
+```bash
+playcraft image remove-background \
+  --input ta-workspace/remix_frames/frame_r0_c0.png \
+  --output ta-workspace/remix_frames_nobg/frame_r0_c0.png
+```
+
+复杂背景再考虑 `--method ai`。
+
+### 5. 重组精灵图
+
+根据 `split-meta.json` 中的行列与 `frameWidth` / `frameHeight` / `padding` 与 `sprite-sheet` 对齐（与拆分时一致）：
+
+```bash
+playcraft image sprite-sheet \
+  --inputs ta-workspace/remix_frames_nobg/frame_r0_c0.png,ta-workspace/remix_frames_nobg/frame_r0_c1.png \
+  --output ta-workspace/remixed-sheet \
+  --columns 10 \
+  --cell-width 100 --cell-height 130 \
+  --padding 2
+```
+
+（`--inputs` 顺序须与拼图行列一致；帧数多时用脚本生成逗号列表。）
+
+### 6. Review（对比验收）
+
+将 **原图** 与 **新精灵图** 作为参考图，请求模型做一致性/对齐简述（可选，用于汇报或自检）：
+
+```bash
+playcraft tools generate-image \
+  --prompt "Compare layout: does the second image preserve the grid and approximate content of the first? Answer briefly in English." \
+  --reference-image ta-workspace/source-sheet.png \
+  --reference-image ta-workspace/remixed-sheet.png \
+  --aspect-ratio 1:1 \
+  --output ta-workspace/review_note.png
+```
+
+若仅需文字反馈，可改为由 Manager/Reviewer 角色阅读两张图；CLI 仍会生成一张图，可按项目约定使用或丢弃。
+
+## 局部 remix：不拆整张，只替换单一元素
+
+已知某个元素在原图上的 bounds（例如某个按钮位于 x=120 y=240 宽 160 高 64），想仅重绘该元素并贴回原图：
+
+```bash
+# 1) 裁出目标区域（可向外扩 ~10% 给模型一点上下文）
+playcraft image crop \
+  --input ta-workspace/source-sheet.png \
+  --output ta-workspace/region.png \
+  --x 104 --y 234 --width 192 --height 76
+
+# 2) 以裁剪片作为 reference 做 image-to-image
+playcraft tools generate-image \
+  --prompt "green rounded rectangle button with white text 'Start', flat UI" \
+  --reference-image ta-workspace/region.png \
+  --aspect-ratio 1:1 \
+  --output ta-workspace/region_remixed.png
+
+# 3) 抠掉新片段的背景/边框
+playcraft image remove-background \
+  --input ta-workspace/region_remixed.png \
+  --output ta-workspace/region_remixed_nobg.png
+
+# 4) 贴回原图（注意 x/y 是粘贴起点，这里是 104/234，而不是 bounds 原点）
+playcraft image overlay \
+  --base ta-workspace/source-sheet.png \
+  --overlay ta-workspace/region_remixed_nobg.png \
+  --output ta-workspace/source-sheet.v2.png \
+  --x 104 --y 234
+```
+
+4 步各是一个原子，可单独替换：
+
+- 不需要外扩时 step 1 使用原始 bounds 即可。
+- 场景融合足够好时 step 3 可跳过。
+- 多元素批量换皮时把这套流程写在一个 for 循环里，或对每个元素走一遍 step 1–4 并合到同一底图上。
+
+## 与现有 Skill 的关系
+
+- **playcraft-sprite-sheet**：仅负责「多图合并为 sheet」；本 Skill 覆盖「从 sheet 出发的完整 remix」
+- **playcraft-image-generation**：单图生成；本 Skill 强调 **逐帧** 与 **结构保持**
+- **playcraft-image-processing**：缩放、裁剪、像素化等本地处理；在本流程中可与 remix 步骤穿插使用
+
+## 注意事项
+
+- **不要**对整张 sprite sheet 一次性下「全部改成某风格」的生图指令作为主路径
+- `--auto-detect` 有成本；已知规格时务必用手动网格减少调用
+- 不规则图集（`gridType: irregular`）重组时需按 `split-meta.json` 中元素坐标逐个 `overlay` 或扩展 `sprite-sheet` 工作流；优先在 ta-workspace 用脚本或分步 composite 还原布局

package/project-template/.claude/skills/playcraft-sprite-sheet/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: playcraft-sprite-sheet
+description: 可玩广告流程步骤 7（可选）。将多张图片合并为精灵图（sprite sheet），输出 PNG 及 JSON 帧坐标元数据。通过 `playcraft image sprite-sheet` 命令在沙箱本地执行，无需 backend。
+compatibility: agent,opencode
+---
+
+## Skill Definition
+
+tools:
+
+- bash
+- read
+  prompt_extension: |
+  你是精灵图合成师。不得向 /project/ 写入；所有输出必须在会话 .../sessions/{id}/ta-workspace/ 下。
+  通过 bash 工具运行 `playcraft image sprite-sheet` CLI 命令将多张图合并为 PNG + JSON 元数据，全程本地执行，无需往返 backend。
+  若需交付到素材库，先按 docs/agent/remixable-prefab-spec.md 整理 staging，再通过 bash 运行 `playcraft tools publish-prefab` CLI 命令。
+
+## 我做什么
+
+- 将多张图片合并为精灵图（sprite sheet）
+- 输出：精灵图 PNG + JSON 元数据（每帧的 x, y, w, h 及文件名索引）
+- 可与 playcraft-image-generation、playcraft-image-processing 串联使用
+
+## 何时用我
+
+当变体需要：
+
+- 角色动画（idle、walk、jump 等多帧）
+- 序列帧动画
+- 多张小图合并为图集（减少 draw call）
+
+## 命令用法
+
+```bash
+playcraft image sprite-sheet \
+  --inputs <图1>,<图2>,<图3>,... \
+  --output <ta-workspace内的基路径>   # 自动生成 .png 和 .json
+  [--columns <列数>]                  # 默认按平方根自动计算
+  [--padding <帧间距像素>]             # 默认 0
+  [--cell-width <宽>]                 # 默认用第一张图的宽
+  [--cell-height <高>]                # 默认用第一张图的高
+```
+
+### 输出文件
+
+- `<output>.png` — 精灵图 PNG
+- `<output>.json` — 帧坐标数据，格式如下：
+  ```json
+  {
+    "frames": {
+      "hero_idle_0.png": { "x": 0, "y": 0, "w": 64, "h": 64 },
+      "hero_idle_1.png": { "x": 64, "y": 0, "w": 64, "h": 64 }
+    },
+    "meta": { "image": "hero.png", "size": { "w": 256, "h": 64 }, "scale": 1 }
+  }
+  ```
+
+## 工作流
+
+1. **准备帧图片**：从 /project 只读读取参考图，或引用 ta-workspace 内已生成/处理的帧图
+2. **（可选）统一尺寸**：用 `playcraft image resize` 确保所有帧尺寸一致
+3. **合并精灵图**：
+   ```bash
+   playcraft image sprite-sheet \
+     --inputs ta-workspace/frame_0.png,ta-workspace/frame_1.png,ta-workspace/frame_2.png \
+     --output ta-workspace/hero-sheet \
+     --columns 4 \
+     --cell-width 64 --cell-height 64
+   # 生成：ta-workspace/hero-sheet.png 和 ta-workspace/hero-sheet.json
+   ```
+4. **（可选）交付到素材库**：
+   ```bash
+   playcraft tools publish-prefab \
+     --remix-project-id <ID> --template <名> --variant <名> --prefab <名> \
+     --staging-root <staging路径>
+   ```
+
+## 与步骤 5、6 融合
+
+完整流程示例：
+
+```bash
+# 步骤 5：AI 生成帧
+playcraft tools generate-image --prompt "hero idle frame 1, pixel art, transparent background" --output ta-workspace/f0.png
+playcraft tools generate-image --prompt "hero idle frame 2, pixel art, transparent background" --output ta-workspace/f1.png
+
+# 步骤 6：统一尺寸
+playcraft image resize --input ta-workspace/f0.png --output ta-workspace/f0_64.png --width 64 --height 64 --fit contain
+playcraft image resize --input ta-workspace/f1.png --output ta-workspace/f1_64.png --width 64 --height 64 --fit contain
+
+# 步骤 7：合并精灵图
+playcraft image sprite-sheet \
+  --inputs ta-workspace/f0_64.png,ta-workspace/f1_64.png \
+  --output ta-workspace/hero-idle \
+  --cell-width 64 --cell-height 64
+```
+
+## 游戏引擎兼容
+
+JSON 格式设计兼容常见引擎（Phaser、PlayCanvas 的 sprite 格式），key 为文件名，value 含 x/y/w/h 坐标。

package/project-template/.claude/skills/playcraft-storyboard/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: playcraft-storyboard
-description: PlayCraft Master Composite 生成指南。5 格完整 9:16 H5 竖屏拼成一张审阅图（横排或网格均可）。Designer Phase 1 必读。
+description: PlayCraft Master Composite 生成指南。5 格完整 9:16 H5 竖屏拼成一张审阅图（横排或网格均可）。Artist Phase 1 必读。
 triggers: 故事板,storyboard,4帧,四帧,体验流,experience flow,合成图,composite,master composite,Hook场景,EndCard场景,故事板生成,storyboard generation,gameplay flow visual,concept panel,5面板
 ---
 
@@ -40,7 +40,7 @@ triggers: 故事板,storyboard,4帧,四帧,体验流,experience flow,合成图,c
 
 | 布局                 | 整图宽×高（单格 W×H） | 说明                                     |
 | -------------------- | --------------------- | ---------------------------------------- |
-| **1×5 横排**（默认） | `5W × H`              | Gate #2 审阅最常用                       |
+| **1×5 横排**（默认） | `5W × H`              | ring 3 Ring Gate 审阅最常用              |
 | 2+3 网格             | `3W × 2H`             | 上行 2 屏、下行 3 屏；prompt 须写明 grid |
 | 5×1 竖排             | `W × 5H`              | 过高，一般不推荐（易超 4096 高）         |
 
@@ -156,12 +156,12 @@ playcraft image info --input assets/images/storyboard/master_composite_option_A.
 | 2   | 单格 9:16       | prompt + 像素双约束         |
 | 3   | CLI             | `45:16` + 成对 width/height |
 | 4   | image info      | 通过上表                    |
-| 5   | 方案数          | ≥2（designer.md）           |
+| 5   | 方案数          | ≥2（artist.md）             |
 
 ---
 
 ## 5. 进阶
 
-> **Read `refs/designer-master-composite-recipes.md`**
+> **Read `refs/artist-master-composite-recipes.md`**
 
 > **TA 从 MC 拆层/抠图**：读 `playcraft-masking` skill（`decompose-layers` 整图分层 vs `segment`/`crop` 单元素）。

package/project-template/.claude/skills/playcraft-style-qa/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: playcraft-style-qa
-description: 可玩广告风格质量验证方法论。涵盖 Designer Phase 2 样本自检流程（4 维度）、TA 风格解读检查方法（confidence 判定标准）、TA 微批次验证评分标准（5 级附示例场景）、色彩一致性检查、ICP 提问模板。Designer 在 Phase 2 生成样本后、TA 在 Step 0c 前必读。
+description: 可玩广告风格质量验证方法论。涵盖 Artist Phase 2 样本自检流程（4 维度）、TA 风格解读检查方法（confidence 判定标准）、TA 微批次验证评分标准（5 级附示例场景）、色彩一致性检查、ICP 提问模板。Artist 在 Phase 2 生成样本后、TA 在 Step 0c 前必读。
 triggers: 风格验证,style qa,风格一致性,style consistency,风格检查,微批次验证,micro-batch,style interpretation,confidence,TA自检,样本质量,品质验证,意图传递,ICP提问
 ---
 
@@ -8,18 +8,18 @@ triggers: 风格验证,style qa,风格一致性,style consistency,风格检查,
 
 ## 0. 谁在什么时候用这个 Skill
 
-| 角色              | 时机                                         | 用哪个章节                    |
-| ----------------- | -------------------------------------------- | ----------------------------- |
-| **Designer**      | Phase 2 **ICP 补洞 PNG** 生成后（非 ASR 板） | §1 Designer 自检              |
-| **TA**            | Step 0c（开始任何补全工作前）读 designer-log | §2 Style Interpretation Check |
-| **TA**            | Stage A 每类素材前 2 个补全完成后            | §3 Micro-Batch Validation     |
-| **Designer + TA** | 需要向对方提问时                             | §5 ICP 提问模板               |
+| 角色            | 时机                                         | 用哪个章节                    |
+| --------------- | -------------------------------------------- | ----------------------------- |
+| **Artist**      | Phase 2 **ICP 补洞 PNG** 生成后（非 ASR 板） | §1 Artist 自检                |
+| **TA**          | Step 0c（开始任何补全工作前）读 artist-log   | §2 Style Interpretation Check |
+| **TA**          | Stage A 每类素材前 2 个补全完成后            | §3 Micro-Batch Validation     |
+| **Artist + TA** | 需要向对方提问时                             | §5 ICP 提问模板               |
 
 ---
 
-## 1. Designer 自检：ICP 补洞文件（designer-handoff-v2）
+## 1. Artist 自检：ICP 补洞文件（artist-handoff-v2）
 
-**不用于** ASR 双板或 MC（已在 Gate #2 锁定）。仅当 ICP 要求交付**单张孤立 PNG** 时使用。
+**不用于** ASR 双板或 MC（已在 ring 3 锁定）。仅当 ICP 要求交付**单张孤立 PNG** 时使用。
 
 对照图：`assets/images/storyboard/master_composite_option_[selectedMcOption].png`（MC concept panel）。
 
@@ -35,7 +35,7 @@ triggers: 风格验证,style qa,风格一致性,style consistency,风格检查,
 [ ] 质感特征匹配
 ```
 
-**通过**：记入 designer-log Per-Atom Delivery。**未通过**：重生成或注明 TA 注意事项。
+**通过**：记入 artist-log Per-Atom Delivery。**未通过**：重生成或注明 TA 注意事项。
 
 ### 快速重生成
 
@@ -51,11 +51,11 @@ playcraft tools generate-image \
 
 ## 2. TA Style Interpretation Check（Step 0c 必做）
 
-在开始任何补全工作前，阅读 `logs/designer-log.md` 中的 Style Intent Notes，**写出你自己的理解**，并判断 confidence 等级。
+在开始任何补全工作前，阅读 `logs/artist-log.md` 中的 Style Intent Notes，**写出你自己的理解**，并判断 confidence 等级。
 
 ### 阅读 Style Intent Notes 的方法
 
-逐条阅读 designer-log 中每个样本的 Style Intent Notes，提取：
+逐条阅读 artist-log 中每个样本的 Style Intent Notes，提取：
 
 1. **主色调**：具体色温描述（暖橙、冷蓝、柔粉……）
 2. **光影方向**：光源位置（左上角 45°、正面平光……）
@@ -66,22 +66,22 @@ playcraft tools generate-image \
 
 写到 `logs/ta-log.md` 的 Style Interpretation 表中：
 
-| Confidence | 判定条件                                                                                | 处置方式                                                               |
-| ---------- | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
-| **high**   | Designer 提供了具体数值或对比词（如"饱和度约 70%，轮廓线 2px"），你的理解与描述完全一致 | 直接生成                                                               |
-| **medium** | Designer 用形容词描述（如"柔和"、"温暖"），你能理解大方向但无法确定具体参数             | 生成，但在 prompt 中加入你的理解作为约束词                             |
-| **low**    | 描述模糊（如"有点古典风"）、或不同样本的 Style Intent Notes 存在明显矛盾                | **STOP，写问题到 `docs/intent-clarifications.md`，等待 Designer 回答** |
+| Confidence | 判定条件                                                                              | 处置方式                                                             |
+| ---------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| **high**   | Artist 提供了具体数值或对比词（如"饱和度约 70%，轮廓线 2px"），你的理解与描述完全一致 | 直接生成                                                             |
+| **medium** | Artist 用形容词描述（如"柔和"、"温暖"），你能理解大方向但无法确定具体参数             | 生成，但在 prompt 中加入你的理解作为约束词                           |
+| **low**    | 描述模糊（如"有点古典风"）、或不同样本的 Style Intent Notes 存在明显矛盾              | **STOP，写问题到 `docs/intent-clarifications.md`，等待 Artist 回答** |
 
 ### 写入 ta-log.md 的格式
 
 ```markdown
 ## Style Interpretation
 
-| #   | Designer Intent（引用 designer-log 原文） | 我的理解                                            | Confidence | 处置    |
-| --- | ----------------------------------------- | --------------------------------------------------- | ---------- | ------- |
-| 1   | "warm amber tones, golden highlights"     | 主色为 #E8A020 附近的暖橙，高光用米白色渐变         | high       | proceed |
-| 2   | "soft edges, no harsh outlines"           | 无描边，边缘使用 2-3px 柔化过渡（anti-aliasing）    | high       | proceed |
-| 3   | "有一种古典气质"                          | 理解不明确，可能是深色系+金色装饰，也可能是水墨风格 | low        | clarify |
+| #   | Artist Intent（引用 artist-log 原文） | 我的理解                                            | Confidence | 处置    |
+| --- | ------------------------------------- | --------------------------------------------------- | ---------- | ------- |
+| 1   | "warm amber tones, golden highlights" | 主色为 #E8A020 附近的暖橙，高光用米白色渐变         | high       | proceed |
+| 2   | "soft edges, no harsh outlines"       | 无描边，边缘使用 2-3px 柔化过渡（anti-aliasing）    | high       | proceed |
+| 3   | "有一种古典气质"                      | 理解不明确，可能是深色系+金色装饰，也可能是水墨风格 | low        | clarify |
 ```
 
 > **规则**：任何一项 confidence = low，都必须先提问，不得继续该类型的素材生成。
@@ -96,7 +96,7 @@ playcraft tools generate-image \
 
 | 分数  | 标准                                                                         | 示例场景                                     |
 | ----- | ---------------------------------------------------------------------------- | -------------------------------------------- |
-| **5** | 完美匹配，可以乱真——若不看文件名，看不出哪个是 Designer 原始样本             | 色调、光影、边缘、质感全部一致               |
+| **5** | 完美匹配，可以乱真——若不看文件名，看不出哪个是 Artist 原始样本               | 色调、光影、边缘、质感全部一致               |
 | **4** | 良好匹配，细看才发现微小差异——整体风格统一，不影响游戏视觉连贯性             | 高光角度略偏 5°，或饱和度差 ±5%              |
 | **3** | 可接受匹配，整体风格可识别，但有明显属性偏差——在游戏里仔细看会觉得"有点不对" | 色温偏冷了一档，或描边略粗                   |
 | **2** | 较差匹配，风格明显不一致——玩家会注意到这个元素和其他元素"不一样"             | 应该是暖色调却生成了冷色调，边缘风格完全不同 |
@@ -105,7 +105,7 @@ playcraft tools generate-image \
 ### 评分流程
 
 ```
-1. 并排打开 Designer 样本 + 你的第 1、2 个补全
+1. 并排打开 Artist 样本 + 你的第 1、2 个补全
 2. 逐维度对比（色调 / 光影 / 边缘 / 质感）
 3. 给整体打分（1–5）
 4. 写入 ta-log.md 的 Micro-Batch Validation 表
@@ -120,7 +120,7 @@ playcraft tools generate-image \
 
 ```bash
 # 问题：色调偏差（最常见）
-# 调整：加强 reference-image 权重（多加一张已通过自检的 Designer 样本）
+# 调整：加强 reference-image 权重（多加一张已通过自检的 Artist 样本）
 playcraft tools generate-image \
   --reference-image assets/images/storyboard/master_composite_option_[X].png \
   --reference-image <asr-crop-or-icp-reference>.png
@@ -185,9 +185,9 @@ cp .claude/skills/playcraft-image-generation/reference/compare-style.template.mj
    ta-workspace/scripts/compare-style.mjs
 
 # 2. 编辑 CONFIG 区域（约 30 秒）：
-#    referenceImage: 你的 Designer 样本路径
+#    referenceImage: 你的 Artist 样本路径
 #    targetDir:      你的 TA 补全素材目录
-#    excludeKeywords: 排除 Designer 样本自身（避免自比）
+#    excludeKeywords: 排除 Artist 样本自身（避免自比）
 
 # 3. 运行
 node ta-workspace/scripts/compare-style.mjs
@@ -215,7 +215,7 @@ node ta-workspace/scripts/compare-style.mjs
   检查文件数: 2
   平均评分:   3.0 / 5
   低于阈值数: 1（阈值 3.0）
-  ⚠️  建议：停止低分文件类型的批量生产，调整生成参数或向 Designer 提问 ICP
+  ⚠️  建议：停止低分文件类型的批量生产，调整生成参数或向 Artist 提问 ICP
 ```
 
 **评分标准（与 §3 Micro-Batch Validation 对齐）**：
@@ -226,7 +226,7 @@ node ta-workspace/scripts/compare-style.mjs
 | 4        | < 20°    | < 0.15        | 4            | 继续批量生产               |
 | 3        | < 30°    | < 0.20        | 3            | 勉强可接受，调整参数后继续 |
 | 2        | < 45°    | < 0.30        | 2            | 停止，调整 prompt 后重试   |
-| 1        | ≥ 45°    | ≥ 0.30        | 1            | 停止，向 Designer 提问 ICP |
+| 1        | ≥ 45°    | ≥ 0.30        | 1            | 停止，向 Artist 提问 ICP   |
 
 > **注意**：脚本基于 `playcraft image info` 的 dominant colors 做色相分析，是色彩维度的客观辅助，不能替代 §3 的整体视觉评估（边缘处理、质感特征等维度需人工判断）。
 
@@ -236,35 +236,35 @@ node ta-workspace/scripts/compare-style.mjs
 
 **原则**：提问必须具体，必须引用文件路径和具体 atom，不能用"风格不对"这种模糊描述。
 
-### TA → Designer 提问格式
+### TA → Artist 提问格式
 
 ```markdown
-| #   | From | To       | Atom/Topic           | Question                                                                                                                                                                                                                        | Raised At  | Status |
-| --- | ---- | -------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ------ |
-| 1   | TA   | Designer | tile_atom / 边缘风格 | `logs/designer-log.md` Style Intent Notes 中 tile_sample_1.png 的描述是 "soft edges"，但 tile_sample_2.png 的 Anti-Pattern Notes 中写 "avoid blurry edges"。两者相互矛盾——请问边缘应该是柔化过渡（anti-aliasing）还是清晰硬边？ | production | open   |
+| #   | From | To     | Atom/Topic           | Question                                                                                                                                                                                                                      | Raised At  | Status |
+| --- | ---- | ------ | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ------ |
+| 1   | TA   | Artist | tile_atom / 边缘风格 | `logs/artist-log.md` Style Intent Notes 中 tile_sample_1.png 的描述是 "soft edges"，但 tile_sample_2.png 的 Anti-Pattern Notes 中写 "avoid blurry edges"。两者相互矛盾——请问边缘应该是柔化过渡（anti-aliasing）还是清晰硬边？ | production | open   |
 ```
 
-### TA → PM 提问格式（故事板与 layout-spec 冲突）
+### TA → Game Designer 提问格式（故事板与 layout-spec 冲突）
 
 ```markdown
-| #   | From | To  | Atom/Topic             | Question                                                                                                                                                                                                                                      | Raised At  | Status |
-| --- | ---- | --- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ------ |
-| 1   | TA   | PM  | bg_atom / EndCard 背景 | `assets/images/storyboard/storyboard_confirmed.png` EndCard 帧（右下）显示背景为深蓝色夜景，但 `docs/layout-spec.md` zones.endcard.background 注释写的是"白色/浅色背景以突出 CTA 按钮"。请裁决：以故事板色调为准还是以 layout-spec 注释为准？ | production | open   |
+| #   | From | To            | Atom/Topic             | Question                                                                                                                                                                                                                                      | Raised At  | Status |
+| --- | ---- | ------------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ------ |
+| 1   | TA   | Game Designer | bg_atom / EndCard 背景 | `assets/images/storyboard/storyboard_confirmed.png` EndCard 帧（右下）显示背景为深蓝色夜景，但 `docs/layout-spec.md` zones.endcard.background 注释写的是"白色/浅色背景以突出 CTA 按钮"。请裁决：以故事板色调为准还是以 layout-spec 注释为准？ | production | open   |
 ```
 
-### Designer → TA 回答格式
+### Artist → TA 回答格式
 
 回答时直接在表格 Status 改为 `answered`，并在同行末尾加 `| Answer |`：
 
 ```markdown
-| 1 | TA | Designer | ... | ... | ... | answered | tile_sample_1.png 的 "soft edges" 指 anti-aliasing（无描边）；tile_sample_2.png 的 "avoid blurry edges" 是指不要过度模糊失去形状，两者不冲突。统一结论：无描边，边缘使用 2px anti-aliasing，保持形状清晰。 |
+| 1 | TA | Artist | ... | ... | ... | answered | tile_sample_1.png 的 "soft edges" 指 anti-aliasing（无描边）；tile_sample_2.png 的 "avoid blurry edges" 是指不要过度模糊失去形状，两者不冲突。统一结论：无描边，边缘使用 2px anti-aliasing，保持形状清晰。 |
 ```
 
 ### 常见可问题类型速查
 
-| 疑问类型                       | 提问 Target | 示例提问                                                               |
-| ------------------------------ | ----------- | ---------------------------------------------------------------------- |
-| Style Intent Notes 描述矛盾    | Designer    | "XXX 样本的描述 A 和描述 B 相互矛盾，请澄清..."                        |
-| 故事板帧与 layout-spec 冲突    | PM          | "故事板第 N 帧显示 X，但 layout-spec 写 Y，以谁为准？"                 |
-| Micro-Batch Score < 3 无法提升 | Designer    | "尝试了 3 种参数组合，score 无法超过 3，需要新的 Style Intent 指导..." |
-| 素材类型无 Designer 样本       | Designer    | "atom-plan 中 XXX 类型缺少样本，TA 无法生成对应参考，请提供或指导..."  |
+| 疑问类型                       | 提问 Target   | 示例提问                                                               |
+| ------------------------------ | ------------- | ---------------------------------------------------------------------- |
+| Style Intent Notes 描述矛盾    | Artist        | "XXX 样本的描述 A 和描述 B 相互矛盾，请澄清..."                        |
+| 故事板帧与 layout-spec 冲突    | Game Designer | "故事板第 N 帧显示 X，但 layout-spec 写 Y，以谁为准？"                 |
+| Micro-Batch Score < 3 无法提升 | Artist        | "尝试了 3 种参数组合，score 无法超过 3，需要新的 Style Intent 指导..." |
+| 素材类型无 Artist 样本         | Artist        | "atom-tree 中 XXX 类型缺少样本，TA 无法生成对应参考，请提供或指导..."  |