Files
skill-template/TUTORIAL.md
chendelian ec049fdc2a
All checks were successful
技能自动化发布 / release (push) Successful in 13s
feat(docs): add market four-tab materials (tutorial/demo/changelog) for v1.0.46
2026-07-17 11:55:29 +08:00

2.2 KiB
Raw Blame History

模板说明(复制后删除本段)
本文对应技能市场 「使用教程」 Tab发布时同步为 tutorial_md)。
面向普通用户写可跟着做的步骤,不要写 CLI、目录结构、release、开发规范。
与根 README.md技能说明分工README 讲「是什么 / 能做什么」;本文讲「第一次怎么用完」。
复制后验收章节(标题可微调):「开始前」「第一步…」「第二步…」「常见卡住怎么办」。

【技能名称】使用教程

用最短路径带用户完成一次成功使用。步骤要具体,可用「打开匠厂 → …」这类操作语言。


开始前

确认:

  1. 已安装并登录匠厂客户端
  2. 已在技能市场安装本技能(或更新到最新版)
  3. 【如需】相关账号已登录、权限可用;需要的文件 / 时间范围 / 单号等已准备好

第一步:打开技能并说清目标

在匠厂里新建任务或打开对话,用自然语言说明要做什么,例如:

“帮我【完成某件业务事】,范围是【时间 / 对象 / 条件】。”

建议一次只交代一件事;范围说清楚,减少来回确认。


第二步:按提示补充信息

如果 Agent 问你缺什么(账号、文件、筛选条件),按提示补充即可。

  • 有文件时:按界面提示选择或拖入
  • 有账号时:确认已在对应平台登录,且具备操作权限

第三步:等待结果并核对

任务结束后,请核对:

  • 是否成功完成
  • 处理了多少条 / 哪些失败
  • 生成的文件、表格或记录是否在预期位置

若失败,先看失败原因说明,再按下一节排查。


常见卡住怎么办

现象 你可以先试
提示未登录 / 无权限 确认匠厂已登录;业务账号是否在线、权限是否足够
提示缺少必要信息 把时间范围、单号、文件等说完整后再试一次
一直没有结果 到任务中心查看进度或失败原因;必要时重新发起
结果不对 用更明确的条件再说一次,或缩小范围重试

仍无法解决时,把「你说了什么 + 界面提示原文」发给支持人员,便于排查。