64 lines
2.2 KiB
Markdown
64 lines
2.2 KiB
Markdown
> **模板说明（复制后删除本段）**
|
||
> 本文对应技能市场 **「使用教程」** Tab（发布时同步为 `tutorial_md`）。
|
||
> 面向普通用户写**可跟着做的步骤**，不要写 CLI、目录结构、release、开发规范。
|
||
> 与根 `README.md`（技能说明）分工：README 讲「是什么 / 能做什么」；本文讲「第一次怎么用完」。
|
||
> **复制后验收章节（标题可微调）：**「开始前」「第一步…」「第二步…」「常见卡住怎么办」。
|
||
|
||
# 【技能名称】使用教程
|
||
|
||
用最短路径带用户完成一次成功使用。步骤要具体，可用「打开匠厂 → …」这类操作语言。
|
||
|
||
---
|
||
|
||
## 开始前
|
||
|
||
确认：
|
||
|
||
1. 已安装并登录匠厂客户端
|
||
2. 已在技能市场安装本技能（或更新到最新版）
|
||
3. 【如需】相关账号已登录、权限可用；需要的文件 / 时间范围 / 单号等已准备好
|
||
|
||
---
|
||
|
||
## 第一步：打开技能并说清目标
|
||
|
||
在匠厂里新建任务或打开对话，用自然语言说明要做什么，例如：
|
||
|
||
> “帮我【完成某件业务事】，范围是【时间 / 对象 / 条件】。”
|
||
|
||
建议一次只交代一件事；范围说清楚，减少来回确认。
|
||
|
||
---
|
||
|
||
## 第二步：按提示补充信息
|
||
|
||
如果 Agent 问你缺什么（账号、文件、筛选条件），按提示补充即可。
|
||
|
||
- 有文件时：按界面提示选择或拖入
|
||
- 有账号时：确认已在对应平台登录，且具备操作权限
|
||
|
||
---
|
||
|
||
## 第三步：等待结果并核对
|
||
|
||
任务结束后，请核对：
|
||
|
||
- 是否成功完成
|
||
- 处理了多少条 / 哪些失败
|
||
- 生成的文件、表格或记录是否在预期位置
|
||
|
||
若失败，先看失败原因说明，再按下一节排查。
|
||
|
||
---
|
||
|
||
## 常见卡住怎么办
|
||
|
||
| 现象 | 你可以先试 |
|
||
|------|------------|
|
||
| 提示未登录 / 无权限 | 确认匠厂已登录；业务账号是否在线、权限是否足够 |
|
||
| 提示缺少必要信息 | 把时间范围、单号、文件等说完整后再试一次 |
|
||
| 一直没有结果 | 到任务中心查看进度或失败原因；必要时重新发起 |
|
||
| 结果不对 | 用更明确的条件再说一次，或缩小范围重试 |
|
||
|
||
仍无法解决时，把「你说了什么 + 界面提示原文」发给支持人员，便于排查。
|