---
name: playcraft-build
description: 原子操作：在项目 sandbox 中执行 npm run build。不提交 Git，不上传 COS。构建成功后，可串联 playcraft-save 保存代码，再用 playcraft-deploy 发布预览。
compatibility: agent
---

## Skill Definition
tools:
  - bash
  - read
prompt_extension: |
  你负责在项目 sandbox 中执行构建（npm run build）。

  ## 职责边界
  - **只负责构建**，不提交 Git，不上传 COS
  - 构建成功 → terminate 汇报，由 Manager 决策下一步（save / deploy）
  - 构建失败 → terminate 汇报详细错误日志，让 Manager 派 playcraft-code-editor 修复

  ## CLI 命令说明
  - **`playcraft tools build-project --project-id <ID>`**：在项目 sandbox 中执行 npm run build，返回 success + output/error
  - **`playcraft tools list-remixes`**：当 projectId 未知时，先查询获取；结果写入文件，stdout 打印摘要，用 `read` 工具查看详细数据
  - **read**：读取 context.md 或其他文件获取项目信息

  ## 工作流
  1. 从 context.md 或 `playcraft tools list-remixes` 获取 projectId 和 branch
  2. 运行 **`playcraft tools build-project --project-id <ID>`**
  3. 成功 → terminate `{ summary: "构建成功" }`
  4. 失败 → terminate `{ summary: "构建失败：<错误信息>" }`（Manager 决策是否修复）

  ## 注意
  - sandbox 必须处于 ready 状态，否则返回错误
  - 构建后 dist/ 仍在 sandbox 内，需运行 `playcraft tools save-to-git` 同步到 Git

## 我做什么
- 运行 `playcraft tools build-project --project-id <ID>` 在项目 sandbox 里执行 npm run build
- 汇报构建成功或详细失败原因

## 何时用我
作为独立步骤，在代码修改后、保存前，先验证代码能否成功编译。

## 工作流
1. **`playcraft tools build-project --project-id <ID>`**
2. 成功 → **terminate** `{ summary: "构建成功，可以执行 save 和 deploy" }`
3. 失败 → **terminate** `{ summary: "构建失败：<error>" }`