Menu
金蝶云苍穹开发主 Skill，优先复用 kd-cd-cosmic-commons 封装。适用于插件开发、单据/列表/表单逻辑、操作服务、BOTP 转换、后台视图打开、附件处理、DynamicObject 与元数据处理、弹性域解析及 OpenAPI 集成。默认优先使用仓库封装；在涉及原生插件事件、SDK API、方法签名或封装未覆盖场景时，使用内置脚本进行查询。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | ok-cosmic |
| description | 金蝶云苍穹开发主 Skill，优先复用 kd-cd-cosmic-commons 封装。适用于插件开发、单据/列表/表单逻辑、操作服务、BOTP 转换、后台视图打开、附件处理、DynamicObject 与元数据处理、弹性域解析及 OpenAPI 集成。默认优先使用仓库封装；在涉及原生插件事件、SDK API、方法签名或封装未覆盖场景时，使用内置脚本进行查询。 |
默认按"封装优先，原生兜底"工作，避免在仓库已封装的场景里退回到 BOS 原生低层 API。
references/*.md，确认事件边界与适用场景。assets/*.java 模板，沿用已有方法签名和骨架。小场景可直接用 assets/snippets/*.java。cosmic-form-metadata.py，SDK 签名不确定先查 cosmic-api-knowledge.py。cosmic-post-lint.py 自动校验；若存在 ERROR 级问题须立即修复并重新校验直到通过。以下文件提供详细规则，AI 应在需要时按需加载：
模板骨架给出完整插件结构，snippets 给出单个场景的最小可运行示例。遇到以下场景时，优先读对应 snippet 再写实现：
| 场景关键词 | snippet 文件 |
|---|---|
| 字段取值/赋值/getValue/setValue | GetAndSetValueSample.java |
| 分录行计算/汇总/金额联动 | EntryRowCalculateSample.java |
| 确认框/二次确认/ConfirmCallBack | ConfirmDialogSample.java |
| 操作前拦截确认/beforeDoOperation | BeforeOperationConfirmSample.java |
| F7 过滤/基础资料弹窗过滤 | F7FilterSample.java |
| 打开单据弹窗/showForm/Modal | OpenBillModalSample.java |
| 子页面回传数据/closedCallBack | ReturnParentDataSample.java |
| 树形控件/TreeView/树节点 | TreeControlSample.java |
| 列表插件基础/选中行/批量操作 | ListPluginBasicSample.java |
| 列表预打开过滤/setFilter | ListPreOpenFilterSample.java |
| 操作校验器/addValidators | OpAddValidatorsSample.java |
| 下推/选单/来源追踪/BotpUtils | BotpTracePushSample.java |
| 查询/聚合/DataSet/统计 | DataSetQueryStatSample.java |
| 基础资料查询/loadFromCache | BaseDataQuerySample.java |
| DynamicObject 操作/安全取值 | DynamicObjectOpsSample.java |
| 附件上传/绑定/AttachmentUtils | AttachmentUploadBindSample.java |
| 消息通知/邮件/MessageService | MessageNotifySample.java |
| 后台调度任务/定时任务 | ScheduleTaskSample.java |
本 Skill 提供了两个核心 Python 脚本，用于查询苍穹 SDK API 和表单元数据。
cosmic-api-knowledge.py)用于模糊搜索类名、获取类方法签名、继承树与注释。
python3 <SKILL_ROOT>/scripts/cosmic-api-knowledge.py [options] <command> [args]search <query...>: 模糊搜索类名。支持多关键词，默认任一关键词命中即可返回；加 --all 表示全部关键词都要命中。search-method <query...>: 全局搜索方法名。支持多关键词，默认任一关键词命中即可返回；加 --all 表示全部关键词都要命中。结果会优先把与查询词更接近的方法排在前面，并展示方法说明摘要。detail <classname>: 获取指定全限定类名的详细信息。
--method <keyword> 只看相关方法。--declared-only 只看当前类声明的方法，不展开父类。--compact 输出紧凑事实块，减少 token 消耗，适合继续交给 AI 生成代码。--class-prefix <prefix>: 按包前缀或类名前缀过滤，可重复传入多个前缀。--class-regex <regex>: 按类全限定名正则过滤。--kind <helper|servicehelper|plugin|service|utils|runtime|entity|const|enum|controller>: 按常见类别快速过滤。--config <path/to/ok-cosmic.json> 指定配置文件(优先匹配当前运行项目的根目录)。推荐用法（比裸搜更稳）
python3 <SKILL_ROOT>/scripts/cosmic-api-knowledge.py --config ok-cosmic.json search Helper --class-prefix kd.bos.servicehelper --kind helperpython3 <SKILL_ROOT>/scripts/cosmic-api-knowledge.py --config ok-cosmic.json search-method send email --class-prefix kd.bos.servicehelper.messagepython3 <SKILL_ROOT>/scripts/cosmic-api-knowledge.py --config ok-cosmic.json search plugin operation --kind plugin --allpython3 <SKILL_ROOT>/scripts/cosmic-api-knowledge.py --config ok-cosmic.json detail "类全限定名" --method "关键词"python3 <SKILL_ROOT>/scripts/cosmic-api-knowledge.py --config ok-cosmic.json detail "类全限定名" --method "关键词" --declared-onlypython3 <SKILL_ROOT>/scripts/cosmic-api-knowledge.py --config ok-cosmic.json detail "类全限定名" --method "关键词" --compactAI 调用约束
--class-prefix 或 --kind，不要连续无过滤地重复大范围搜索。kd.bos.servicehelperkd.bos.entitykd.bos.formkd.bdkd.scm定向搜索优先级
kd.bos.servicehelperkd.bos.entity、kd.bos.formkd.bdsearchsearch-methoddetail@Override 是否应写在当前类，而不是父类已有实现时：
detail "类全限定名" --method "关键词" --declared-onlydetail "类全限定名" --method "关键词" --compactcosmic-form-metadata.py)用于根据 formId 或 billName 获取单据元数据字段，支持字段模糊筛选。
python3 <SKILL_ROOT>/scripts/cosmic-form-metadata.py [options] get [args]--form-id: 表单英文标识。--bill-name: 表单中文名称。--fuzzy: 字段标识或名称的模糊匹配列表。[强制] 多个关键词必须用空格分隔（例如 --fuzzy qty price amount），支持正则表达式（如 --fuzzy "qty|price|amount"），严禁使用逗号分隔。--show-detail: 详情模式开关。当存在模糊匹配结果时，显示枚举项映射 (extMap) 或基础资料引用类型 (refType)。--config <path/to/ok-cosmic.json> 指定配置文件(优先匹配当前运行项目的根目录)。AI 调用约束 (元数据查询)
--show-detail。if 条件判断（针对枚举值）、手动赋值 或 基础资料关联查询 前，必须带上 --show-detail。form_metadata_cache 表，必须通过脚本获取详情，以保证逻辑的一致性和可维护性。下面这张"先找哪里"的地图，优先用于缩小搜索范围。
操作插件 / 审核保存提交流程
kd.bos.entity.plugin.AbstractOperationServicePlugInkd.bos.entity.plugin、kd.bos.entity.plugin.argsOpUtils、OperateChain、OperationServiceHelper表单 / 单据 / 列表 UI 插件
kd.bos.form.plugin.*kd.bos.form、kd.bos.form.control、kd.bos.listthis.getView()、this.getModel()BOTP 下推 / 选单 / 转换
kd.cd.common.util.BotpUtilskd.bos.entity.botp.runtime.PushArgs、DrawArgs、ConvertOperationResultkd.bos.entity.botp.plugin.AbstractConvertPlugInkd.bos.servicehelper.botp.ConvertServiceHelper基础资料 / 管控策略 / 分配 / 个性化
kd.bos.servicehelper.basedata.BaseDataServiceHelperkd.bd.master.*AssignIndividuationHelper、相关 helper / mservice数据加载 / 保存 / 查询
kd.bos.servicehelper.BusinessDataServiceHelperkd.bos.servicehelper.QueryServiceHelperkd.bos.orm.query.QFilter消息 / 邮件 / 短信 / 企业微信
kd.bos.servicehelper.message.MessageServiceHelperkd.bos.message.api.EmailInfokd.bos.message.apiDynamicObject / 元数据 / 实体结构
kd.bos.dataentity.entity.DynamicObjectEntityType、MainEntityTypeentity-metadata.md附件 / 文件
AttachmentUtilsAttachmentServiceHelper组织 / 权限 / 上下文
RequestContext、Permission 相关 service/helperappId、使用组织、主业务组织分别来自哪里[强制] 在生成或修改任何苍穹 Java 代码后，必须执行以下校验流程：
python3 <SKILL_ROOT>/scripts/cosmic-post-lint.py <生成的文件或目录> --fix-hint
AI 调用约束 (Post-Lint)
.java 文件后，自动触发 lint 校验，不需要用户手动请求。