AI 开发与 Skills
约 869 字大约 3 分钟
2026-10-16
开发技能告诉 AI 如何使用 SDK、组织代码和验证结果。安装 Go 依赖不会自动安装技能；自己的应用仓也应保留开发入口。
读取与获取 Skills
直接打开 ur-kit 仓时，先读根 AGENTS.md 和 .agents/skills/ur-kit-development/SKILL.md。在自己的仓使用时，带入整个技能目录及 references，修正源码链接并记录来源提交。
SDK 示例固定 v0.2.36；本页技能来源固定为包含完整接入指南的 b2b32b3111dae20f94f00fae92b43b3a1c31e6e4。技能更新与 SDK 升级独立审查。以下命令在独立应用根目录执行，目标技能目录应尚不存在：
mkdir -p .agents/skills
skills_commit=b2b32b3111dae20f94f00fae92b43b3a1c31e6e4
curl -fL "https://github.com/unitedrhino/ur-kit/archive/$skills_commit.tar.gz" | \
tar -xz --strip-components=3 -C .agents/skills \
"ur-kit-$skills_commit/.agents/skills/ur-kit-development"取得后按项目规则模板修正 Markdown：技能内 references/ 导航保留相对链接；套件源码路径改为对应固定提交的 GitHub 文件地址，或本仓实际文件地址。docs/realtime.md、docs/application-capabilities.md 等技能外指南也要改为技能源提交地址，或把正文带入自己的资料目录，不能改成较旧 SDK 标签。只复制 SKILL.md 会缺少指南，直接沿用套件源码相对路径也会产生断链。
项目 AGENTS 示例
在自己的仓根目录维护简短的 AGENTS.md：
# 项目开发规范
- SDK 固定使用 ur-kit v0.2.36；技能来源另记录提交，不在构建时自动升级。
- 先读取 .agents/skills/ur-kit-development/SKILL.md，按任务加载参考材料。
- Web、mobile、backend 或协议代码按本项目实际目录组织。
- 平台接口通过公开 SDK；不导入 SaaS 私有包或 upstream 原始对照快照。
- 身份须经认证，业务资源按企业与项目隔离，授权在服务端执行。
- 地址、凭据和证书由运行环境提供，不提交到源码或镜像。
- 修改前确认验收条件，按改动运行测试、构建和必要的业务联调。补入自己的实际目录和命令，再提交规则与技能文件。支持自动发现的 AI 工具从仓库根目录打开；其他工具可以直接指定这些 Markdown 文件。
按任务读取
| 任务 | 技能参考文件 |
|---|---|
| WS、站内通知与其他平台能力 | 固定技能源提交下的 docs/realtime.md、docs/application-capabilities.md |
| Web/mobile/业务后端 | references/application-development.md |
| MQTT、Modbus 和自定义网关 | references/protocol-development.md |
| 路由、应用、菜单、任务 | references/platform-registration.md |
| Docker、ur 和 urops 协作 | references/urops-deployment.md |
示例提示：
先读取 AGENTS 和 ur-kit 开发技能，核对本仓固定版本。新增一个业务接口及页面，复用已有认证和请求器，补充跨项目拒绝用例，验证后说明实际结果。
ur 辅助平台操作
按 ur 安装与快速开始安装现有 CLI，使用 ur --help、ur --app iot --help 核对命令及认证方式。ur 使用操作者授权调用平台 API，开发技能直接来自 ur-kit，不要求给 ur 增加开发技能下载功能。
缺少平台权限、厂家报文或设备参数时，AI 应明确缺口，先完成不依赖它们的验证。模拟请求、真实平台和真实硬件分别记录，不把接口返回成功当作设备执行成功。
更新日志
2026/10/16 20:08
查看所有更新日志
b1437-docs(应用开发): 补齐WS通知及平台能力接入导航于1a4a7-docs(开发指南): 重建平台与应用开发路线于