SuperAPI AI 工具集

task-polling

办公与效率

查看项目

更新于 10-15 21:52

技能介绍

用途:让用户只维护项目根目录的 docs/task.md 作为唯一任务状态源,即可自动领取、执行和完成本地任务,无需额外任务 JSON。文档固定包含五个区段:# 任务计划、## 未领取、## 进行中、## 已完成、## 远期规划、## 确认不做。可执行任务放入“未领取”,须使用唯一 ID,标题支持半角或全角冒号;正文可选,含“验收&产物”“限制&约束”等。区段中的 - [ ] 空占位行会被忽略。远期规划与确认不做由用户维护,Agent 不会自动领取。

调度规则:用户要求开始、继续或轮询时,先执行 status 读取当前状态:python3 <skill>/scripts/task_polling.py --json status。随后用 /loop 每 2 分钟检查一次,每轮执行 claim:python3 <skill>/scripts/task_polling.py --json claim。返回 claimed 时通读 task.description 后执行;返回 error 时依据 task.description 继续当前任务,不得重复领取;返回 idle 时等待下一轮 /loop;收到新用户消息时停止轮询并优先响应。task 字段为 id、title、description、checked。

完成规则:只有代码、文档或脚本已完成且验收实际执行后,才允许用 complete:python3 <skill>/scripts/task_polling.py --json complete --id TASK-001 --summary "测试命令及结果",任务移入“已完成”并标 [x]、追加结果。验收失败用 reopen 打回“进行中”并保留记录:python3 <skill>/scripts/task_polling.py --json reopen --id TASK-001 --reason "功能验收失败:具体问题",该命令仅处理已完成任务。

限制:docs/task.md 是唯一状态源,不读写外部 JSON;一次最多一个“进行中”任务;不擅自发布、推送、删除数据或调用外部服务;不提前执行远期规划任务;保留用户对 docs/task.md 的编辑;不清理“已完成”任务,留作发版前 CHANGELOG 回顾。完成或打回仅限当前会话,不创建 Cron,执行期间不得重复领取。