test

examples/todo_skill/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: 待办事项 demo
+description: "匠厂 skill-template 的教学型 demo：用待办事项场景演示分层架构、CLI 契约、Action manifest 与 sync/async 双形态。"
+version: 0.1.0
+author: demo
+metadata:
+  openclaw:
+    slug: todo-skill
+    platform_kit_min_version: "1.2.11"
+    emoji: "✅"
+    category: "通用"
+    developer_ids:
+      - 1
+allowed-tools:
+  - bash
+---
+
+# 待办事项 demo（todo-skill）
+
+这是匠厂 [`skill-template`](../../SKILL.md) 的**教学型 demo**，用最简单的待办事项业务
+复刻模板的所有关键模式。它**不是**真实业务技能，自带一份 mock 平台库以便脱离宿主运行。
+
+## 关键模式映射
+
+| 模板铁律 | 本 demo 落地 |
+|----------|-------------|
+| `cli → service → db → util` 四层 | [scripts/](scripts/) 完整复刻同结构 |
+| 单业务内核、多入口 | `service/todo_service.py` 是唯一 CRUD 内核，CLI/Action/数据管理按钮都调它 |
+| CLI 固定入口 | [scripts/main.py](scripts/main.py) + `cli/app.py` argparse 分发 |
+| Action manifest 正交字段 | [assets/actions.json](assets/actions.json) 覆盖 6 placements × sync/async |
+| 数据管理元数据 | [scripts/db/connection.py](scripts/db/connection.py) 建 `todos` + `_jiangchang_*` |
+| 长任务 async 范式 | [service/task_service.py](scripts/service/task_service.py) `cmd_remind` 用 `job_context`/`emit`/`finish` |
+
+## Agent 触发路由表（demo）
+
+| 用户意图 | Agent 怎么做 | 进任务中心？ |
+|----------|--------------|--------------|
+| 看版本 / 检查环境 | bash + 共享 Python `version` / `health` | 否 |
+| 列出 / 统计 / 新增 / 完成 / 删除 | bash + `todo list/stats/add/done/delete` | 否（sync） |
+| 扫描并提醒 | `run_skill_action` → `remind`（async） | **是** |
+
+## 独立运行
+
+详见 [README.md](README.md)。设 `JIANGCHANG_DATA_ROOT` + `JIANGCHANG_USER_ID` 后可直接 `python scripts/main.py <cmd>` 跑通。
+
+## 与真实模板的差异
+
+本 demo 自带 `_mock_platform/jiangchang_skill_core`，**真实技能不得 vendor 平台库**。
+其它省略项：RPA/视频、鉴权、HTML 报告、统一文件日志（详见 README）。