chore: auto release commit (2026-07-03 12:09:55)

SKILL.md

@@ -1,101 +1,54 @@
 ---
-name: 技能开发模板（通用业务版）
-description: "OpenClaw 通用业务技能开发模板，供复制后定制新业务 skill。定制步骤见 development/DEVELOPMENT.md。"
-version: 1.0.32
+name: Amazon 结算报表自动下载
+description: "在 Amazon 卖家中心自动请求并下载结算报表（Settlement）"
+version: 1.0.0
 author: 深圳匠厂科技有限公司
 metadata:
   openclaw:
-    slug: your-skill-slug
+    slug: download-settlement-report-amazon
     platform_kit_min_version: "1.0.17"
-    emoji: "📦"
-    category: "通用"
+    emoji: "📊"
+    category: "跨境电商"
     developer_ids:
       - 10032
-      - 12428
+      - 12500
 allowed-tools:
   - bash
+dependencies:
+  required:
+    - account-manager
 ---
 
-# 技能开发模板（skill-template）
+# Amazon 结算报表自动下载
 
-这是一个**用于复制的新技能模板**，不是业务 skill 本身。复制后请替换占位内容，实现你的真实业务逻辑。
+在 Amazon 卖家仿真中心自动请求并下载结算报表（Settlement），产出 xlsx 文件并写入任务日志。
 
 ## 面向用户问答（LLM 规则）
 
 - 本文（`SKILL.md`）是 LLM / OpenClaw 平台读取的技能入口，**不是**用户市场说明。
-- 根目录 `README.md` 是面向普通用户的说明。
+- 根目录 `README.md` 是面向普通用户的说明（用户市场详情页主来源）。
 
-当用户询问以下问题时，**必须优先读取**根目录 `README.md`，并用用户能理解的业务语言回答：
-
-- 这个技能是做什么的
-- 这个技能怎么用
-- 适合什么场景
-- 使用前要准备什么
-- 执行后会得到什么
-- 能不能帮我完成某个业务任务
+当用户询问技能用途、场景、准备事项、结果形态等业务问题时，**必须优先读取**根目录 `README.md`，并用用户能理解的业务语言回答。
 
 - **不要**把 `SKILL.md`、`references/`、`development/` 中的技术细节直接作为用户回答。
-- **只有当**用户明确询问命令、参数、输出结构、开发、调试、集成或排错时，才读取 `references/` 或 `development/`。
-- 若 `README.md` 与 `SKILL.md` / `references` 表述冲突：对用户展示与市场说明以 `README.md` 为准；对执行契约、CLI、schema、运行约束以 `SKILL.md` / `references` 为准。
-- 回答用户时**不要**暴露 Playwright、DOM、Python、RPA 等实现细节，除非用户明确询问技术实现。
-- 用户未问技术实现时，**不要**讨论 slug 命名规则；开发者问命名或 slug 时，读取 `development/NAMING.md`。
-
-## 文档分工
-
-| 文档 | 读者 | 用途 |
-|------|------|------|
-| 根目录 `README.md` | 普通用户 | 技能市场详情页说明（`metadata.readme_md` 主来源） |
-| `SKILL.md`（本文） | LLM / OpenClaw 平台 | 技能入口、触发与运行契约摘要 |
-| `references/` | Agent 编排/调用 | 渐进式加载：CLI 契约、字段 schema 等 |
-| `development/` | 开发者 / AI 编程代理 | 需求、开发教程、测试、技术规范 |
-
-## 目录约定
-
-复制后建议保留：
-
-- `assets/`、`development/`、`evals/`、`references/`、`scripts/`、`tests/`
-- CLI 入口固定为 `scripts/main.py`
-- 业务逻辑按 `cli / db / service / util` 分层
-
-## 最小命令
-
-```bash
-python {baseDir}/scripts/main.py health
-python {baseDir}/scripts/main.py config-path
-python {baseDir}/scripts/main.py version
-```
-
-配置：仓库 `.env.example` 为模板；用户 `.env` 在 `{JIANGCHANG_DATA_ROOT}/{JIANGCHANG_USER_ID}/{slug}/.env`，启动时自动 bootstrap。优先级：进程环境变量 > 用户 `.env` > `.env.example`。
+- 用户未问技术实现时，**不要**讨论 Playwright、RPA 等细节。
 
 ## 运行依赖
 
 - Python 运行环境由匠厂宿主注入**共享 runtime**：`{JIANGCHANG_DATA_ROOT}/python-runtime/.venv`。
 - 公共能力来自共享 runtime 安装的 `jiangchang-platform-kit>=1.0.17`（`jiangchang_skill_core` 包）；**不要 vendor** `scripts/jiangchang_skill_core/`，新技能不得在仓库内保留该目录副本。
