# Temporal Time Manager

> 时间管理 AI 助手 Skill，让 AI 通过对话直接管理你的任务、日程和灵感，数据同步至 aitimemg.cn 平台。

- Skill: `dvcrn/temporal-time-manager` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dvcrn/temporal-time-manager`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/temporal-time-manager/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/temporal-time-manager

---


# 时间管理 AI Skill

这个 Skill 让你的 AI 助手直接操作你在 [aitimemg.cn](https://www.aitimemg.cn) 的时间管理数据。

## 功能列表

| 工具名            | 说明                               |
| ----------------- | ---------------------------------- |
| `list_tasks`      | 获取所有任务                       |
| `create_task`     | 创建一个新任务                     |
| `update_task`     | 更新任务（标题、状态、截止日期等） |
| `delete_task`     | 删除指定任务                       |
| `list_schedules`  | 获取所有日程安排                   |
| `create_schedule` | 创建新日程                         |
| `update_schedule` | 更新日程                           |
| `delete_schedule` | 删除日程                           |
| `capture_idea`    | 快速捕获一条灵感/备忘              |

## 快速开始

### 1. 安装到你的 OpenClaw 机器人

```bash
openclaw skill install PANGKAIFENG/temporal-time-manager
```

### 2. 获取你的 API Token

1. 打开 [aitimemg.cn/settings](https://www.aitimemg.cn/settings)
2. 找到「🔑 API Token」板块，点击 **「生成 API Token」**
3. 复制生成的 Token（格式：`tmg_...`），**仅在生成时显示完整值，请立即保存**

### 3. 配置环境变量

在你的 OpenClaw 环境或 `.env` 文件中设置：

```bash
TEMPORAL_API_TOKEN=tmg_你的token     # 在 aitimemg.cn/settings 生成
TEMPORAL_BASE_URL=https://api.aitimemg.cn  # 可不填，默认即是
```


### 3. 开始对话

对话示例：

```
你：帮我查看今天的任务列表
助手：[调用 list_tasks] 你好，这是你今天的任务...

你：创建一个任务：明天下午3点开周会
助手：[调用 create_task] 已为你创建任务...

你：记录一个灵感：考虑接入 Notion 同步
助手：[调用 capture_idea] 已保存到你的灵感池...
```

## 使用方式（通过 mcporter）

```bash
# 列出任务
mcporter call temporal-time-manager list_tasks

# 创建任务
mcporter call temporal-time-manager create_task --args '{"title":"开会","due_date":"2026-02-28","priority":"high"}'

# 捕获灵感
mcporter call temporal-time-manager capture_idea --args '{"content":"这是一个灵感"}'
```

## 数据结构说明

### Task（任务）
- `id`: 唯一标识（UUID，调用方必须传入）
- `title`: 任务标题（必填）
- `notes`: 备注/描述
- `status`: 状态，可选值：`todo` / `done` / `abandoned`
- `group`: 四象限分类
  - `urgent_important`：重要且紧急
  - `important`：重要不紧急
  - `urgent`：紧急不重要
  - `neither`：不重要不紧急（默认）
- `executor_type`: 执行方式，可选值：`human`（纯人工）/ `ai_copilot`（AI协作）/ `ai_auto`（AI全自动）
- `project_id`: 所属项目 ID（可选）
- `created_at` / `updated_at`: 时间戳（ISO 8601，建议传入）

### Schedule（日程排班）
> 日程是"任务在某天某时段的排班记录"，与任务通过 `task_id` 关联。

- `id`: 唯一标识（UUID，调用方必须传入）
- `task_id`: 关联任务 ID（必填）
- `date`: 排班日期，格式 `YYYY-MM-DD`（必填）
- `planned_start`: 计划开始时间，**以小时为单位**（如 `9.5` = 09:30，`15.0` = 15:00）（必填）
- `planned_duration`: 计划时长，**以小时为单位**（如 `1.0` = 1小时，`1.5` = 90分钟）（必填）
- `is_all_day`: 是否全天任务（`true` 表示放入"今日待排班"槽，此时 `planned_start` 传 `0`）

### Idea（灵感/备忘）
- `id`: 唯一标识（UUID，后端自动生成）
- `content`: 内容文字（必填）
- `source`: 来源，如 `openclaw` / `feishu` / `web`（默认 `openclaw`）
- `meta`: 附加元数据（可选 JSON 对象）