# Canvas Public Chat

> 定义 JarvisHub agents chat 运行时协作原则：web 收集上下文，hono-api 注入硬约束，agents 自主决策，skills 提供方法论。此 skill 只负责协作原则，不负责重新定义 JarvisHub `/public/*` API 或 canvas 工具 schema；真实请求统一使用当前 harness 暴露的工具。

- Skill: `lyl1015/canvas-public-chat` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lyl1015/canvas-public-chat`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lyl1015/canvas-public-chat/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: lyl1015 (https://skillmd.com/u/lyl1015)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lyl1015/canvas-public-chat

---


# JarvisHub Public Chat

注意：
- 本 skill 不是 API 调用器。
- 凡是要实际请求 JarvisHub `/public/*` 接口或 canvas 生成工具，统一使用当前 harness 暴露的工具。
- 不要在这里重新定义 `apiKey`、`apiBaseUrl`、endpoint 映射、工具字段或请求脚本。

## 何时使用

- 用户在 `/public/chat` 或 Web 对话助手里发起多步创作请求
- 任务需要同时理解前端上下文、后端硬约束与 agents 自主编排边界

## 输入证据

- 用户请求与会话上下文
- `chatContext` 中的显式事实
- 项目/flow/node/book/material 等工具结果

## 执行原则

- `web` 只负责收集真实上下文并执行合法 plan
- `hono-api` 只负责权限、协议、事实性、失败策略与审计
- `agents-cli` 主代理负责意图识别、取证规划、技能加载、子代理拆分与结果汇总
- 后端 system prompt 只承载身份、事实 briefing、协议与失败约束；业务方法论以本 skill 及同组 runtime skills 为准
- 对显式、确定性的画布改动请求（如添加空文本节点、重命名节点、连接节点、更新少量已知字段），若当前 `project/flow` 作用域与目标足够明确，优先调用当前可用的窄语义画布工具执行。不要退化成让用户手动操作，也不要直接调用 internal/debug 底层 patch 工具。
- 窄语义结构编辑工具只负责结构性画布改动；图片、故事板、角色图、场景图、视频等媒体生成必须走当前媒体生成能力，不能通过结构编辑创建可执行媒体节点等待宿主 auto-run。
- 删除节点或边时传真实 id；删节点会级联删除关联边，只想断开连线时传真实 edge id。
- 创建节点后还要连线时，先取得创建工具返回的真实 id；`label` 不是 node id。
- 创建分组或调整组内结构时，使用当前分组工具表达“新建空组”或“把已有节点原子入组”的业务意图；运行时按工具结果和 flow graph diff 记录真实副作用。
- `kind=image sequence` 是前端“镜头图片编辑”图片网格，不是镜头脚本容器；若本轮只有逐镜头文本、beat list 或章节拆解而没有镜头图，应创建 `kind=text` 节点，而不是把长段文字塞进 `image sequence` 的 `content/prompt/text`
- 只有在你明确提供 `imageCells`，或用户明确要求“空白镜头图片板/空网格占位”时，才创建 `kind=image sequence`；否则默认视为节点类型选择错误
- 若当前明确选中了 `kind=image` / `imageEdit` 节点，且用户目标是“完善/优化/改写当前图片节点提示词”，先读取 `canvas_node_context_bundle_get` 获取节点现有 `prompt/systemPrompt/negativePrompt`、结果图、上下游与 diagnostics，再决定改写范围；不要只根据选中态猜字段
- 对“优化当前图片节点提示词”这类针对既有节点的确定性修改，优先直接回写当前节点，而不是默认新建平行节点；只有用户明确要求分叉、保留旧版或另起一版时，才创建新节点
- 回写既有图片节点提示词时，优先使用当前节点更新工具，并显式表达需要覆盖的业务字段，避免因已有提示词字段产生冲突。
- `kind=text` 的节点允许为空内容占位；若用户明确要求“空文本节点/空白文本节点”，不要把 `prompt` / `text` 当成必填项
- 对“添加空白文本节点”这类确定性写入，使用当前文本节点工具；空占位时不强行补业务内容。
- SOP、创作方法论、提示词方法、连续性方法都属于 skill，而不是常驻 system prompt
- 事实判断必须来自实时工具结果，不得来自 docs/assets/ai-metadata
- 若本轮没有真实执行、没有真实生成、也没有返回合法 `<canvas_canvas_plan>`，不得写成“已落地”“已完成”

## 输出契约

- 直接回答时，不暴露内部控制字段
- 返回画布结果时，要么成功调用窄语义工具或 direct generate 工具直接写入，要么输出合法 `<canvas_canvas_plan>`
- 证据不足时，明确指出缺失项与下一步需要读取的实时数据