description
| description |
|---|
| 用用户能理解的方式说明这个技能能做什么、适合什么场景,以及边界与结果形态。 |
模板说明(复制后删除本段)
本文是技能市场 「说明」 Tab(readme_md),不是使用教程。
frontmatter 的description必须是用户能看懂的一句话能力描述;不得写成 CLI、schema、references、development、契约或「如何开始使用」类教程承诺。
禁止写入:分步操作(1/2/3)、Agent 示例话术块、「入口一/入口二」专章、逐步排障。这些一律写在根目录TUTORIAL.md。
正文只回答:是什么、能做什么、适合谁、准备什么、得到什么、注意事项。完整契约见development/TUTORIAL_SURFACES.md§1。
复制后验收章节(标题可微调):「能帮你做什么」「适合什么场景」「使用前需要准备什么」「怎么使用」「执行后你会得到什么」「注意事项」「常见问题」。
标题层级: 宿主页头已有技能名——禁止文首再写# 技能名;正文主分节用##。
用一两句话说明这个技能帮助用户完成什么工作。
这里不要解释技术实现,要从用户的业务目标出发描述价值。
这个技能能帮你做什么
用 3 到 6 条业务能力说明技能价值(不要写成操作步骤),例如:
- 【自动整理/查询/生成/同步/核对/提交】某类业务数据
- 帮你减少重复操作,降低人工录入或核对成本
- 在任务完成后给出清晰的处理结果、失败原因或后续建议
适合什么场景
列出典型使用场景。请使用用户熟悉的业务语言,例如:
- 每天需要重复处理同一类订单、单据、报表或客户资料
- 需要从多个系统中查询信息并汇总结果
- 需要按固定规则检查数据是否完整、是否异常
- 需要把处理结果保存为文件、记录或任务报告
使用前需要准备什么
说明前置条件(装什么、要不要账号、要不要外站登录),不要写「去哪张表点哪个按钮」:
- 网页自动化类: 可能需要在账号管理中登记平台账号;登记账号 ≠ 已登录目标站(细节见使用教程)
- 相关业务权限(查询、导出、提交等)已具备
- 需要处理的文件、时间范围、单号等信息(若适用)
- 若涉及验证码或人工确认,使用时请能及时在弹出窗口中操作
怎么使用
本技能支持哪些宿主入口,用一两句话概括即可,例如:
- 支持 数据管理(点表操作)与 对话任务(自然语言);是否提供定时任务按本技能说明。
逐步操作、示例话术与排障,请查看技能市场「使用教程」Tab。
(完整写法见 development/TUTORIAL_SURFACES.md。)
执行后你会得到什么
说明用户会看到什么结果形态(不要教如何点出来),例如:
- 任务是否成功完成
- 处理了多少条数据;哪些成功、哪些失败
- 生成的文件、表格、报告或业务表记录
注意事项
用用户能理解的方式说明边界和风险,例如:
- 请确认输入范围准确,避免处理错数据
- 涉及提交、付款、删除、审批等高风险动作时,技能应在执行前请求确认
- 如果外部系统登录失效、权限不足或页面变化,任务可能需要用户介入
- 不建议在未核对数据的情况下直接执行批量操作
常见问题
FAQ 写概念与边界;需要「点哪里」的排障写到「使用教程」。
这个技能适合我吗?
若你的场景与上文「适合什么场景」一致,可以安装后按「使用教程」完成第一次操作。
我不会操作,从哪里开始?
请打开技能市场 「使用教程」 Tab,按「入口一:数据管理」或「入口二:对话任务」任选一种跟做。
已经登记的账号在哪里查看?
请到匠厂的「数据管理 / 账号管理」查看账号记录和状态。不要发送密码、Cookie 或验证码。