# AI Task Management

> 零依赖、高性能的任务管理技能。当用户需要创建、查询、更新、删除任务或获取任务统计时使用此技能。

- Skill: `xfwgithub/ai-task-management` (Agent Skill, multi-file: 16 files)
- Install (CLI): `npx skillmds@latest add xfwgithub/ai-task-management`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xfwgithub/ai-task-management/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: xfwgithub (https://skillmd.com/u/xfwgithub)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xfwgithub/ai-task-management

---


## 触发条件

当用户提到以下关键词或意图时触发此技能：

### 创建任务
- "创建任务"、"新建任务"、"添加一个任务"、"帮我记个事"
- "我要做一个..."、"记得做..."、"提醒我..."

### 查询任务
- "查看任务"、"查询任务"、"我的任务"、"有什么任务"
- "待处理的任务"、"未完成的任务"

### 更新任务
- "更新任务"、"提交初审"、"取消任务"、"修改任务"
- "完成初核"
- "标记为已完成"、"删除任务"

### 任务统计
- "任务统计"、"任务概况"、"有多少任务"
- "完成情况如何"

### 任务详情
- "任务详情"、"查看某个任务"、"任务信息"

### 回收任务
- "回收任务"、"任务到期"、"重置任务状态"

### 删除任务
- "彻底删除"、"物理删除"、"删除任务"

### 更新技能
- "更新技能"、"升级技能"、"检查更新"


## 安装

### 方式一：一键安装（推荐）

这是最简单、最干净的安装方式，直接下载预编译二进制文件。

```bash
sudo curl -sL https://github.com/xfwgithub/aitask-skill/releases/latest/download/task-skill -o /usr/local/bin/task-skill
sudo chmod +x /usr/local/bin/task-skill

# 验证安装
task-skill --version
```

### 方式二：手动下载

```bash
# 下载最新版本的完整包
wget https://github.com/xfwgithub/aitask-skill/releases/latest/download/task-skill.zip
unzip task-skill.zip
cd task-skill
./task-skill --version
```

## 配置 AI Agent 技能

安装完成后，将 `SKILL.md` 复制到你的 AI Agent 技能目录：

```bash
# 下载 SKILL.md 到技能目录
mkdir -p ~/.agents/skills/task-management
curl -sL https://raw.githubusercontent.com/xfwgithub/aitask-skill/main/skills/task-management/SKILL.md -o ~/.agents/skills/task-management/SKILL.md
```

**重要说明**：
- ✅ 技能目录**只需要** `SKILL.md` 文件
- ✅ `task-skill` 是一个独立的单文件程序，无需其他依赖
- ℹ️ 技能目录位置取决于你使用的 IDE/Agent 配置

## 初始化

安装完成后，验证安装：

```bash
# 查看版本
task-skill --version

# 查看帮助
task-skill --help

# 启动 Web 服务器（用于人机协作界面）
task-skill --server
```

## 工具函数

### create-task
创建新任务

**参数**:
- `--title` (string, 必需): 任务标题
- `--project` (string, 必需): 项目名称
- `--description` (string, 可选): 任务描述
- `--priority` (int, 可选): 优先级 0-99（数字越大优先级越高），默认 50
- `--assignee` (string, 可选): 负责人姓名
- `--parent` (string, 可选): 父任务 UUID（创建子任务时使用）

**调用示例**:
```bash
# 创建普通任务
task-skill create-task --title "审查文档" --project "aitask-skill" --priority 2 --description "检查完整性"

# 创建子任务
task-skill create-task --title "子任务-收集资料" --project "demo" --parent abc-123
```

### list-tasks / ls
查询任务列表

**参数**:
- `--status` (string, 可选): 状态筛选（pending/agent_working/agent_review/human_review/done/cancelled）
- `--project` (string, 可选): 项目筛选
- `--limit` (int, 可选): 返回数量限制

**调用示例**:
```bash
task-skill list-tasks --status pending
task-skill ls --project demo --limit 10
```

### get-task
获取任务详情

**参数**:
- `uuid` (string, 必需): 任务 UUID

**调用示例**:
```bash
task-skill get-task abc-123
```

### claim-task
领取任务（pending → agent_working）

**注意**: 此命令会同时返回任务的详细信息（包含完整的处理历史记录 `activities`），方便 Agent 了解该任务的过往情况。

**参数**:
- `uuid` (string, 必需): 任务 UUID
- `[comment]` (string, 可选): 领取说明

**调用示例**:
```bash
task-skill claim-task abc-123 "我来处理这个任务"
```

### submit-review
提交初审（agent_working → agent_review）

**参数**:
- `uuid` (string, 必需): 任务 UUID
- `[comment]` (string, 可选): 提交说明，例如完成了哪些工作

**调用示例**:
```bash
task-skill submit-review abc-123 "已完成基础功能开发，等待自测"
```

### review-task
提交人工审核（agent_review → human_review）

**参数**:
- `uuid` (string, 必需): 任务 UUID
- `[comment]` (string, 可选): 提交给人工审核的说明

**调用示例**:
```bash
task-skill review-task abc-123 "自测通过，请产品经理验收"
```

### approve-task
人工审核通过（human_review → done）

**⚠️ 警告**: 此命令属于人工审核步骤。除非用户明确指示“审核通过”或“标记为已完成”，否则 AI Agent 绝对不能自动调用此命令！

**参数**:
- `uuid` (string, 必需): 任务 UUID
- `[comment]` (string, 可选): 审核意见或通过说明

**调用示例**:
```bash
task-skill approve-task abc-123 "测试没问题，准予发布"
```

### reject-task
审核不通过并退回（agent_review/human_review → pending）

**注意**: 当 Agent 自己审核（agent_review）发现未达到要求时，**必须**使用此命令将任务退回待办状态（pending）！

**参数**:
- `uuid` (string, 必需): 任务 UUID
- `[comment]` (string, 可选): 审核意见或退回原因

**调用示例**:
```bash
task-skill reject-task abc-123 "文档格式不对，请重新排版"
```

### cancel-task
取消任务（任意状态 → cancelled）

**注意**: 当 Agent 发现需求本身不再需要、重复、或者因为外部原因无法继续时，可使用此命令。但**绝对不能**在"自己审核未达到要求"时用此命令代替 `reject-task`。

**参数**:
- `uuid` (string, 必需): 任务 UUID
- `[comment]` (string, 可选): 取消原因

**调用示例**:
```bash
task-skill cancel-task abc-123 "需求变更，此任务不再需要"
```

**任务状态说明**：
- `pending` - 待办（等待 agent 领取）
- `agent_working` - Agent 工作中（agent 已领取，正在处理）
- `agent_review` - Agent 审核中（agent 提交初审后，等待 agent 自己审核确认）
- `human_review` - 人工审核中（agent 审核通过后，提交给人工审核）
- `done` - 完成（人工审核通过。**注意：AI Agent 不得擅自将任务变更为此状态，必须由人类明确授权**）
- `cancelled` - 已取消

### delete-task
物理删除任务（彻底删除）

**注意**: 此操作不可恢复，请谨慎使用！

**参数**:
- `uuid` (string, 必需): 任务 UUID

**调用示例**:
```bash
task-skill delete-task abc-123
```

### recycle-tasks
回收到期未完成的 Agent 任务

**逻辑**:
- 回收 `due_date` 之前创建的、状态为 `agent_working` 的任务
- 回收后任务状态变为 `pending`（重新进入待办池）

**参数**:
- `--due-date` (string, 可选): 截止时间，回收此日期前创建的超时任务

**调用示例**:
```bash
task-skill recycle-tasks --due-date 2026-03-22
```

### stats
获取仪表盘统计信息

**参数**: 无

**调用示例**:
```bash
task-skill stats
```