skill-template/TUTORIAL.md

模板说明（复制后删除本段）
本文对应技能市场 「使用教程」 Tab（发布时同步为 tutorial_md）。
面向普通用户写可跟着做的步骤，不要写 CLI、目录结构、release、开发规范。
与根 README.md（技能说明）分工：README 讲「是什么 / 能做什么 / 边界」；本文讲「从哪个入口怎么用完」。
完整契约： development/TUTORIAL_SURFACES.md（三入口结构、说明≠教程、skill-detail 不可作主路径）。
复制后验收章节（标题可微调，语义不可缺）：「本技能做什么」「开始前」「入口一：数据管理」「入口二：对话任务」「入口三：定时任务」「主能力对照表」「常见卡住怎么办」。
若本技能 §0.1 未挂数据管理 / 对话 / 定时，对应入口节改为「不适用」并写一句理由（与 REQUIREMENTS 一致）。
标题层级： 宿主页头已有技能名、Tab 已有「使用教程」——禁止文首再写 # 技能名 · 使用教程；正文主分节用 ##，步骤用 ###。

本技能有两种平行的使用方式（按本技能入口定位填写；未挂的入口删掉或写不适用）：

• 数据管理：在左侧表上点工具栏 / 行内按钮
• 对话任务：用自然语言让 Agent 完成同一能力

两种方式触发同一套业务能力，结果一致，选你习惯的即可。
定时任务是否提供：见下方「入口三」（没有则写「本技能不需要定时」+ 理由）。

---

本技能做什么

用业务语言画清闭环（不要写库表英文名或命令行），例如：

【输入/准备】 → 【核心动作】 → 【结果可见处】 → 【可选报告/导出】

• 输入：……
• 输出：……
• 说明：边界（教学/正式、是否接外站等）

---

开始前

确认：

1. 已安装并登录匠厂客户端
2. 已在技能市场安装本技能（建议更新到最新版）
3. 【网页自动化类】账号登记 / 目标站登录要求（按本技能；登记 ≠ 已登录）
4. 【如需】文件 / 时间范围 / 单号等已准备好
5. 【如需】首次须先完成「载入样例 / 导入 / 同步」等准备动作（见入口一或入口二）

---

入口一：数据管理

若本技能无业务表、无 toolbar/row/batch：整节改为「不适用」+ 理由。

适合：对照数据、喜欢点界面、机房/运营用户。

左侧各表是干什么的

表名（中文）	作用
【表 A】	……
【表 B】	……

首次准备（若需要）

1. 进入 数据管理 → 【主表】
2. 点击表顶 「【准备类按钮 label】」（若为空表可点，写明是否须选中行）
3. 成功后应看到：……

注意： 准备/载入/导入类按钮须挂在数据管理 toolbar（用户看得见）。不要把「技能详情页点按钮」写成主路径——详情页常只显示四 Tab，不一定渲染 Action 按钮。

主流程

1. 进入 【主表】
2. 【是否选中行】
3. 点击 「【主能力 label】」
4. 到 【结果表 / 任务中心 / 报告】 核对结果

行级 / 批量（若有）

你想做什么	操作
……	【表】 行内 → 「【label】」
……	勾选多行 → 「【label】」

---

入口二：对话任务

若本技能不挂 agent：整节改为「不适用」+ 理由。

适合：临时提问、要解释、不想切换表。

什么时候用对话

• ……
• 与入口一效果相同；习惯看表时优先用数据管理

示例话术

你想做什么	可以这样说
……	「……」
……	「……」

Agent 可能追问什么

• 缺参数时：……
• 失败时：可改用数据管理点按钮

---

入口三：定时任务

有 cron： 写如何新建定时、选哪个 Action、默认参数、预期结果。
无 cron： 用下面「不需要」模板，删掉「如何配置」小节。

本技能不需要定时时（示例文案，按需保留/改写）

本技能未提供定时任务入口，原因：【一次性 / 须人指定对象 / 须当场确认 / ……】。
请使用 数据管理 或 对话任务。

本技能需要定时时（示例结构）

1. 打开侧栏 定时任务 → 新建
2. 选择本技能 → Action 「【label】」
3. 填写参数 → 保存；可「立即运行」验证
4. 到点后在【结果表 / 任务中心】查看

---

主能力对照表

同一能力，两种主入口（按本技能实际填写；只挂一端的注明）：

想做什么	数据管理	对话任务
……	【表】 → 「【label】」	「……」
……	……	……

按钮名必须与 assets/actions.json 的 label 一致。

---

常见卡住怎么办

现象	你可以先试
主表是空的	先做「首次准备」或对话载入/导入
按钮点不了	是否须先选中行；是否装错版本
一直没有结果	看任务中心 / 运行日志；async 任务看进度
【网页自动化】未登录 / 无权限	确认账号在线与目标站登录状态
结果不对	缩小范围重试，或改用数据管理核对表数据

仍无法解决时，把「你用的入口 + 操作步骤 + 界面提示原文」发给支持人员。