mcpField
I
iii-low-code-automation

iii-low-code-automation

github.com/iii-hq开发219 次安装
代码仓库

关于 iii-low-code-automation

用于在 iii 引擎中通过小型注册函数构建低代码自动化链的技能，涵盖 HTTP 和 cron 触发器、基于队列的步骤及 PubSub 完成事件。

主要功能

  1. 01通过命名队列串联函数
  2. 02使用 HTTP 或 cron 触发流程
  3. 03在步骤间持久化数据
  4. 04通过 PubSub 发布完成事件

适用场景

  1. 01处理表单提交并发送通知
  2. 02按计划聚合 RSS 源
  3. 03验证支付 Webhook 并更新订单

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/iii-hq/skills --skill iii-low-code-automation

安装后在 Claude Code 中输入/iii-low-code-automation确认已加载。

详细介绍

低代码自动化链

可对标：n8n、Zapier、LangFlow

核心概念

在适合任务的情况下使用以下概念。并非每种自动化都需要全部概念。

  • 自动化中的每个“节点”都是一个已注册的小型函数，且只负责一项工作
  • 节点通过命名队列使用 TriggerAction.Enqueue 串联，便于添加、移除或重新排序步骤
  • HTTP 触发器接收外部 Webhook（表单提交、支付事件）
  • Cron 触发器启动定时自动化（每日摘要、定期同步）
  • PubSub广播完成事件，供下游监听器接收

架构

Automation 1: Form → Enrich → Store → Notify
  HTTP webhook → auto::enrich-lead → auto::store-lead → auto::notify-slack

Automation 2: Cron → Fetch → Transform → Store
  Cron (daily) → auto::fetch-rss → auto::transform-articles → auto::store-articles

Automation 3: Payment webhook → Validate → Update → Notify
  HTTP webhook → auto::validate-payment → auto::update-order → publish(payment.processed)

iii 使用的原语

原语用途
registerWorker初始化 Worker 并连接到 iii
registerFunction定义每个自动化节点
trigger({ ..., action: TriggerAction.Enqueue({ queue }) })通过命名队列串联节点
trigger({ function_id: 'state::set', payload })在节点之间持久化数据
trigger({ ..., action: TriggerAction.Void() })发送即发即弃通知
registerTrigger({ type: 'http' })Webhook 入口点
registerTrigger({ type: 'cron' })定时自动化

参考实现

完整可运行示例见 ../references/low-code-automation.js——其中包含三条自动化链： 表单到 Slack 通知、RSS 源聚合，以及支付 Webhook 处理。

常见模式

在适用情况下，采用此模式的代码通常包含：

  • registerWorker(url, { workerName }) — 初始化 Worker
  • trigger({ function_id, payload, action: TriggerAction.Enqueue({ queue: 'automation' }) }) — 串联节点
  • 每个节点都使用独立的 registerFunction，ID 以 auto:: 为前缀
  • 小巧、专注且只做一件事的函数（补充信息、验证、存储、通知）
  • trigger({ function_id: 'state::set', payload: { scope, key, value } }) — 在节点之间持久化数据
  • const logger = new Logger() — 为每个节点进行结构化日志记录

调整此模式

在适用于任务的情况下使用以下调整方式。

  • 注册 HTTP/Cron 触发器并串联函数，以添加新的自动化链
  • 每个节点都应可独立测试——接收输入并生成输出
  • 如果不同链需要不同的重试或并发设置，请使用不同的队列名称
  • 对于不可靠的外部服务，用 try/catch 包装调用并明确处理失败
  • 保持节点函数简短——将复杂逻辑交给专用函数处理

模式边界

  • 如果任务需要具备 Saga 补偿和步骤跟踪功能的持久化多步骤工作流，请优先选择 iii-workflow-orchestration。
  • 如果任务涉及多个 AI Agent 交接工作，请优先选择 iii-agentic-backend。
  • 如果主要需求是简单的触发器-转换-操作链，且编排开销极低，请使用 iii-low-code-automation。

适用场景

  • 当任务主要涉及 iii 引擎中的 iii-low-code-automation 时，使用此技能。
  • 当请求直接要求使用此模式或等效实现时，触发此技能。

边界

  • 切勿将此技能用作无关任务的通用兜底方案。
  • 如果有更具体的 iii 技能更适合，切勿使用此技能。
  • 使用此技能中的示例前，务必先核实环境和安全限制。

评论

支持 Markdown