（3366期）iris-code-formatter – IRIS代码智能格式化与审查专家

IRIS代码智能格式化与审查专家 面向InterSystems IRIS/Cache ObjectScript的专业代码格式化与审查工具，支持变量命名、方法规范、事务锁等8大维度自动修正，提升医疗级M语言代码可维护性。 使用说明 技能概述 iris-code-formatter 是专为 InterSystems IRIS/Cache 数据库环境设计的 ObjectScript 代码规范化工具，由资深医疗信息化开发者姚鑫维护。该技能深度针对 M 语言（MUMPS）衍生方言的语法特性，提供从命名规范到事务安全的全方位代码审查与自动修正能力。 核心能力 1. 多维规范检查体系 命名规范：覆盖变量（lowerCamelCase）、常量（全大写）、方法（UpperCamelCase）、Global（^CacheTemp 标准）等命名规则 事务安全：强制检测开放性事务，要求 ts/tc/tro 成对出现且在同一屏幕内，禁止跨方法提交 锁机制：验证加解锁成对性（+/-）、超时设置（:3）、避免死锁与死进程 陷阱处理：统一错误陷阱命名，内置 $zt=""、$tl>0 时的 tro 回滚等安全模板 2. 格式与可读性优化 运算符两侧强制空格、逗号后空格、方法大括号换行 命令缩写标准化（s/d/q/k 等），保留 for/while/if 全拼 系统函数缩写（$e/$p/$l/$o 等） 关键特性：后置表达式格式校验——括号内运算符加空格、括号与 &&/|| 间不加空格，避免编译错误 3. 智能修正输出 完整保留原始代码结构，输出修正后完整代码（禁止省略） 逐行标记问题位置，引用具体规范条款 生成 Markdown 格式审查报告，含问题分级（严重/警告） 显著优势 领域专精：针对医疗信息化行业主流的 IRIS 平台深度定制，理解 ^global、&sql()、%Status 等特有概念 安全导向：内置事务完整性、锁超时、陷阱防死循环等企业级安全规则 工程实用：50 行方法长度限制、参数对象化重构建议等符合 Clean Code 实践 编译安全：后置表达式格式校验直接关联 IRIS 编译器行为，避免运行时错误 局限性与注意事项 平台绑定：仅适用于 InterSystems IRIS/Cache 环境，不兼容标准 MUMPS 或其他 M 语言实现 规范刚性：采用作者所在团队的编码规范，可能与用户组织现有规范冲突 版本依赖：部分规则（如 ^CacheTemp 命名）可能随 IRIS 版本演进变化 非语义分析：基于模式匹配进行格式化，不执行深度语义分析或逻辑错误检测 适用人群 医疗信息化开发者：使用 IRIS/Cache 开发医院信息系统（HIS、EMR、LIS 等）的工程团队 遗留系统维护者：需要统一老旧 ObjectScript 代码风格的技术负责人 代码审查人员：需要自动化工具辅助 CR 的资深开发者或架构师 IRIS 新手上路：通过强制规范快速理解企业级 ObjectScript 编码标准 常规风险 自动化修正风险：复杂逻辑的后置表达式可能被误格式化，建议关键代码人工复核 注释覆盖：自动格式化可能调整注释位置，需确认文档注释（///）完整性 Global 引用变更：临时 Global 命名修正可能影响跨进程数据依赖 事务边界：自动插入 ts/tc 需确认业务逻辑的原子性要求，避免过度事务化 原始说明 对InterSystems IRIS/Cache ObjectScript代码进行格式化检查、审查和自动修正。 当用户需要格式化IRIS代码、检查代码规范合规性、审查代码质量或修正不符合规范的代码时触发此技能。 支持变量命名、方法命名、锁、事务、陷阱、格式、空行、注释等多个维度的规范检查。