108 lines
4.6 KiB
Markdown
108 lines
4.6 KiB
Markdown
---
|
||
description: "用用户能理解的方式说明这个技能能做什么、适合什么场景，以及如何开始使用。"
|
||
---
|
||
|
||
> **模板说明（复制后删除本段）**
|
||
> 本文是技能市场详情与普通用户说明，**不是** Agent 参考索引、CLI 契约或开发文档。
|
||
> frontmatter 的 `description` 必须是用户能看懂的一句话能力描述；**不得**写成 CLI、schema、references、development、契约、数据结构、开发规范或 Agent 参考索引。
|
||
> 正文只回答用户关心的问题，**不要**把 Playwright、DOM、Python、RPA、references、development、schema 等作为面向用户的主说明内容；若业务上必须出现技术词，须用用户能理解的方式解释，且不能喧宾夺主。
|
||
> **复制后验收章节（标题可微调，建议保留）：**「能帮你做什么」「适合什么场景」「使用前需要准备什么」「你可以这样告诉 Agent」「执行后你会得到什么」「注意事项」「常见问题」。
|
||
|
||
# 【技能名称】
|
||
|
||
> 用一两句话说明这个技能帮助用户完成什么工作。
|
||
> 这里不要解释技术实现，要从用户的业务目标出发描述价值。
|
||
|
||
---
|
||
|
||
## 这个技能能帮你做什么
|
||
|
||
用 3 到 6 条业务能力说明技能价值，例如：
|
||
|
||
- 【自动整理/查询/生成/同步/核对/提交】某类业务数据
|
||
- 帮你减少重复操作，降低人工录入或核对成本
|
||
- 在任务完成后给出清晰的处理结果、失败原因或后续建议
|
||
|
||
---
|
||
|
||
## 适合什么场景
|
||
|
||
列出典型使用场景。请使用用户熟悉的业务语言，例如：
|
||
|
||
- 每天需要重复处理同一类订单、单据、报表或客户资料
|
||
- 需要从多个系统中查询信息并汇总结果
|
||
- 需要按固定规则检查数据是否完整、是否异常
|
||
- 需要把处理结果保存为文件、记录或任务报告
|
||
|
||
---
|
||
|
||
## 使用前需要准备什么
|
||
|
||
说明用户在使用前要准备的东西，例如：
|
||
|
||
- **网页自动化类：** 首次运行可由技能自动登记平台账号（浏览器会话由系统隔离管理）。也可在「账号管理」里指定登录标识。登记账号 ≠ 已登录目标站
|
||
- **账号在哪里看：** 已登记账号可在「数据管理 / 账号管理」中查看；每个账号使用独立浏览器会话，批量或多账号任务不会共用登录状态
|
||
- **是否要登录目标站：** 按本技能说明（有的平台必须登录，有的公开页可不登录）；与「是否有账号记录」不是一回事
|
||
- 相关业务权限（查询、导出、提交等）已具备
|
||
- 需要处理的文件、时间范围、订单号、客户名称、项目名称等信息
|
||
- 如果涉及验证码或人工确认，请保证能及时在弹出的浏览器窗口中操作
|
||
|
||
---
|
||
|
||
## 你可以这样告诉 Agent
|
||
|
||
用自然语言示例展示用户可以怎么发起任务，例如：
|
||
|
||
> “帮我查询今天的【业务对象】，整理成表格。”
|
||
>
|
||
> “帮我核对这些【数据/单据】是否有异常，并告诉我问题在哪里。”
|
||
>
|
||
> “帮我把【时间范围】内的【业务数据】导出并生成处理报告。”
|
||
>
|
||
> “帮我根据这个文件里的内容，逐条完成【业务动作】。”
|
||
|
||
> 注意：示例应是自然语言，不要写命令行命令。
|
||
|
||
---
|
||
|
||
## 执行后你会得到什么
|
||
|
||
说明用户会看到什么结果，例如：
|
||
|
||
- 任务是否成功完成
|
||
- 处理了多少条数据
|
||
- 哪些内容成功、哪些失败
|
||
- 失败原因和建议处理方式
|
||
- 生成的文件、表格、报告或记录
|
||
|
||
---
|
||
|
||
## 注意事项
|
||
|
||
用用户能理解的方式说明边界和风险，例如：
|
||
|
||
- 请确认输入范围准确，避免处理错数据
|
||
- 涉及提交、付款、删除、审批等高风险动作时，技能应在执行前请求确认
|
||
- 如果外部系统登录失效、权限不足或页面变化，任务可能需要用户介入
|
||
- 不建议在未核对数据的情况下直接执行批量操作
|
||
|
||
---
|
||
|
||
## 常见问题
|
||
|
||
### 为什么任务没有查到数据？
|
||
|
||
> 可能是时间范围、关键词、账号权限或系统筛选条件不正确。请先确认输入信息是否准确。
|
||
|
||
### 为什么任务执行到一半需要我操作？
|
||
|
||
> 可能遇到了登录、验证码、权限确认、二次审批或系统异常。请根据 Agent 的提示完成必要操作。
|
||
|
||
### 结果文件在哪里查看？
|
||
|
||
> 请根据 Agent 返回的结果说明查看生成文件、任务记录或处理报告。
|
||
|
||
### 已经登记的账号在哪里查看？
|
||
|
||
> 请到匠厂的「数据管理 / 账号管理」查看账号记录和状态。若任务仍提示账号异常，请把账号编号、任务时间和界面提示原文提供给支持人员；不要发送密码、Cookie 或验证码。
|