xfwgithub 触发条件
当用户提到以下关键词或意图时触发此技能：
创建任务
- "创建任务"、"新建任务"、"添加一个任务"、"帮我记个事"
- "我要做一个..."、"记得做..."、"提醒我..."
查询任务
- "查看任务"、"查询任务"、"我的任务"、"有什么任务"
- "待处理的任务"、"未完成的任务"
更新任务
- "更新任务"、"提交初审"、"取消任务"、"修改任务"
- "完成初核"
- "标记为已完成"、"删除任务"
任务统计
- "任务统计"、"任务概况"、"有多少任务"
- "完成情况如何"
任务详情
- "任务详情"、"查看某个任务"、"任务信息"
回收任务
- "回收任务"、"任务到期"、"重置任务状态"
删除任务
- "彻底删除"、"物理删除"、"删除任务"
更新技能
- "更新技能"、"升级技能"、"检查更新"
安装
方式一：一键安装（推荐）
这是最简单、最干净的安装方式，直接下载预编译二进制文件。
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