业务域载荷
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_e02e04b8/business-domain-payload。
技能介绍
要解决什么问题
在企业系统对接、运营报表和流程自动化里,模型经常要产出或改写结构化业务数据:订单字段、审批单、对账明细、领域事件等。若只靠自然语言约定,容易出现字段名混用、枚举值不一致、嵌套层级与后端契约对不上,联调时才发现 JSON 与接口文档脱节。
「业务域载荷」这类技能的目标,是让对话中的输出更贴近某一业务域的数据形状与语义,而不是泛泛的示例 JSON。
技能如何工作
从名称与 business-ops 分类可以推断,技能通过 SKILL.md 中的领域说明与约束,引导模型在以下方面对齐业务侧预期:
- 载荷结构:对象层级、必填字段、与常见 DTO / 消息体类似的骨架
- 领域词汇:使用业务方认可的字段名与取值口径,减少「技术别名」与「业务别名」混写
- 边界与校验意识:在生成或补全载荷时,标明不确定字段、缺省策略或与契约冲突之处,便于人工复核
具体步骤与模板以技能包内文档为准;本页资料未展开实现细节时,应把技能当作领域载荷写作的提示与规范载体,而非独立的数据校验服务。
适用边界与注意点
- 技能不能替代服务端 schema 校验、权限与幂等;上线前仍须以 API 契约与测试环境为准。
- 多域、多租户场景下,需在技能说明中明确当前域与版本,避免模型套用错误领域的字段集。
- 涉及金额、身份、合规字段时,应默认走脱敏与最小披露,由人在关键节点确认后再落库或外发。
使用场景
- 对接新接口前,按内部订单或合同领域模型生成符合契约的 JSON 样例,供联调与评审对照。
- 把运营口述的审批、工单需求整理成嵌套对象载荷,字段名与枚举与现有系统口径一致。
- 编写领域事件或消息体说明时,批量产出多业务场景的示例 payload,供 QA 做契约测试。
- 跨团队对齐字段含义时,在既定领域说明下补全必填项与嵌套结构,减少手写草案来回改。
适合人员
- 负责系统对接、需从领域文档生成可评审 JSON 样例的后端或集成工程师
- 维护流程与字段口径、要把口头需求落成结构化载荷草案的业务运营
- 编写接口或消息契约、需要多场景示例数据的产品与架构同学
- 在对账、报送场景中整理明细字段并输出标准形状数据的财务或数据运营