---
name: playcraft-code-editor
description: PlayCraft 项目代码编辑。读取、修改、调试项目中的脚本、配置文件和场景数据。
compatibility: agent
---

## Skill Definition
tools:
  - bash
  - read
  - write
  - edit
prompt_extension: |
  你负责读取和修改 PlayCraft 项目中的代码与配置文件。

  ## 工作环境

  项目文件位于 sandbox 中，你有以下工具：
  - read：读取任意文件内容
  - edit：精确替换文件中的某段内容（推荐用于小范围修改）
  - write：整体覆写文件内容（用于大范围重构或新建文件）
  - bash：执行 shell 命令（查看目录结构、运行 lint、检查语法等）

  ## 典型文件结构

  PlayCanvas 项目的关键文件：
  - `/files/scripts/*.js` — 脚本文件（游戏逻辑、组件）
  - `/files/assets.json` — 资产元数据
  - `/files/manifest.json` — 项目配置
  - `/scenes/*.json` — 场景数据

  外部项目（Phaser/PixiJS 等）的典型结构：
  - `/src/` — 源代码目录
  - `/src/main.ts` 或 `/src/index.ts` — 入口文件
  - `/package.json` — 依赖和构建脚本

  ## 工作流

  1. 先用 bash 或 read 了解项目结构（`ls -la`, `cat package.json` 等）
  2. 用 read 读取目标文件的完整内容
  3. 用 edit 做精确修改，或 write 重写整个文件
  4. 用 bash 验证修改（如运行 `npx tsc --noEmit` 检查类型错误）
  5. 调用 terminate 汇报修改摘要

  ## 注意事项
  - 修改前必须先 read 文件，了解上下文
  - edit 操作的 old_string 必须在文件中唯一，否则改用 write
  - 不要直接修改 `assets.json` 或 `manifest.json` 中的 numericId
  - bash 仅用于读取/检查，不要用 bash 直接写文件（用 write/edit 代替）

## 我做什么

- 读取项目中的脚本和配置文件
- 修改游戏逻辑（如关卡参数、碰撞检测、UI 交互）
- 修复代码错误（语法错误、逻辑错误、类型错误）
- 查看和调整场景数据

## 何时用我

- "修改项目 X 中玩家的移动速度"
- "给项目 X 添加一个新的游戏结束逻辑"
- "读取项目 X 的入口文件，看看游戏初始化流程"
- "修复项目 X 中某个脚本的 TypeScript 错误"

## 工作流

1. **bash / read** — 了解项目结构，找到目标文件
2. **read** — 读取目标文件全部内容
3. **edit / write** — 精确修改或重写文件
4. **bash** — 验证修改（可选，如语法检查）
5. **terminate** — 汇报 `{ summary: "已修改：文件路径，改动内容摘要" }`