98 lines
4.0 KiB
Markdown
98 lines
4.0 KiB
Markdown
---
|
||
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 或验证码。
|