codereadr-automation

codereadr-automation skill 概览

codereadr-automation 适合用来做什么

codereadr-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 自动化 Codereadr 操作。它面向需要调用当前 Codereadr toolkit tools 的 agent，而不是让 agent 凭记忆猜测 API 结构。

它的核心价值不是提供一段固定的工作流脚本，而是教会 agent 先用 RUBE_SEARCH_TOOLS 发现可用的 Codereadr tools，确认 Codereadr 连接处于可用状态，然后根据 Rube 返回的最新 schema 执行正确的 tool。

最适合的用户和工作流

如果你在条形码、二维码、扫码、校验、签到、资产管理或现场数据采集等流程中使用 Codereadr，并希望 AI agent 能在聊天或自动化环境里协助操作已连接的 Codereadr actions，那么这个 codereadr-automation skill 会很合适。

当任务依赖实时 tool schema、连接状态或由 Composio 管理的认证时，它尤其有用。与其写出“update my Codereadr data”这类脆弱提示，不如要求 agent 针对具体的 Codereadr 任务发现 tools、检查必填字段，然后再执行。

这个 skill 的不同之处

它的关键差异在于“先搜索 tools”的模式。很多自动化提示会失败，是因为它们假定了某个 tool 名称、参数或 API 版本。codereadr-automation 明确要求 agent 在执行前先调用 RUBE_SEARCH_TOOLS，再使用返回的 tool slugs、schemas、execution plan 和 pitfalls。

因此，对于基于 MCP 的 Workflow Automation，它比静态的 Codereadr prompt 更可靠，尤其是在 Composio 调整可用 actions 或字段要求时。

如何使用 codereadr-automation skill

codereadr-automation 安装与配置上下文

从 Composio skills repository 安装该 skill：

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

然后在你的 AI client 中添加 Rube MCP：

https://rube.app/mcp

该 skill 需要 rube MCP server，并假定 RUBE_SEARCH_TOOLS 可用。在运行 Codereadr actions 之前，请使用 Rube connection manager 检查 toolkit codereadr；如果连接状态不是 ACTIVE，请完成返回的 auth flow。

建议先做以下基础检查：

• 确认 RUBE_SEARCH_TOOLS 有响应。
• 按你的目标用例搜索 Codereadr tools。
• 检查 Codereadr connection status。
• 只有在 schema 和连接状态都明确后再执行。

你需要提供哪些输入

为了更好地使用 codereadr-automation，请向 agent 说明操作目标、涉及的 Codereadr 对象或流程、预期范围以及安全边界。较弱的请求是：

“Do the Codereadr update.”

更好的请求是：

“Use codereadr-automation to find the current Composio Codereadr tools for exporting scan records from yesterday. First discover the tool schema, confirm the Codereadr connection is active, show me required fields, then run the export only for scans created between 2026-07-10 00:00 and 2026-07-10 23:59 UTC.”

这样能提升结果质量，因为 agent 可以先搜索正确的 tool，避免臆测字段名，并在执行前限制操作范围。

首次运行的推荐流程

先阅读 SKILL.md；它是该 skill 中唯一的源文件，包含必需的 MCP 使用模式。仓库中没有附带脚本、引用材料或辅助规则可供检查，所以关键行为都集中在 tool-discovery sequence 中。

安全的首次流程可以是：

1. 要求 agent 使用具体的 Codereadr 用例调用 RUBE_SEARCH_TOOLS。
2. 查看返回的 tool slugs 和 schemas。
3. 要求 agent 通过 Rube 验证 Codereadr 连接。
4. 补充缺失的 IDs、日期范围、过滤条件或 payload 字段。
5. 在任何写入操作前，要求 agent 提供 dry-run-style summary。
6. 只使用当前 schema 执行选定的 tool。

提升结果质量的 prompt 写法

使用能强制发现和确认的 prompt：

“Use the codereadr-automation skill for Workflow Automation. Search Rube tools for: [specific Codereadr task]. Do not call an execution tool until you have shown the tool slug, required fields, connection status, and any risks. If required fields are missing, ask me instead of inventing values.”

这种模式适用于导入、导出、记录查询、报表生成、scan-data actions，或 Codereadr 管理类任务；在这些场景中，错误的过滤条件或猜测出来的 IDs 可能影响生产数据。

codereadr-automation skill 常见问题

没有 Rube MCP，codereadr-automation 还能用吗？

不能。该 skill 依赖 Rube MCP 和 Composio Codereadr toolkit。如果你的 client 无法连接到 https://rube.app/mcp，或者无法暴露 RUBE_SEARCH_TOOLS，这个 skill 就无法完成它的核心功能。

它仍然可以说明预期工作流，但无法发现实时的 Codereadr schemas，也无法执行 actions。

它比普通 Codereadr prompt 好在哪里？

普通 prompt 可能会幻觉出不存在的 API 字段或 tool 名称。codereadr-automation 会要求 agent 先发现当前可用的 tools，使用返回的 schema，并在执行前检查连接状态。这是安装它的主要理由。

代价是多一个 discovery 步骤，但这个步骤通常能避免自动化工作流中代价更高的失败。

新手适合使用吗？

适合，前提是你能够连接 MCP server 并完成 auth flow。这个 skill 的流程很简单：连接 Rube、激活 Codereadr、搜索 tools，然后运行选定的 action。

新手应先从只读或低风险任务开始，例如查找可用的 Codereadr tools 或预览必填字段，再尝试更新、导入或删除操作。

什么时候不该使用这个 skill？

如果你需要离线 Codereadr 文档、直接的 API SDK 代码，或一个完整预构建的业务工作流，就不应使用它。这个 repository 提供的是精简的 agent instruction，而不是完整应用。

也应避免用它处理含糊的生产变更。如果你无法说明过滤条件、IDs、日期范围或目标记录，agent 应该暂停并要求澄清。

如何改进 codereadr-automation skill

用约束改进 codereadr-automation prompts

最大的质量提升来自清晰的约束。请包含 action type、目标记录、日期/时间窗口、环境，以及是否允许写入。

更好的输入示例：

“Find Codereadr tools for listing scan records for event EVT-123. Use read-only actions only. If the tool requires a service ID, campaign ID, or database ID, ask me before proceeding.”

这样可以避免 agent 把宽泛的 Codereadr 目标理解为可以执行大范围 actions 的授权。

需要留意的常见失败模式

最常见的失败包括跳过 tool discovery、Codereadr 连接未激活、猜测 schemas，以及过滤条件不充分。如果 agent 试图在调用 RUBE_SEARCH_TOOLS 之前直接调用某个 Codereadr tool，请立即纠正。

对于写入操作，请要求 agent 在执行前给出 summary，内容包括：tool slug、必填输入、已使用的可选输入、预期副作用，以及回滚限制。这一点尤其重要，因为该 skill 不包含自定义安全脚本。

根据首次输出继续迭代

完成第一次 tool search 后，根据 Rube 返回的 schema 细化任务。如果发现的 tool 需要你没有提到的字段，请提供精确值，而不是让 agent 自行推断。

一个好的迭代示例是：

“Use the discovered schema. Set start_date to 2026-07-10, end_date to 2026-07-11, filter to status valid, and do not include personally identifiable fields unless required by the tool.”

如果你扩展这个 skill，建议添加什么

如果你维护自己的 fork，可以考虑补充常见 Codereadr 任务示例、只读与写入 action 的操作指引，以及组织内部字段命名说明。当前的 codereadr-automation skill 有意保持精简，因此本地示例可以减少歧义，同时不削弱“先搜索当前 tools”这一核心规则。