canvas-automation

canvas-automation skill 概览

canvas-automation 能做什么

canvas-automation skill 帮助 AI agent 通过 Composio 的 Canvas toolkit，并借助 Rube MCP 自动执行 Canvas LMS 相关任务。它的核心价值不是提供一段固定的 Canvas 脚本，而是指导 agent 先发现当前可用的 Canvas tool schema，确认用户的 Canvas 连接状态，然后再通过 MCP 执行合适的 Canvas 操作。

当你希望 Claude 风格的 agent 以“理解工具”的方式与 Canvas 交互，而不是凭空猜测 API endpoint、参数或对象名称时，就适合使用这个 skill。

最适合的用户与任务

canvas-automation 适合已经在使用支持 MCP 的客户端，并希望获得 Canvas 工作流自动化辅助的教师、教学设计人员、课程运营团队和开发者。常见任务包括查找可用的 Canvas action、准备课程管理工作流、检查连接状态，以及在完成认证后执行 Canvas 操作。

如果你的 Canvas 任务依赖实时的 Composio toolkit schema，这个 skill 尤其有用，因为它明确要求在执行前先进行 tool discovery。

核心差异点

它最实用的差异点是“先搜索工具”的模式。skill 不会假设 API 结构固定不变，而是要求 agent 调用 RUBE_SEARCH_TOOLS，获取当前 Canvas schema、可用 tool slug、推荐执行方案和潜在坑点。相比让 AI 在没有检查实际可用工具的情况下直接“update Canvas”的普通提示词，canvas-automation skill 在工作流自动化场景中更安全。

采用前需要注意的限制

这个 skill 需要 Rube MCP，并且需要通过 RUBE_MANAGE_CONNECTIONS 建立 toolkit 为 canvas 的有效 Canvas 连接。如果你的 AI 客户端不能使用 MCP tools，或者你无法授权 Canvas 连接，这个 skill 就无法执行真实的 Canvas 操作。仓库路径中只有 SKILL.md，因此它的安装价值主要来自工作流说明，而不是随附脚本或参考资源。

如何使用 canvas-automation skill

canvas-automation 安装环境

在兼容的 skills 环境中安装该 skill，例如：

npx skills add ComposioHQ/awesome-claude-skills --skill canvas-automation

然后在你的客户端中配置 Rube MCP，添加 MCP server endpoint：

https://rube.app/mcp

在期待 Canvas 自动化正常工作之前，先确认 agent 可以调用 RUBE_SEARCH_TOOLS。然后使用 toolkit 为 canvas 的 RUBE_MANAGE_CONNECTIONS，如果连接状态不是 ACTIVE，就完成返回的认证流程。

skill 需要哪些输入

想获得更可靠的 canvas-automation usage 效果，请给 agent 提供：

• 你希望完成的 Canvas 任务，例如“列出这门课的 assignments”或“创建一条 announcement”
• 如果你知道的话，提供 course、assignment、user、module 或 section 标识符
• 说明任务只是查看数据，还是需要进行修改
• 所需文案、日期、可见性规则或评分限制
• 明确要求在执行前先搜索 Rube tools

较弱的提示是：“Fix my Canvas course.”
更好的提示是：“Use canvas-automation to find the current Canvas tools through RUBE_SEARCH_TOOLS, verify the Canvas connection, then identify what information you need to publish an announcement in course ID 12345. Do not publish until I approve the final text.”

获得可靠结果的推荐工作流

一份实用的 canvas-automation guide 应按以下顺序执行：

1. 要求 agent 针对具体 Canvas 用例调用 RUBE_SEARCH_TOOLS。
2. 使用 RUBE_MANAGE_CONNECTIONS 确认 Canvas toolkit 连接为 ACTIVE。
3. 让 agent 说明已发现的 tool、必填字段和计划执行的 action。
4. 补充缺失的 ID、名称、日期或内容。
5. 在可能的情况下，先执行只读发现操作。
6. 在执行任何写入操作前先获得批准。
7. 要求 agent 总结已变更内容，以及仍需人工复核的事项。

