Files
skill-template/references/README.md
chendelian 7827cc75b2
All checks were successful
技能自动化发布 / release (push) Successful in 10s
chore: auto release commit (2026-06-13 14:59:54)
2026-06-13 14:59:54 +08:00

3.2 KiB

description
description
用用户能理解的方式说明这个技能能做什么、适合什么场景,以及如何开始使用。

【技能名称】

用一两句话说明这个技能帮助用户完成什么工作。
这里不要解释技术实现,要从用户的业务目标出发描述价值。

这个技能能帮你做什么

用 3 到 6 条业务能力说明技能价值,例如:

  • 【自动整理/查询/生成/同步/核对/提交】某类业务数据
  • 帮你减少重复操作,降低人工录入或核对成本
  • 在任务完成后给出清晰的处理结果、失败原因或后续建议

适合什么场景

列出典型使用场景。请使用用户熟悉的业务语言,例如:

  • 每天需要重复处理同一类订单、单据、报表或客户资料
  • 需要从多个系统中查询信息并汇总结果
  • 需要按固定规则检查数据是否完整、是否异常
  • 需要把处理结果保存为文件、记录或任务报告

使用前需要准备什么

说明用户在使用前要准备的东西,例如:

  • 相关账号已登录,且具备查询、导出或提交权限
  • 需要处理的文件、时间范围、订单号、客户名称、项目名称等信息
  • 如果涉及外部系统,请确认网络、账号、验证码或审批流程可正常使用

你可以这样告诉 Agent

用自然语言示例展示用户可以怎么发起任务,例如:

  • “帮我查询今天的【业务对象】,整理成表格。”
  • “帮我核对这些【数据/单据】是否有异常,并告诉我问题在哪里。”
  • “帮我把【时间范围】内的【业务数据】导出并生成处理报告。”
  • “帮我根据这个文件里的内容,逐条完成【业务动作】。”

注意:示例应是自然语言,不要写命令行命令。

执行后你会得到什么

说明用户会看到什么结果,例如:

  • 任务是否成功完成
  • 处理了多少条数据
  • 哪些内容成功、哪些失败
  • 失败原因和建议处理方式
  • 生成的文件、表格、报告或记录

注意事项

用用户能理解的方式说明边界和风险,例如:

  • 请确认输入范围准确,避免处理错数据
  • 涉及提交、付款、删除、审批等高风险动作时,技能应在执行前请求确认
  • 如果外部系统登录失效、权限不足或页面变化,任务可能需要用户介入
  • 不建议在未核对数据的情况下直接执行批量操作

常见问题

为什么任务没有查到数据?

可能是时间范围、关键词、账号权限或系统筛选条件不正确。请先确认输入信息是否准确。

为什么任务执行到一半需要我操作?

可能遇到了登录、验证码、权限确认、二次审批或系统异常。请根据 Agent 的提示完成必要操作。

结果文件在哪里查看?

请根据 Agent 返回的结果说明查看生成文件、任务记录或处理报告。

给技能开发者的填写提醒

复制这个模板创建新技能后,请把本文中的【占位内容】替换成真实业务说明。
请始终从用户视角描述技能价值,不要把实现方式、代码文件、测试方法、发布流程写在这里。
技术实现细节应写入开发文档,而不是用户说明页。