菜单
A concise (<=300 word) pre-write checklist distilling the project's ObjectScript conventions ($$$ macros, Quit-in-try/catch, %OnNew/initvalue, no-underscore names, storage sections untouchable, deploy/test discipline).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | objectscript-review |
| description | A concise (<=300 word) pre-write checklist distilling the project's ObjectScript conventions ($$$ macros, Quit-in-try/catch, %OnNew/initvalue, no-underscore names, storage sections untouchable, deploy/test discipline). |
Before writing or editing any ObjectScript class, verify:
Macros & naming
$$$ (triple dollar) for macros, never $$. Multiple $/$$ errors in one file → rewrite the whole file rather than patching piecemeal.% or _ prefixes on your own properties/parameters (reserved for system classes).Methods
Set tSC = $$$OK first line, Quit tSC last line, body wrapped in Try/Catch.Quit must be ARGUMENTLESS (ERROR #1043 otherwise). Initialize the return variable before the Try block, set it inside, Quit (no args) at the end of Try and Catch, then Quit <var> after the block.$$$NULLOREF, "", $$$OK, 0) — never truly empty.%OnNew(initvalue As %String = "") must call ##super(initvalue) first and check its status; never mark %OnNew Private.Namespace & REST handlers
New $NAMESPACE; save/restore explicitly (Set tOrigNS = $NAMESPACE ... Set $NAMESPACE = tOrigNS), restoring BEFORE any catch-block reference to a class from the original namespace.%SYS.Errors
SanitizeError; never embed a caret-global name (^Name) in a message that reaches it — the caret gets silently stripped.Storage & structure
/// for doc comments, not // (which does not comment in ObjectScript classes).Deploy & test
.cls files on disk first, then iris_doc_load with a glob-prefixed path (a bare path mis-maps the class name), then iris_execute_tests — always compare the returned total against the expected test count before trusting a "0 failures" run; rerun if short.Review and promote configuration/code drift from a source IRIS environment to a target using the review-before-write iris_env_diff -> iris_env_promote workflow (scoped diff, plan, an explicit user-selected step allowlist, confirmed execute, re-diff verify). Never acts on onlyInTarget warnings -- never deletes a target-only item, in any action.
Resend failed Interoperability messages for a config item using the dry-run-first iris_message_resend workflow — preview the match count before executing, then verify the new headers via iris_production_messages. States the duplication hazard and that resend/resendFiltered are governance-default-disabled writes.
Audit the IRIS instance's security posture: users (default passwords, %All holders), roles, service authentication settings, SSL/TLS configs, and instance auditing status.
Run a full IRIS instance health check (iris_health_check) and interpret every non-ok finding, naming the fixing tool for each one.
Deploy an ObjectScript class or package to IRIS (iris_doc_load, glob-path form), fix compile errors, then run its unit tests (iris_execute_tests) with a total-count check.
Diagnose a slow SQL query using iris_sql_analyze (explain, indexUsage, stats) and recommend a fix — never auto-applies one.