这种模式可以减少 schema 错误，也有助于避免误更新到错误的课程。

优先阅读的仓库文件

先阅读 composio-skills/canvas-automation/SKILL.md。它包含实际可用的说明：前置条件、设置步骤、tool discovery，以及核心工作流模式。提供的文件树中没有单独的 README.md、scripts/、resources/ 或 references/ 文件夹，因此不要期待它是一个大型实现包。应将这个 skill 视为围绕 Rube MCP 和 Composio Canvas toolkit 的操作型封装。

canvas-automation skill 常见问题

canvas-automation 更适合工作流自动化还是 Canvas API 开发？

更准确的定位是 canvas-automation for Workflow Automation。这个 skill 的设计目标是帮助 agent 通过 Rube MCP 发现并运行 Canvas 相关工具。它不是完整的 Canvas API SDK，不是迁移框架，也不是用于自定义后端开发的库。

它比普通提示词好在哪里？

普通提示词可能会编造 Canvas 字段，或假设已经过时的 schema。canvas-automation skill 会要求 agent 先调用 RUBE_SEARCH_TOOLS，这样在执行前就能看到当前 tool name、input schema 和执行建议。这正是它在安全性和可靠性上的关键提升。

初学者可以使用这个 skill 吗？

可以，只要能够设置 MCP 并完成 Canvas 授权流程。初学者应先从只读任务开始，例如列出 courses 或检查可用的 assignment tools，再让 agent 创建、更新或删除 Canvas 内容。

什么时候不应该使用 canvas-automation？

如果你只需要离线规划 Canvas 内容、你的组织阻止第三方 Canvas 连接，或者你的 AI 客户端无法调用 MCP tools，就不应使用它。对于高风险的批量变更，也应避免直接使用，除非你增加明确的审批节点，并验证受影响的 course ID。

如何改进 canvas-automation skill

用精确范围改进 canvas-automation 提示词

提升 canvas-automation 结果最快的方法，是在 agent 搜索工具前先定义清楚范围。请包含目标 course、对象类型、期望 action，以及操作是只读还是允许写入。

更好的提示模式：

“Use canvas-automation to discover the current Canvas tools for updating assignment due dates. Check the Canvas connection first. Target course ID 12345. I want a plan and required fields before any update. Ask for approval before writing changes.”

这样 agent 就有足够上下文来搜索正确的 tool，并避免过早执行。

减少常见失败模式

常见失败包括缺少 Canvas 认证、基于过时假设理解 tool schema、课程名称含糊不清，以及不安全的写入操作。可以通过要求 agent 执行以下动作来预防：

• 针对具体用例搜索 tools，而不是只发起宽泛的 “Canvas operations” 查询
• 确认 canvas 连接为 ACTIVE
• 在执行前展示必填字段
• 在可能的情况下优先使用 ID，而不是人类可读名称
• 将规划、预览、审批和执行分开

这些步骤很重要，因为 Canvas 自动化经常会影响真实课程内容。

根据首次输出继续迭代

拿到第一次 tool discovery 结果后，让 agent 根据返回的 schema 细化计划。有效的后续指令包括：

• “Map my available information to the required fields.”
• “Tell me which fields are missing before calling the write tool.”
• “Run a read-only lookup first to verify the course and assignment.”
• “Prepare the final action payload for approval.”

这会把 tool discovery 转化为可控的执行计划。

为团队补充本地操作规则

团队可以在 upstream 文件之外添加本地约定，进一步改进 canvas-automation skill：例如发布前审批要求、module 命名规则、课程编辑禁用日期，以及破坏性操作的升级规则。upstream skill 有意保持精简，因此本地策略才是让它更适合机构级 Canvas 工作流的关键。