Task management

触发条件

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

创建任务

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

查询任务

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

更新任务

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

任务统计

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

任务详情

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

回收任务

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

删除任务

• "彻底删除"、"物理删除"、"删除任务"

更新技能

• "更新技能"、"升级技能"、"检查更新"

安装

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

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

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

方式二：手动下载

# 下载最新版本的完整包
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 技能目录：

# 下载 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 配置

初始化

安装完成后，验证安装：

# 查看版本
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（创建子任务时使用）

调用示例:

# 创建普通任务
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, 可选): 返回数量限制

调用示例:

task-skill list-tasks --status pending
task-skill ls --project demo --limit 10

get-task

获取任务详情

参数:

• uuid (string, 必需): 任务 UUID

调用示例:

task-skill get-task abc-123

claim-task

领取任务（pending → agent_working）

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

参数:

• uuid (string, 必需): 任务 UUID
• [comment] (string, 可选): 领取说明

调用示例:

task-skill claim-task abc-123 "我来处理这个任务"

submit-review

提交初审（agent_working → agent_review）

参数:

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

调用示例:

task-skill submit-review abc-123 "已完成基础功能开发，等待自测"

review-task

提交人工审核（agent_review → human_review）

参数:

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

调用示例:

task-skill review-task abc-123 "自测通过，请产品经理验收"

approve-task

人工审核通过（human_review → done）

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

参数:

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

调用示例:

task-skill approve-task abc-123 "测试没问题，准予发布"

reject-task

审核不通过并退回（agent_review/human_review → pending）

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

参数:

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

调用示例:

task-skill reject-task abc-123 "文档格式不对，请重新排版"

cancel-task

取消任务（任意状态 → cancelled）

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

参数:

• uuid (string, 必需): 任务 UUID
• [comment] (string, 可选): 取消原因

调用示例:

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

调用示例:

task-skill delete-task abc-123

recycle-tasks

回收到期未完成的 Agent 任务

逻辑:

• 回收 due_date 之前创建的、状态为 agent_working 的任务
• 回收后任务状态变为 pending（重新进入待办池）

参数:

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

调用示例:

task-skill recycle-tasks --due-date 2026-03-22

stats

获取仪表盘统计信息

参数: 无

调用示例:

task-skill stats