Yida Canvas Table Form

What it does

When your agent uses it

• Tasks that involve React components

Example prompts

• “/yida-canvas-table-form”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

1. 1YidaCodeCanvas 组件内没有平台 JSX 组件实例桥：禁止在 YidaComp 源码中直接调用 this.utils.yida.*、this.$(...) 或 this.dataSourceMap；需要宜搭表单写入时消费发布层注入的…
2. 2写入桥必须先验证：默认使用 window.OPENYIDA_YIDA_API.saveFormData/updateFormData，也可使用已验证连接器代理或同源业务桥。必须确认目标…
3. 3未验证不得伪装闭环：桥未配置或未验证时，提交按钮禁用或进入清晰的“待接入”状态；不得模拟成功、生成假 formInstId 或宣称数据已写入宜搭。
4. 4提交前先验证并确认：先完成行级校验，再向用户展示待提交行数和关键字段摘要，获得确认后发起写入。
5. 5分批并发而非无限并发：按固定批次切分，批次内使用 Promise.all 并发，批次间顺序推进；不得逐行串行，也不得一次性无限并发。
6. 6失败行必须保留：每行保存 _status、_errors 和 _submitError；部分失败后只重试失败行，成功行不能重复提交。
7. 7真实交付要发布证据：创建或修改 .canvas.jsx / .canvas.tsx 页面源码后，只有 openyida publish 成功才能声明页面已发布。
8. 8页面表面跟随应用主题：YidaCodeCanvas 下生成页面的根画布使用 min-height: 100vh，背景使用 var(--pod-page-bg-color, var(--color-white, #fff))；表格面板使用当前应用主题中的…

What it can do on your machine

Read from SKILL.md and the folder at commit 4932d0b. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md (its code samples are javascript and bash).

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Yida Canvas Table Form loads about 1.3k tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 201 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~72

When it runs · the whole SKILL.md, loaded when a task matches

~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from openyida/openyida at commit 4932d0b, republished under its MIT licence (© openyida). 201 words, ~1,307 tokens.

name

yida-canvas-table-form

description

自定义页面表格批量录入技能。使用 `YidaCodeCanvas` 组件和 antd Table、Input、Select、DatePicker、React hooks 实现草稿、行级校验、分批并发提交和行级错误保留。`YidaCodeCanvas` 组件内不能直接调用 this.utils.yida.*；写入默认消费发布层注入的 window.__OPENYIDA_YIDA_API__，提示、跳转等根级工具消费 window.__OPENYIDA_UTILS__，也可走已验证连接器或同源业务桥，未验证时不得声称提交闭环。

const writeBridge = {
  verified: true,
  name: 'same-origin-form-write-v1',
  async saveRow(payload, context) {
    // context: { rowId, idempotencyKey }
    // 调用已验证的同源接口或连接器代理
    return { formInstId: '真实接口返回值' };
  },
};

{
  _rowId: 'row_...',
  _status: 'draft', // draft | invalid | submitting | submitted | failed
  _errors: {},
  _submitError: '',
  fieldId_name: '',
  selectField_status: '',
  dateField_dueAt: ''
}

async function submitInBatches(rows, writeBridge, batchSize) {
  const results = [];
  for (let index = 0; index < rows.length; index += batchSize) {
    const batch = rows.slice(index, index + batchSize);
    const batchResults = await Promise.all(batch.map(async (row) => {
      try {
        const value = await writeBridge.saveRow(toPayload(row), {
          rowId: row._rowId,
          idempotencyKey: 'canvas-table:' + row._rowId,
        });
        return { rowId: row._rowId, ok: true, value };
      } catch (error) {
        return { rowId: row._rowId, ok: false, error: error.message || '提交失败' };
      }
    }));
    results.push(...batchResults);
  }
  return results;
}

# 1. 取得真实字段 ID
openyida get-schema <appType> <formUuid> --field-map-json

# 2. 编写表格批量录入页面

# 3. 接入并验证 window.__OPENYIDA_YIDA_API__ / 连接器 / 数据桥
# 未验证前保持 writeBridge.verified !== true

# 4. 本地快检
openyida compile project/pages/src/table-form-batch-submit.canvas.jsx --json

# 5. 真实交付时发布
openyida publish project/pages/src/table-form-batch-submit.canvas.jsx <appType> <displayPageFormUuid>

© openyida, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in yida-skills/skills/yida-canvas-table-form of openyida/openyida.

Open the folder on GitHubat commit 4932d0b