# Plantask Usage

> 指导何时及如何调用 task_create、task_get、task_update、task_list 工具。适用于用户说「加番茄钟」「新增任务」「标记完成」「列出任务」「今天的待办」等任务级操作场景。

- Skill: `vh992098059/plantask-usage` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vh992098059/plantask-usage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vh992098059/plantask-usage/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vh992098059 (https://skillmd.com/u/vh992098059)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vh992098059/plantask-usage

---


# PlantTask 工具使用指南

## 工具与触发场景

| 工具 | 触发关键词 | 典型用户表述 |
|------|------------|--------------|
| **task_create** | 加、新增、开始、创建 | 「加一个番茄钟」「新增任务」「开始一个番茄」「加一个待办」 |
| **task_list** | 列出、看看、有哪些、今天的 | 「列出任务」「今天的任务」「看看计划」「有哪些番茄钟」 |
| **task_update** | 完成、标记、更新、做完了 | 「标记完成」「把第三步标成完成」「这个做完了」「更新任务状态」 |
| **task_get** | 详情、具体、第X个 | 需要获取某个任务的具体内容时 |

## 调用规则

1. **静默直接调用**：需要调用时，先调用工具，收到结果后再一次性输出完整回复。禁止先输出「正在检查」「我先看看」等过渡句。
2. **任务 vs 计划**：plantask 管**任务粒度**（番茄钟、待办项）；整份学习计划用 save_plan/read_plan。
3. **数据形态**：任务为结构化 JSON，本地默认存于 `Files/plantask/`（见配置 `plantask.baseDir`）。

## 常见流程

- 用户说「加一个番茄钟」→ 调用 task_create
- 用户说「列出今天的任务」→ 调用 task_list
- 用户说「第三步做完了」→ 先 task_list 或 task_get 定位任务，再 task_update 更新状态