SuperAPI AI 工具集

task-agent

智能体与模型

查看项目

更新于 10-16 08:00

技能介绍

用途:Task Agent 用于单次任务运行中的轻量、临时性会话草稿任务管理,提供 backlog、todo、in-progress、done 四个泳道的简易看板。资料明确说明仅适用于单次任务运行内的临时记录,不应作为跨会话的仓库缺陷、执行摩擦或技术债管理(此类场景应改用 github-issue-agent)。

主要能力:任务以独立 Markdown 文件(NNNN-title.md)形式存放在泳道目录中;支持创建任务、查看看板、在泳道间移动任务、按关键词搜索任务。所有任务操作须通过 task_manager.py CLI 完成,CLI 自动保证 ID 全局唯一且顺序递增,并维护 frontmatter 与历史记录。

使用方式:依赖 Python 3.8+,仅使用标准库,无外部包;安装依赖命令为 pip-compile ./requirements.in 与 pip install -r ./requirements.txt。规范脚本路径为 scripts/task_manager.py,需以绝对或根相对路径调用:python3 ./scripts/task_manager.py <command>。常用命令包括 create "Short Title" --lane todo、board、move 3 in-progress --note "Starting work"、search "login"。支持 --dir 指定任务目录;本用户偏好路径为 /Users/richardfremmerlid/Projects/hermes-agent/tasks,并可通过环境变量 HERMES_TASKS_ROOT 与偏好文件 ~/.hermes/tasks_default_dir 持久化。创建任务建议先建短标题再补全详情,自动化场景可传 --objective、--acceptance 直接生成完整任务。每次状态变更后应重新运行 board 展示最新看板状态。

限制:禁止用原生文件工具手动创建、重命名、移动或删除任务 Markdown 文件,以免绕过 ID 生成器导致编号重复或 frontmatter 损坏。ID 计数按配置目录扫描全部泳道,不同仓库的计数不会同步。PROJECT_ROOT 默认从脚本位置向上查找最近的含 .git 目录,嵌套插件目录下可能返回意外路径,需用 --dir 或偏好文件规避。在终端包装器中应逐条执行命令,避免批量组合命令触发前台/后台守卫错误。若脚本报任务 ID 不存在或检测到重复 ID,不要手动排查,应上报或参考 references/fallback-tree.md。具体收费、平台支持等资料暂未提供。