Farm Task Manager

支持每日、每周及季节性农场杂务管理，具备任务调度与优先级功能。

作者： IOU (@johstracke) 版本： 1.0.0 创建日期： 2026-02-12

关于本技能

Farm Task Manager 帮助农户系统化组织每日、每周和季节性的农场杂务，支持任务调度、优先级设定与进度追踪。适用于：

• 小型农场主（1–10 英亩）
• 业余农户与自给自足型农庄主（homesteaders）
• 农场直供（farm-to-table）运营者
• 需同时处理多项农场职责的任何人

开发初衷

我开发 Farm Task Manager 的原因是：农场工作繁重且琐碎——总有做不完的事（播种、维护、收获、畜禽照料、设备维修等）。仅靠大脑记忆极易遗漏关键任务、错判优先级、浪费时间。现在我只需输入 farm-task add "Fix irrigation" --priority high，即可放心交由系统提醒，到期前无需再操心。

功能特性

• 任务管理：支持添加任务名称、描述、优先级、截止日期、分类及负责人
• 任务筛选：按状态、优先级、分类、截止日期、负责人等维度筛选任务列表
• 任务更新：修改任务状态（pending / in-progress / completed），并可添加备注
• 周期性任务：支持创建每日、每周、每月或季节性重复任务
• 搜索功能：支持按任务名称、描述或分类进行全局搜索
• 导出功能：支持导出为 Markdown 或 JSON 格式，便于共享与备份

使用方法

添加任务

farm-task add "Check irrigation system" 
  --priority high 
  --category maintenance 
  --due "2026-03-01" 
  --assignee "John"

可用选项：

• --name：任务名称（必填）
• --description：任务描述
• --priority：任务优先级（high / medium / low）
• --status：任务状态（pending / in-progress / completed）
• --category：任务分类（planting / maintenance / harvesting / equipment / animals / buildings / other）
• --due：截止日期（格式：YYYY-MM-DD 或 YYYY-MM-DD HH:MM）
• --assignee：任务负责人

列出任务

# 列出全部任务
farm-task list

# 按状态筛选
farm-task list --status pending

# 按优先级筛选
farm-task list --priority high

# 按分类筛选
farm-task list --category planting

# 按截止日期排序（逾期任务置顶）
farm-task list --sort-due

# 按负责人筛选
farm-task list --assignee "John"

查看任务详情

farm-task show 1

显示以下信息：

• 任务基本信息
• 当前状态与优先级
• 截止日期
• 备注与操作历史
• 自创建以来的时间

更新任务状态

# 标记为“进行中”
farm-task update 1 --status in-progress

# 标记为“已完成”
farm-task update 1 --status complete

# 为任务添加备注
farm-task update 1 --note "Checked valves, all good"

# 修改优先级
farm-task update 1 --priority medium

添加周期性任务

# 每日任务
farm-task recurring "Check chicken water" 
  --frequency daily 
  --priority medium 
  --category animals

# 每周任务
farm-task recurring "Inspect tractor oil" 
  --frequency weekly 
  --priority high 
  --category equipment

# 每月任务
farm-task recurring "Test fire extinguishers" 
  --frequency monthly 
  --priority medium 
  --category buildings

# 季节性任务（每年 3 月 1 日执行）
farm-task recurring "Winterize irrigation" 
  --frequency seasonal 
  --season "03-01" 
  --priority high 
  --category maintenance

完成任务

farm-task complete 1

将任务标记为已完成，并记录完成时间戳。

删除任务

farm-task delete 1

从系统中彻底移除该任务。

导出任务

# 导出全部任务为 Markdown
farm-task export --file tasks.md

# 按分类导出为 Markdown
farm-task export --file planting-tasks.md --category planting

# 导出为 JSON
farm-task export --file tasks.json --format json

# 按日期范围导出
farm-task export --file march-tasks.md --after "2026-03-01" --before "2026-04-01"

安全性

✅ 已通过安全验证：本技能采用路径校验机制，防止未授权文件访问。

所有文件操作均限制在安全目录内：

• 工作区目录：~/.openclaw/workspace/farm-task-manager/
• 用户主目录：~/（由用户自主控制）

禁止访问的路径包括：

• 系统目录（如 /etc、/usr、/var 等）
• 敏感隐藏文件（如 ~/.ssh、~/.bashrc 等）

无硬编码密钥；不支持任意代码执行；所有操作均经过输入校验。

数据存储

任务以 JSON 格式存储于以下路径：

• ~/.openclaw/workspace/farm-task-manager/tasks.json

该目录将在首次运行时自动创建。

任务分类

优先级等级

使用示例

每日例行工作

# 查看当日待办（按截止时间排序）
farm-task list --sort-due --status pending

# 完成家禽巡检
farm-task complete 5
farm-task recurring generate 5  # 生成次日对应的周期性任务实例

每周计划安排

# 查看高优先级任务
farm-task list --priority high

# 导出本周计划文档
farm-task export --file weekly-plan.md --after "today" --before "7 days"

季节性农事

# 冬季准备
farm-task recurring "Winterize irrigation" 
  --frequency seasonal 
  --season "11-01" 
  --priority high 
  --category maintenance

# 春季播种
farm-task export --file spring-tasks.md --category planting --after "2026-03-01" --before "2026-06-01"

故障排查

Q：如何管理多名工作人员的任务？

A： 添加任务时使用 --assignee 指定负责人；后续可通过负责人筛选查看其专属任务列表：

farm-task list --assignee "Jane"

Q：能否在后期修改任务优先级？

A： 可以，使用更新命令即可：

farm-task update 1 --priority high

Q：周期性任务是如何运作的？

A： 周期性任务本质是模板。当您完成某条周期性任务后，可调用命令生成下一次实例：

farm-task recurring generate 1

该命令将创建一条新任务，继承原始模板的所有属性，并自动更新截止日期。

Q：能否用于项目制工作的管理？

A： 可通过分类（category）对关联任务进行分组管理：

farm-task add "Build new fence" --category buildings --assignee "John"
farm-task list --category buildings

Q：如何导出以便协作共享？

A： 支持导出为 Markdown（便于人工阅读）或 JSON（便于程序间数据交换）：

# Markdown 格式（人类可读）
farm-task export --file farm-plan.md

# JSON 格式（数据交换用）
farm-task export --file farm-tasks.json --format json

版本历史

• 1.0.0（2026-02-12）：初始发布
  • 基础任务管理（add / list / show / update / delete / complete）
  • 多维任务筛选（状态 / 优先级 / 分类 / 截止日期 / 负责人）
  • 周期性任务支持（daily / weekly / monthly / seasonal）
  • 全局任务搜索
  • 导出为 Markdown 与 JSON

技术支持

如遇 Bug、功能建议或使用疑问，请联系：

• 作者：@johstracke（ClawHub）
• 查看 IOU 其他技能：Farming Suite（即将上线！）

Farm Task Manager —— 有序管理农场事务，缓解压力，永不再遗漏重要任务。