50 lines
2.1 KiB
Markdown
50 lines
2.1 KiB
Markdown
---
|
||
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）。
|