画板艺术工具

面向个人的协作画布艺术发布工具，支持像素画作。Use when 需要提升效率、自动化流程、批量处理、工作流优化时使用。不适用于需要人工创意判断的任务。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互，无需复杂配置即开即用。输出结果可直接使用，减少二次加工成本。提供结构化输出和错误处理机制。

核心功能: 本技能提供中文交互、化流程等能力。

画板艺术工具（免费版）

概述

本工具帮助个人用户在共享协作画布上发布像素艺术作品，覆盖作品发布、画布查看与定位、颜色与坐标管理、个人发布历史。适合个人单作品创作与发布。

核心能力

能力	说明	免费版范围
作品发布	像素画发布到画布	单作品
画布查看	查看画布与定位作品	只读
颜色坐标	颜色与坐标管理	基础
发布历史	个人作品历史	个人
技术实现要点：核心能力基于input_params参数与output_format配置实现,支持创建/查询/修改/删除等操作模式,通过config_options进行运行时配置。

核心功能执行

用input_params参数进行配置。

输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：面向个人的协作画、布艺术发布工具、支持像素画作、面向个人用户的协、作画布艺术发布工等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：发布像素画作

bash

# 发布作品到画布（免费版）
{baseDir}/scripts/board.sh publish \
  --board main \
  --x 100 --y 200 \
  --art ./my-art.json

json

{
  "name": "小猫",
  "size": {"w": 16, "h": 16},
  "pixels": [
    {"x": 0, "y": 0, "color": "#000000"},
    {"x": 1, "y": 0, "color": "#FFA500"}
  ]
}

场景二：查看画布与定位

bash

# 查看画布概览
sh view --board main

# 定位我的作品
sh locate --board main --mine

场景三：个人发布历史

bash

# 本技能的核心实现逻辑
# 请参考上方使用说明进行配置和调用
echo "implementation_ready"

不适用场景

以下场景画板艺术工具不适合处理：

• 实际人员绩效评估
• 财务预算审批
• 合同法务审核

触发条件

需要项目管理、任务规划、进度跟踪、团队协作时使用。不适用于非本工具能力范围的需求。

快速开始

1. 准备像素画 JSON（坐标 + 颜色）。
2. 选择画布与发布坐标。
3. 执行 publish 发布。
4. 用 view/locate 查看与定位。

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

示例

像素画 JSON 结构：

字段	说明
name	作品名
size	宽高（像素）
pixels	坐标与颜色数组
color	十六进制颜色

优选实践

• 坐标别重叠：发布前查画布占用，避免覆盖他人作品。
• 颜色用十六进制：统一 #RRGGBB 格式，避免解析歧义。
• 小作品先试：先用 16x16 小作品验证流程，再做大画。
• 历史常备份：个人作品历史定期导出备份。
• 尊重他人区域：发布在空闲区，别覆盖他人作品。

常见问题

Q1：能批量发布多作品吗？ A：不能。批量发布与画布治理为专业版能力。

Q2：发布能撤销吗？ A：免费版支持删除自己的作品，但已发布像素需手动清除。

Q3：画布大小有限吗？ A：画布有边界，超出坐标会失败，发布前确认范围。

Q4：免费版支持动画吗？ A：不支持。多帧动画与定时发布为专业版能力。

Q5：颜色数量有限制吗？ A：免费版单作品颜色无硬限，但建议控制在调色板范围。

进阶用法

像素画 JSON 完整结构

json

{
  "name": "小猫",
  "author": "my-handle",
  "size": {"w": 16, "h": 16},
  "palette": ["#000000", "#FFA500", "#FFFFFF", "#FFC0CB"],
  "pixels": [
    {"x": 0, "y": 0, "color": "#000000"},
    {"x": 1, "y": 0, "color": "#FFA500"},
    {"x": 2, "y": 1, "color": "#FFFFFF"}
  ],
  "created_at": "2026-07-18"
}

坐标规划

text

坐标规划原则:
  - 发布前查看画布占用（view 命令）
  - 选空闲区域，避免覆盖他人作品
  - 大作品预留周边缓冲，避免拥挤
  - 记录自己的作品坐标，便于定位

坐标查询:
sh view --board main --region 100,100,200,200

颜色调色板管理

text

调色板建议:
  - 限制在 8-16 色，提升一致性
  - 用调色板索引而非随意颜色
  - 相近色用于渐变，对比色用于强调
  - 导出时记录调色板，便于复用

发布历史与备份

bash

# 查看我的发布历史

# 导出我的作品备份
sh export --mine --out my-artworks.tar.gz

创作规范

• 坐标不重叠：发布前查占用，避免覆盖他人作品。
• 颜色统一格式：用 #RRGGBB，避免解析歧义。
• 小作品先试：16x16 验证流程，再做大画。
• 历史常备份：个人作品定期导出备份。

画布礼仪

• 不覆盖他人：发布前确认坐标空闲。
• 不占大块：个人作品别占用过大画布区域。
• 可删除自己：可删除自己的作品，但已发布像素需手动清。
• 友好互动：可在作品旁留署名，便于他人联系。
• 遵守社区规则：遵守画布社区的内容规范。

依赖说明

运行环境

• Agent 平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
• 操作系统: Windows / macOS / Linux
• 网络: 可访问画布服务端点

依赖详情

依赖项	类型	是否必需	获取方式
curl	命令行工具	必需	系统包管理器
jq	JSON 处理	推荐	系统包管理器
LLM API	API	必需	由 Agent 内置 LLM 提供

API Key 配置

• 发布需画布服务访问令牌，建议存环境变量
• 令牌仅用于画布服务鉴权，不要泄露

可用性分类

• 分类: MD+EXEC（Markdown 指令 + 命令行执行）
• 说明: 通过自然语言指令驱动 Agent 调用画布 API 发布作品

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

已知限制

• 需LLM支持,无LLM环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响
• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

安全注意事项

风险类型	防范措施
API密钥泄露	通过环境变量配置，禁止硬编码到代码或配置文件中
命令执行风险	仅执行白名单命令，避免拼接用户输入到命令行参数中
网络通信安全	使用HTTPS协议，验证SSL证书有效性
敏感数据暴露	输出结果中不包含密钥、令牌等敏感信息

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。