-- config、logging、runtime_env、rpa、media-assets、video_session、runtime_diagnostics 等均从共享 venv 的 `jiangchang_skill_core` import，而非技能目录副本。
-- 根目录 `requirements.txt` **只声明技能特有** Python 三方依赖；`jiangchang-platform-kit`、`playwright` 等公共能力由宿主共享 runtime 提供，**不要**写入技能 requirements。
-- `metadata.openclaw.platform_kit_min_version`（当前 `1.0.17`）是运行契约/兼容性声明，供宿主安装与启用时校验，**不是**技能 pip 依赖声明。
-- Skill 代码**不要**自行 `pip install`；系统级依赖（如 VC++ Runtime）仅在 `health` / preflight 中提示用户安装。
-- `health` 使用 `collect_runtime_diagnostics` 输出统一 runtime 诊断（只读，不下载/修复 media-assets）。
+- config、logging、runtime_env、rpa、video_session 等均从共享 venv 的 `jiangchang_skill_core` import。
+- 根目录 `requirements.txt` **只声明技能特有** Python 三方依赖；`playwright` 等公共能力由宿主共享 runtime 提供。
+- Skill 代码**不要**自行 `pip install playwright`；**不要**在技能内 `playwright install`。
+- 浏览器 RPA 档位：`OPENCLAW_TEST_TARGET=simulator_rpa`；CI 默认 `mock`。
+- 账号由 `account-manager` 提供（platform_key=`amazon_sim`）。
 
-## 定制入口
+## 最小命令
 
-1. 复制目录为你的新 skill 仓库，全局替换 `your-skill-slug` 等占位词。
-2. 按 `development/DEVELOPMENT.md` 完成开发与文档定制。
-3. 用户市场说明写入根 `README.md`；Agent 调用契约见 `references/CLI.md`、`references/SCHEMA.md`。
-4. 同步修改 `scripts/util/constants.py` 中的 `SKILL_SLUG` / `SKILL_VERSION`。
-5. 本地 SQLite 的中文表名/字段名、标准时间字段与字段顺序规范见 `references/SCHEMA.md`（元数据表 `_jiangchang_*` + `CREATE TABLE` 物理顺序）。
+```bash
+python {baseDir}/scripts/main.py health
+python {baseDir}/scripts/main.py version
+python {baseDir}/scripts/main.py run --date-from 2025-12-01 --date-to 2025-12-31
+```
 
-## 技能命名与 slug
-
-- 标准格式：`{verb}-{noun-phrase}-{platform}`（详见 `development/NAMING.md`）。
-- slug / repo / 目录 / `SKILL_SLUG` / DB 文件名：**英文** kebab-case；`name`、`description`、根 `README.md`：**中文**。
-- 复制为新业务技能前**必须**阅读 `development/NAMING.md`。
-- `name`（frontmatter）：**用户可见的中文业务名称**；`description` 是说明，不是名称。
-- `metadata.openclaw.slug`：**英文 kebab-case** 机器标识；目录名、默认 `{slug}.db` 使用 slug，不使用中文。
-- 复制后全局替换 `your-skill-slug`；正式技能不得保留英文占位 `name` 或 slug。
-
-## 平台元数据
-
-- `metadata.openclaw.developer_ids`：技能发布后的默认开发者可见用户 ID 列表。
-- 当 `access_scope = 0`（不公开）时，平台会把 `developer_ids` 中的用户自动补写到 `skill_user_access`。
-- `developer_ids` 建议写为正整数数组；第一个 ID 会作为主开发者同步到 `skills.developer_id`。
+执行契约见 `references/CLI.md`。