Skip to Content
IoT 应用开发使用 Claude Code 构建应用

使用 Claude Code 构建应用

Claude Code 是 Anthropic 推出的 AI 编程智能体。IronFlock 为它发布了一个插件，其中包含 ironflock-templates 技能，让智能体了解应用如何接入 IronFlock。借助该技能，Claude Code 会按照平台期望的方式编写应用 .ironflock/ 目录中的文件，并在您发布版本之前对其进行检查：

文件智能体可以做什么
board-template.yml构建应用的仪表板：选择组件、将组件绑定到您的表、设计页面布局和导航
data-template.yml定义与代码所发布数据相匹配的表和转换
env-template.yml添加应用参数
port-template.yml声明用于远程访问的端口
ai-template.yml定义应用的 AI 智能体及其工具

该插件已在 GitHub 上公开：IronFlock/agent-skills。

技能包含的内容

  • 全部五个模板的 JSON Schema——与发布在 https://ironflock.com/schemas/ 上的完全相同。
  • 仪表板模板指南：数据绑定、过滤器、聚合、页面、导航和布局。
  • 所有仪表板组件的目录，说明每个组件适用于哪类数据。
  • 一个工具，可针对仪表板所用的确切组件版本，读取该组件的配置 Schema。
  • 一个校验器，它会对照各自的 Schema 检查每个模板，并检查平台原本要到安装时才会报告的规则问题——例如组件绑定到了不存在的列。

前提条件

  • Claude Code — 参见 Anthropic 的安装指南。
  • Python 3.9 或更高版本，用于运行校验器。推荐使用 uv：有了它，校验器会自行安装所需的依赖。如果不使用 uv，请运行一次 python3 -m pip install pyyaml jsonschema。
  • 互联网访问，能够连接 registry.npmjs.org 和 cdn.jsdelivr.net，组件 Schema 就发布在这两个地址上。

安装技能

添加 IronFlock 插件市场，然后从中安装插件——既可以在 Claude Code 中操作，也可以在终端中操作：

/plugin marketplace add IronFlock/agent-skills
/plugin install ironflock@ironflock

该插件安装在您的用户账户下，因此 Claude Code 可以在每个项目中使用它。插件会在新会话中加载；在已经运行的会话中，请输入 /reload-plugins。要检查安装情况，请运行 claude plugin list——它会列出 ironflock@ironflock。

保持最新

对于来自第三方插件市场的插件，只有在您开启自动更新后，Claude Code 才会更新它们。只需开启一次：在 Claude Code 中运行 /plugin，打开 Marketplaces，选择 ironflock，然后选择 Enable auto-update。也可以手动更新：

claude plugin marketplace update ironflock
claude plugin update ironflock@ironflock

为团队设置

要让参与应用开发的每个人都能使用该插件，请将以下文件作为 .claude/settings.json 提交到应用的仓库中：

{
  "extraKnownMarketplaces": {
    "ironflock": {
      "source": { "source": "github", "repo": "IronFlock/agent-skills" },
      "autoUpdate": true
    }
  },
  "enabledPlugins": { "ironflock@ironflock": true }
}

团队成员信任该文件夹后，Claude Code 就会应用此文件。

使用技能

您无需手动调用该技能。当您开发 IronFlock 应用时，Claude Code 会自动使用它——例如当您提出以下请求时：

  • “为这个应用添加一个仪表板，用仪表盘和 24 小时趋势图显示每台机器的当前温度。”
  • “让采样间隔可以按设备配置，范围为 1 到 60 秒。”
  • “让 8080 端口上的 Web 界面可以远程访问。”

要显式启动该技能，请输入 /ironflock:ironflock-templates。

Claude Code 会先阅读您应用的代码，使表与代码所发布的数据相匹配。然后，它会编写模板并运行校验器，直到不再有任何错误。之后，您可以在 UI Builder 中打开该仪表板，以可视化方式进行调整——UI Builder 读写的正是同一个 board-template.yml。

该技能只会修改您应用仓库中的文件。要将这些更改带到使用该应用的项目中，请发布应用的新版本——参见版本发布与应用商店。

不借助智能体校验模板

校验器也可以独立运行，例如在 CI 流水线中：

git clone https://github.com/IronFlock/agent-skills
uv run agent-skills/plugins/ironflock/skills/ironflock-templates/scripts/validate.py path/to/your-app

它会为每个发现的问题输出一行，包含文件、行号和路径；如果发现错误，则以退出码 1 退出。

卸载

claude plugin uninstall ironflock@ironflock
claude plugin marketplace remove ironflock
Last updated on
编写边缘代码Docker 与 Compose