--- 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 或验证码。