القائمة
金蝶云苍穹开发主 Skill，优先复用 kd-cd-cosmic-commons 封装。适用于插件开发、单据/列表/表单逻辑、操作服务、BOTP 转换、后台视图打开、附件处理、DynamicObject 与元数据处理、弹性域解析及 OpenAPI 集成。默认优先使用仓库封装；在涉及原生插件事件、SDK API、方法签名或封装未覆盖场景时，使用内置脚本进行查询。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف 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 校验，不需要用户手动请求。