jetlinks-develop-skills

在当前 JetLinks 工作区中应用共享编码规范。适用于需要确认注解和导入、遵循本地命名与包结构、保持最小改动，判断模块是否应该补 i18n，实现 LocaleUtils、I18nEnumDict、messages_zh/messages_en、权限动作文案，补充 TraceHolder / MonoTracer / FluxTracer 链路追踪埋点，为常驻任务、缓存、队列等能力设计 MBean 运维可观测性，平衡人类可读性与大模型理解成本来编写代码注释，或当具体场景暴露公共组件、基类、框架、工具类等通用能力缺口时避免硬编码特调并从共同根因修复的场景。

在 JetLinks 脚手架中实现标准或高级 CRUD 开发。适用于需要新增或修改实体、服务、控制器、查询流程、批量更新，或处理与 CRUD 相关副作用，同时遵循当前模块现有风格的场景。

将 JetLinks 开发请求路由到当前工作区中最合适的 focused skill。适用于尚不确定应使用哪个 JetLinks 技能，或任务同时涉及模块落点、通用编码规范、响应式实践、CRUD、跨边界调用、事件与订阅流程、前端页面改造以及交付准备的场景。

沉淀 JetLinks 开发过程中的可复用知识。适用于任务完成后判断是否值得沉淀、先给出沉淀建议，并在用户确认后将经验整理为 worklog、knowledge、playbook、提示词或 skill 更新；若已成熟到可抽成通用 skill，则继续询问是否并入官方技能仓库 PR 的场景。

发现 JetLinks 工作区结构并选择正确模块，必要时创建新模块。适用于需要梳理当前仓库结构、定位业务模块、识别软链接模块，或在低上下文脚手架中创建新模块的场景。

为 JetLinks 代码变更准备合规交付内容。适用于需要创建符合分支策略的提交、起草或审查中文 Conventional Commit、生成 shell 可执行的 git commit 命令、遵循 JetLinks 提交标题规范、避免直推受保护分支、落实后端新增功能或行为变动的测试门禁、收集测试证据，或编写包含测试、覆盖率、代码注释 / 公共契约（含 SPI 必要 @since / @see）、TraceHolder 与 MBean 运维可观测性结论的 PR 描述的场景。

在当前 JetLinks 工作区中使用统一 AssetsHolder 资产权限体系处理数据权限。适用于 CRUD 查询、详情、更新、删除、批量、导出、自定义接口、关联资产、命令服务、订阅或聚合查询需要资产权限控制，或需要判断 AssetType、@AssetsController、AssetsHolderCrudController、CorrelatesAssetsHolderCrudController、CrudAssetPermission、AssetsHolder.injectQueryParam / assertPermission / filterAssets 用法的场景。

在当前 JetLinks 工作区中选择并实现跨边界交互方式。适用于需要在直接依赖、命令服务、代理或其他跨模块访问模式之间做决策和落地的场景，尤其是响应式模块或低上下文脚手架中的边界选择。

在当前 JetLinks 工作区中实现事件驱动和订阅处理流程。适用于需要新增实体生命周期监听、领域事件、主题订阅、消息处理器，或其他异步副作用逻辑的场景。

在 JetLinks 协议包中处理协议支持注册、MQTT/HTTP/TCP/UDP/CoAP 编解码、Topic 或 path 路由、二进制报文读写、注册鉴权、设备物模型映射、协议文档与测试定位。适用于阅读、创建或维护 ProtocolSupportProvider、DeviceMessageCodec、MessageParser、二进制消息注册表等协议代码，排查上下行链路、认证失败、粘拆包、应答关联或基于协议文档实现新的设备接入方式。

在当前 JetLinks 工作区中应用响应式与非阻塞实现实践。适用于需要处理 Mono 或 Flux 链路、避免阻塞调用、批量化响应式 CRUD 副作用，或判断响应式处理器如何与事件、订阅和远程调用协作的场景。

在 JetLinks 前端工作区中实现或改造 Vue3 页面，优先复用 `@jetlinks-web-core` 与 `@jetlinks-web` 的组件、hooks、utils。适用于列表页/详情页/弹窗开发、后端 EnumDict/I18nEnumDict 返回 `{value,text}` 的枚举渲染、目录落点判断、状态管理、类型与质量约束、Tab 回传、平台上下文、运行时注册扩展、路由菜单装配与查询参数编码等场景。除局部调整白名单外，任何新增页面、页面壳层重构、信息架构或主筛选 / 主列表 / 主详情承载变化，都必须先联合 `jetlinks-web-style` 形成交互方案档案，再进入实现。

为 JetLinks 前端页面选择、复用并约束业务交互方案。这是 JetLinks 前端交互方案选择的核心入口。除非任务属于"局部调整白名单"（改一个字段 / 改一个筛选条件 / 改一个弹窗 / 仅样式与文案 props 微调），任何新增页面、重构页面壳层、调整信息架构或主筛选 / 主列表 / 主详情承载都必须先形成一个可交付的方案档案：按 `style-catalog.md`（索引）加载 `style-catalog-routing.md`、`style-catalog-core-base.md`，详情 / 侧栏相关再加载 `style-catalog-core-detail-shell.md`，并只读取 `style-catalog-templates.md` 中候选对应的 `###` 小节。输出 1 个推荐方案和最多 3 个替代方案；若业务事实不足或结构风险高则先让用户确认，否则可采用推荐方案继续实现。按统一字段（业务任务 / 首屏 ASCII 线框 / 信息密度 / 编辑梯度 / 核心组件 / 状态锚点 / 不借鉴清单）稳定复用结构与 `jetlinks-web-core` 组件组合，禁止默认回退成"传统后台表格 + 编辑弹窗"套壳；标准管理表格页和 `ProSearch` 只能在有明确业务或兼容依据时使用。