chore: auto release commit (2026-06-14 11:12:03)

references/README.md

@@ -1,77 +1,13 @@
----
-description: "用用户能理解的方式说明这个技能能做什么、适合什么场景，以及如何开始使用。"
----
+# Agent 参考索引
 
-# 【技能名称】
+本目录供 Agent **运行、编排、调用** skill 时渐进式加载，不是用户市场说明。
 
-用一两句话说明这个技能帮助用户完成什么工作。  
-这里不要解释技术实现，要从用户的业务目标出发描述价值。
+| 文档 | 用途 |
+|------|------|
+| 根目录 [`README.md`](../README.md) | 用户市场详情页说明 |
+| [`SKILL.md`](../SKILL.md) | LLM / OpenClaw 平台技能入口 |
+| [`CLI.md`](CLI.md) | 命令行入口、参数与调用契约 |
+| [`SCHEMA.md`](SCHEMA.md) | 输入输出、数据库与字段说明 |
+| [`../development/`](../development/) | 开发、测试、技术规范（给开发者 / AI 编程代理） |
 
-## 这个技能能帮你做什么
-
-用 3 到 6 条业务能力说明技能价值，例如：
-
-- 【自动整理/查询/生成/同步/核对/提交】某类业务数据
-- 帮你减少重复操作，降低人工录入或核对成本
-- 在任务完成后给出清晰的处理结果、失败原因或后续建议
-
-## 适合什么场景
-
-列出典型使用场景。请使用用户熟悉的业务语言，例如：
-
-- 每天需要重复处理同一类订单、单据、报表或客户资料
-- 需要从多个系统中查询信息并汇总结果
-- 需要按固定规则检查数据是否完整、是否异常
-- 需要把处理结果保存为文件、记录或任务报告
-
-## 使用前需要准备什么
-
-说明用户在使用前要准备的东西，例如：
-
-- 相关账号已登录，且具备查询、导出或提交权限
-- 需要处理的文件、时间范围、订单号、客户名称、项目名称等信息
-- 如果涉及外部系统，请确认网络、账号、验证码或审批流程可正常使用
-
-## 你可以这样告诉 Agent
-
-用自然语言示例展示用户可以怎么发起任务，例如：
-
-- “帮我查询今天的【业务对象】，整理成表格。”
-- “帮我核对这些【数据/单据】是否有异常，并告诉我问题在哪里。”
-- “帮我把【时间范围】内的【业务数据】导出并生成处理报告。”
-- “帮我根据这个文件里的内容，逐条完成【业务动作】。”
-
-注意：示例应是自然语言，不要写命令行命令。
-
-## 执行后你会得到什么
-
-说明用户会看到什么结果，例如：
-
-- 任务是否成功完成
-- 处理了多少条数据
-- 哪些内容成功、哪些失败
-- 失败原因和建议处理方式
-- 生成的文件、表格、报告或记录
-
-## 注意事项
-
-用用户能理解的方式说明边界和风险，例如：
-
-- 请确认输入范围准确，避免处理错数据
-- 涉及提交、付款、删除、审批等高风险动作时，技能应在执行前请求确认
-- 如果外部系统登录失效、权限不足或页面变化，任务可能需要用户介入
-- 不建议在未核对数据的情况下直接执行批量操作
-
-## 常见问题
-
-### 为什么任务没有查到数据？
-
-可能是时间范围、关键词、账号权限或系统筛选条件不正确。请先确认输入信息是否准确。
-
-### 为什么任务执行到一半需要我操作？
-
-可能遇到了登录、验证码、权限确认、二次审批或系统异常。请根据 Agent 的提示完成必要操作。
-
-### 结果文件在哪里查看？
-
-请根据 Agent 返回的结果说明查看生成文件、任务记录或处理报告。
+按需阅读：编排任务时优先 `CLI.md`；解析结构化字段时读 `SCHEMA.md`；运行时环境细节见 `../development/RUNTIME.md`。