docs: sediment TUTORIAL_SURFACES contract for README vs tutorial and three entry surfaces

README.md

@@ -1,12 +1,13 @@
 ---
-description: "用用户能理解的方式说明这个技能能做什么、适合什么场景，以及如何开始使用。"
+description: "用用户能理解的方式说明这个技能能做什么、适合什么场景，以及边界与结果形态。"
 ---
 
 > **模板说明（复制后删除本段）**  
-> 本文是技能市场详情与普通用户说明，**不是** Agent 参考索引、CLI 契约或开发文档。  
-> frontmatter 的 `description` 必须是用户能看懂的一句话能力描述；**不得**写成 CLI、schema、references、development、契约、数据结构、开发规范或 Agent 参考索引。  
-> 正文只回答用户关心的问题，**不要**把 Playwright、DOM、Python、RPA、references、development、schema 等作为面向用户的主说明内容；若业务上必须出现技术词，须用用户能理解的方式解释，且不能喧宾夺主。  
-> **复制后验收章节（标题可微调，建议保留）：**「能帮你做什么」「适合什么场景」「使用前需要准备什么」「你可以这样告诉 Agent」「执行后你会得到什么」「注意事项」「常见问题」。
+> 本文是技能市场 **「说明」** Tab（`readme_md`），**不是**使用教程。  
+> frontmatter 的 `description` 必须是用户能看懂的一句话能力描述；**不得**写成 CLI、schema、references、development、契约或「如何开始使用」类教程承诺。  
+> **禁止**写入：分步操作（1/2/3）、Agent 示例话术块、「入口一/入口二」专章、逐步排障。这些一律写在根目录 `TUTORIAL.md`。  
+> 正文只回答：是什么、能做什么、适合谁、准备什么、得到什么、注意事项。完整契约见 `development/TUTORIAL_SURFACES.md` §1。  
+> **复制后验收章节（标题可微调）：**「能帮你做什么」「适合什么场景」「使用前需要准备什么」「怎么使用」「执行后你会得到什么」「注意事项」「常见问题」。
 
 # 【技能名称】
 
@@ -17,7 +18,7 @@ description: "用用户能理解的方式说明这个技能能做什么、适合
 
 ## 这个技能能帮你做什么
 
-用 3 到 6 条业务能力说明技能价值，例如：
+用 3 到 6 条业务能力说明技能价值（**不要**写成操作步骤），例如：
 
 - 【自动整理/查询/生成/同步/核对/提交】某类业务数据
 - 帮你减少重复操作，降低人工录入或核对成本
@@ -38,42 +39,33 @@ description: "用用户能理解的方式说明这个技能能做什么、适合
 
 ## 使用前需要准备什么
 
-说明用户在使用前要准备的东西，例如：
+说明**前置条件**（装什么、要不要账号、要不要外站登录），**不要**写「去哪张表点哪个按钮」：
 
-- **网页自动化类：** 首次运行可由技能自动登记平台账号（浏览器会话由系统隔离管理）。也可在「账号管理」里指定登录标识。登记账号 ≠ 已登录目标站
-- **账号在哪里看：** 已登记账号可在「数据管理 / 账号管理」中查看；每个账号使用独立浏览器会话，批量或多账号任务不会共用登录状态
-- **是否要登录目标站：** 按本技能说明（有的平台必须登录，有的公开页可不登录）；与「是否有账号记录」不是一回事
+- **网页自动化类：** 可能需要在账号管理中登记平台账号；登记账号 ≠ 已登录目标站（细节见使用教程）
 - 相关业务权限（查询、导出、提交等）已具备
-- 需要处理的文件、时间范围、订单号、客户名称、项目名称等信息
-- 如果涉及验证码或人工确认，请保证能及时在弹出的浏览器窗口中操作
+- 需要处理的文件、时间范围、单号等信息（若适用）
+- 若涉及验证码或人工确认，使用时请能及时在弹出窗口中操作
 
 ---
 
-## 你可以这样告诉 Agent
+## 怎么使用
 
-用自然语言示例展示用户可以怎么发起任务，例如：
+本技能支持哪些宿主入口，用**一两句话**概括即可，例如：
 
-> “帮我查询今天的【业务对象】，整理成表格。”
->
-> “帮我核对这些【数据/单据】是否有异常，并告诉我问题在哪里。”
->
-> “帮我把【时间范围】内的【业务数据】导出并生成处理报告。”
->
-> “帮我根据这个文件里的内容，逐条完成【业务动作】。”
+- 支持 **数据管理**（点表操作）与 **对话任务**（自然语言）；是否提供定时任务按本技能说明。
 
-> 注意：示例应是自然语言，不要写命令行命令。
+**逐步操作、示例话术与排障，请查看技能市场「使用教程」Tab。**  
+（完整写法见 `development/TUTORIAL_SURFACES.md`。）
 
 ---
 
 ## 执行后你会得到什么
 
-说明用户会看到什么结果，例如：
+说明用户会看到什么**结果形态**（不要教如何点出来），例如：
 
 - 任务是否成功完成
-- 处理了多少条数据
-- 哪些内容成功、哪些失败
-- 失败原因和建议处理方式
-- 生成的文件、表格、报告或记录
+- 处理了多少条数据；哪些成功、哪些失败
+- 生成的文件、表格、报告或业务表记录
 
 ---
 
@@ -90,18 +82,16 @@ description: "用用户能理解的方式说明这个技能能做什么、适合
 
 ## 常见问题
 
-### 为什么任务没有查到数据？
+> FAQ 写**概念与边界**；需要「点哪里」的排障写到「使用教程」。
 
-> 可能是时间范围、关键词、账号权限或系统筛选条件不正确。请先确认输入信息是否准确。
+### 这个技能适合我吗？
 
-### 为什么任务执行到一半需要我操作？
+> 若你的场景与上文「适合什么场景」一致，可以安装后按「使用教程」完成第一次操作。
 
-> 可能遇到了登录、验证码、权限确认、二次审批或系统异常。请根据 Agent 的提示完成必要操作。
+### 我不会操作，从哪里开始？
 
-### 结果文件在哪里查看？
-
-> 请根据 Agent 返回的结果说明查看生成文件、任务记录或处理报告。
+> 请打开技能市场 **「使用教程」** Tab，按「入口一：数据管理」或「入口二：对话任务」任选一种跟做。
 
 ### 已经登记的账号在哪里查看？
 
-> 请到匠厂的「数据管理 / 账号管理」查看账号记录和状态。若任务仍提示账号异常，请把账号编号、任务时间和界面提示原文提供给支持人员；不要发送密码、Cookie 或验证码。
+> 请到匠厂的「数据管理 / 账号管理」查看账号记录和状态。不要发送密码、Cookie 或验证码。