chore: auto release commit (2026-06-13 14:59:54)

references/README.md

@@ -1,64 +1,83 @@
 ---
-description: "规范化的新技能模板说明；复制后替换名称、CLI 示例与 task_service 等业务实现。"
+description: "用用户能理解的方式说明这个技能能做什么、适合什么场景，以及如何开始使用。"
 ---
 
-# 技能模板说明
+# 【技能名称】
 
-这个仓库是**给开发者复制的新技能模板**，不是终端用户直接调用的业务 skill。
+用一两句话说明这个技能帮助用户完成什么工作。  
+这里不要解释技术实现，要从用户的业务目标出发描述价值。
 
-## 它提供什么
+## 这个技能能帮你做什么
 
-- 标准目录结构
-- 最小 CLI 入口（`run` / `logs` / `log-get` / `health` / `version`）
-- 通用任务日志表骨架（`task_logs`）
-- `service` 层占位模块（`task_service.py`、通用 `sibling_bridge.py`）
-- 成熟的隔离测试体系（IsolatedDataRoot、FakeAdapter、6 档测试 target、profile 策略）
-- 与现有规范 skill 一致的发布脚本与 GitHub workflow
+用 3 到 6 条业务能力说明技能价值，例如：
 
-## 复制后你需要改什么
+- 【自动整理/查询/生成/同步/核对/提交】某类业务数据
+- 帮你减少重复操作，降低人工录入或核对成本
+- 在任务完成后给出清晰的处理结果、失败原因或后续建议
 
-- `SKILL.md` 中的名称、描述、slug、触发说明
-- `SKILL.md` 中 `metadata.openclaw.developer_ids`（如需让非公开技能默认授权给开发者查看）
-- `references/CLI.md` 里的命令示例
-- `scripts/util/constants.py` 中的 slug / 版本 / logger 名
-- `scripts/service/task_service.py` 中的 `cmd_run` 真实业务逻辑
-- 如有特定 task_type，在 `references/SCHEMA.md` 中补充字段映射说明
+## 适合什么场景
 
-## `developer_ids` 是做什么的
+列出典型使用场景。请使用用户熟悉的业务语言，例如：
 
-`metadata.openclaw.developer_ids` 是平台发布元数据，不是终端用户文案。
+- 每天需要重复处理同一类订单、单据、报表或客户资料
+- 需要从多个系统中查询信息并汇总结果
+- 需要按固定规则检查数据是否完整、是否异常
+- 需要把处理结果保存为文件、记录或任务报告
 
-它用于声明：当技能发布后，如果平台侧将该技能设置为 `access_scope = 0`（不公开），哪些开发者用户仍应自动获得可见权限。
+## 使用前需要准备什么
 
-约定如下：
+说明用户在使用前要准备的东西，例如：
 
-- 字段位置：`SKILL.md` -> `metadata.openclaw.developer_ids`
-- 推荐格式：正整数数组，例如 `[1032, 12428]`
-- 发布效果：发布接口会把这些用户补写到 `skill_user_access`
-- 第一个 ID 会作为主开发者同步到 `skills.developer_id`
+- 相关账号已登录，且具备查询、导出或提交权限
+- 需要处理的文件、时间范围、订单号、客户名称、项目名称等信息
+- 如果涉及外部系统，请确认网络、账号、验证码或审批流程可正常使用
 
-如果你的技能本来就是公开技能，或暂时不需要开发者专属可见性，这个字段可以留空数组。
+## 你可以这样告诉 Agent
 
-## 不建议再保留的旧结构
+用自然语言示例展示用户可以怎么发起任务，例如：
 
-- 旧模板里的 `docs/`
-- 旧模板里的 `optional/`
-- 旧入口 `scripts/skill_main.py`
+- “帮我查询今天的【业务对象】，整理成表格。”
+- “帮我核对这些【数据/单据】是否有异常，并告诉我问题在哪里。”
+- “帮我把【时间范围】内的【业务数据】导出并生成处理报告。”
+- “帮我根据这个文件里的内容，逐条完成【业务动作】。”
 
-新模板统一使用 `scripts/main.py` 作为入口。
+注意：示例应是自然语言，不要写命令行命令。
 
-## 参考文档索引
+## 执行后你会得到什么
 
-| 文档 | 内容 |
-|------|------|
-| `DEVELOPMENT.md` | 从复制模板到开发出新 skill 的完整教程 |
-| `RUNTIME.md` | 运行时目录结构与 `CLAW_*` 环境变量约定 |
-| `CLI.md` | CLI 命令与参数示例 |
-| `SCHEMA.md` | task_logs 与字段映射说明 |
-| `TESTING.md` | 测试 target 与隔离体系 |
-| **`RPA.md`** | **三端 RPA 标准（浏览器/桌面/手机）：选型、拟人操作、反反爬、人工兜底、存证** |
-| **`ADAPTER.md`** | **真实/仿真 × API/RPA 四档适配器模式** |
-| **`CONFIG.md`** | **`.env` 配置规范与首次自动落盘机制** |
-| `REQUIREMENTS.md` | 依赖与运行要求 |
+说明用户会看到什么结果，例如：
 
-> 开发"操作浏览器/桌面/手机"或"对接 ERP/CRM/SaaS/银行"类 skill 前，**务必先读 `RPA.md` + `ADAPTER.md` + `CONFIG.md`** 这三份标准，避免重复踩坑。
+- 任务是否成功完成
+- 处理了多少条数据
+- 哪些内容成功、哪些失败
+- 失败原因和建议处理方式
+- 生成的文件、表格、报告或记录
+
+## 注意事项
+
+用用户能理解的方式说明边界和风险，例如：
+
+- 请确认输入范围准确，避免处理错数据
+- 涉及提交、付款、删除、审批等高风险动作时，技能应在执行前请求确认
+- 如果外部系统登录失效、权限不足或页面变化，任务可能需要用户介入
+- 不建议在未核对数据的情况下直接执行批量操作
+
+## 常见问题
+
+### 为什么任务没有查到数据？
+
+可能是时间范围、关键词、账号权限或系统筛选条件不正确。请先确认输入信息是否准确。
+
+### 为什么任务执行到一半需要我操作？
+
+可能遇到了登录、验证码、权限确认、二次审批或系统异常。请根据 Agent 的提示完成必要操作。
+
+### 结果文件在哪里查看？
+
+请根据 Agent 返回的结果说明查看生成文件、任务记录或处理报告。
+
+## 给技能开发者的填写提醒
+
+复制这个模板创建新技能后，请把本文中的【占位内容】替换成真实业务说明。  
+请始终从用户视角描述技能价值，不要把实现方式、代码文件、测试方法、发布流程写在这里。  
+技术实现细节应写入开发文档，而不是用户说明页。