鸿蒙NEXT“应用Skill”到来!让App能力被系统智能体“主动调用”——附3分钟接入实战

skills/{Skill名}/scripts/    ← 入口脚本放这里skills/{Skill名}/SKILL.md    ← 契约描述文件

entry/├── skills/│   └── email-assistant/│       ├── scripts/│       │   └── EmailSkill.ets│       └── SKILL.md└── src/main/ets/    ├── entryability/    │   └── EntryAbility.ets    └── service/        └── EmailManager.ets

{  "module": {    "skillProfiles": [      {        "name": "email-assistant",        "abilityName": "EntryAbility",        "srcEntries": [          "../../skills/email-assistant/scripts/EmailSkill.ets"        ]      }    ]  }}

"requestPermissions": [  { "name": "ohos.permission.INTERNET" }]

import { scriptManager } from '@kit.AbilityKit';import { BusinessError } from '@kit.BasicServicesKit';import { EmailManager } from '../../../src/main/ets/service/EmailManager';export default classEmailSkill{  // 能力1：发送邮件  public async sendEmail(info: scriptManager.ArkTSScriptInfo, ...argv: string[]): Promise<void> {    const recipient: string = argv.length > 0 ? argv[0].trim() : '';    const subject: string = argv.length > 1 ? argv[1].trim() : '';    const body: string = argv.length > 2 ? argv[2].trim() : '';    if(recipient.length === 0 || subject.length === 0) {      await this.report(info, {        code: -1,        result: {          type: 'result',          status: 'failed',          errCode: 'ERR_INVALID_PARAMS',          errMsg: 'recipient and subject are required',          suggestion: '请指定收件人和邮件主题'        }      });      return;    }    try {      const result = await EmailManager.send({ to: recipient, subject, body });      await this.report(info, {        code: 0,        result: {          type: 'result',          status: 'success',          data: { messageId: result.id, status: 'sent' }        }      });    } catch(error) {      await this.report(info, {        code: -1,        result: {          type: 'result',          status: 'failed',          errCode: 'ERR_INTERNAL',          errMsg: (error as Error).message,          suggestion: '邮件发送失败，请检查网络'        }      });    }  }  // 能力2：查询邮件  public async queryEmail(info: scriptManager.ArkTSScriptInfo, ...argv: string[]): Promise<void> {    const keyword: string = argv.length > 0 ? argv[0].trim() : '';    if(keyword.length === 0) {      await this.report(info, {        code: -1,        result: {          type: 'result',          status: 'failed',          errCode: 'ERR_INVALID_PARAMS',          errMsg: 'keyword is empty',          suggestion: '请输入搜索关键词'        }      });      return;    }    try {      const emails = await EmailManager.search(keyword);      await this.report(info, {        code: 0,        result: {          type: 'result',          status: 'success',          data: {            emails: emails.map(e => ({ from: e.from, subject: e.subject, time: e.time })),            total: emails.length          }        }      });    } catch(error) {      await this.report(info, {        code: -1,        result: {          type: 'result',          status: 'failed',          errCode: 'ERR_INTERNAL',          errMsg: (error as Error).message,          suggestion: '查询失败，请稍后重试'        }      });    }  }  // 统一回包出口  private async report(info: scriptManager.ArkTSScriptInfo, result: scriptManager.ExecuteResult): Promise<void> {    try {      await scriptManager.completeArkTSScriptInApp(info.context, info.requestCode, result);    } catch(e) {      const err = e as BusinessError;      console.error(`completeArkTSScriptInApp failed, code: ${err.code}, message: ${err.message}`);    }  }}

---name: email-assistantdescription: 提供邮件发送与查询能力，响应"发邮件"、"查邮件"等办公指令---

## 触发场景当用户明确表达发送邮件或查询邮件时调用。典型话术：- "给产品团队发一封邮件，同步下周的评审时间"- "给张经理发邮件，附上这份文档"- "查一下上周李总监发的邮件"- "找一下关于预算审批的邮件"不调用的情况：- 用户说"帮我写一封投诉信"——写作任务，非发送能力- 用户说"删除收件箱里所有广告邮件"——管理操作，超出能力范围

### 场景1：发送邮件（sendEmail）**执行参数：**exec-cli(command: ohos-arkTSScript --skillName 'email-assistant' --scriptPath 'scripts/EmailSkill.ets' --functionName 'sendEmail' --args '{  "arg1": "产品团队",  "arg2": "下周评审会通知",  "arg3": "定在下周二下午三点"}')**参数Schema：**```json{  "type": "object",  "properties": {    "arg1": { "type": "string", "description": "收件人" },    "arg2": { "type": "string", "description": "邮件主题" },    "arg3": { "type": "string", "description": "邮件正文" }  },  "required": ["arg1", "arg2"]}```

**执行返回值：**// 1. 成功{  "type": "result",  "status": "success",  "data": {    "messageId": "msg_20260618_001",    "status": "sent"  }}// 2. 入参非法{  "type": "result",  "status": "failed",  "errCode": "ERR_INVALID_PARAMS",  "errMsg": "recipient and subject are required",  "suggestion": "请指定收件人和邮件主题"}// 3. 内部错误{  "type": "result",  "status": "failed",  "errCode": "ERR_INTERNAL",  "errMsg": "network timeout",  "suggestion": "邮件发送失败，请检查网络"}

{  "type": "object",  "required": ["type", "status"],  "properties": {    "type": { "type": "string", "const": "result" },    "status": { "type": "string", "enum": ["success", "failed"] },    "data": { "type": "object" },    "errCode": {      "type": "string",      "enum": ["ERR_INVALID_PARAMS", "ERR_INTERNAL"]    },    "errMsg": { "type": "string", "minLength": 1 },    "suggestion": { "type": "string", "minLength": 1 }  },  "oneOf": [    { "required": ["data"] },    { "required": ["errCode", "errMsg", "suggestion"] }  ]}