---
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）。