macOS smart schedule assistant. Automatic scheduling, writes to the system calendar, Pomodoro focus, and it can even learn your time estimation habits, understanding your rhythm better the more you use it.
Core Features
| Feature | Description |
|---|---|
| 🧠 Smart Scheduling | Automatically calculates the optimal time arrangement based on priority |
| 📅 Calendar Sync | Directly reads and writes the macOS system calendar |
| ⚡ Conflict Detection | Automatically checks for time overlaps before writing |
| 🔄 Dynamic Adjustment | Automatically postpones subsequent arrangements when a task runs overtime |
| 📊 Daily Review | Automatically generates completion rate and time deviation analysis |
| 🧬 Habit Learning | Records time estimation deviations and continuously optimizes |
| 🍅 Pomodoro | Focus timer that records interruption reasons |
| 🏷️ Automatic Tagging | Automatically categorizes based on task name (writing/design/development, etc.) |
Quick Start
Installation
Import the .skill file into OpenClaw to use it.
Command-Line Usage
# 创建日程
niuamaxia create "写方案" "15:20" "16:20" "明天评审"
# 列出今日事件
niuamaxia list
# 删除事件
niuamaxia delete "写方案"
# 批量删除
niuamaxia delete-batch "临时" "测试" "草稿"
# 标记完成
niuamaxia complete "写方案" 75 "15:25"
# 每日复盘
niuamaxia review
# 查看统计
niuamaxia stats
Pomodoro
# 开始番茄钟(默认25分钟)
niuamaxia pomodoro-start "写方案" 25
# 查看状态
niuamaxia pomodoro-status
# 完成番茄钟
niuamaxia pomodoro-stop true
# 中断并记录原因
niuamaxia pomodoro-stop false "被同事打断"
# 番茄钟报告
niuamaxia pomodoro-report
Smart Scheduling (multi-task)
echo '[
{"name": "写方案", "duration": 60, "priority": "P0"},
{"name": "写需求单", "duration": 30, "priority": "P0"},
{"name": "画交互稿", "duration": 120, "priority": "P0"}
]' | niuamaxia schedule
Python API
from schedule_manager import ScheduleManager
manager = ScheduleManager()
# 智能排程
tasks = [
{"name": "写方案", "duration": 60, "priority": "P0"},
{"name": "设计UI", "duration": 90, "priority": "P0"},
]
scheduled = manager.smart_schedule(tasks, start_from="15:20")
# 写入日历
for task in scheduled:
manager.create_event(
title=task["name"],
start_time=task["start_time"],
end_time=task["end_time"],
description=f"优先级: {task['priority']}"
)
# 生成日程表
print(manager.generate_schedule_table(scheduled))
# 标记完成(用于复盘)
manager.complete_task("写方案", actual_duration=75, actual_start="15:25")
# 获取复盘报告
print(manager.get_daily_review())
# 番茄钟
session = manager.start_pomodoro("写方案", duration=25)
ended = manager.stop_pomodoro(completed=True)
Priority Description
| Priority | Meaning | Handling |
|---|---|---|
| P0 | Urgent and important | Schedule immediately, prioritizing prime time slots |
| P1 | Important but not urgent | Schedule with priority, can be adjusted appropriately |
| P2 | Trivial/low priority | Fill gaps, can be replaced at any time |
Automatic Tag Classification
| Keywords | Tag |
|---|---|
| Proposal, document, report, PRD | Writing |
| Design, UI, interaction, Figma | Design |
| Code, development, Bug, API | Development |
| Meeting, brainstorm, review, discussion | Meeting |
| Email, message, reply, coordination | Communication |
| Research, analysis, learning | Research |
| Planning, scheduling, organizing | Planning |
File Structure
niuamaxia-scheduler/
├── SKILL.md # 技能说明
├── scripts/
│ ├── schedule_manager.py # 核心模块
│ ├── analytics.py # 复盘分析
│ ├── tags.py # 标签与番茄钟
│ └── niuamaxia # CLI 脚本
├── references/
│ └── workflow.md # 工作流参考
└── data/ # 数据存储
├── task_records.json # 任务记录
├── analytics.json # 分析数据
├── tags.json # 标签分类
└── pomodoro.json # 番茄钟记录
Dependencies
- macOS system (uses AppleScript to operate the calendar)
- Python 3
- Calendar app write permission
Workflow
用户输入任务
↓
收集信息(deadline、耗时、优先级)
↓
检查现有日程
↓
智能排程计算
↓
生成日程表 → 用户确认
↓
写入系统日历
↓
设置提醒
↓
完成!
Review Example
🦞 牛马虾·2026-03-13 复盘报告
📊 总体统计
总任务数: 5
已完成: 4 ✅
未完成: 1 ⏳
完成率: 80%
📈 时间偏差分析
写方案: +15分钟 (+25%)
写需求单: -5分钟 (-17%)
→ 下次自动调整预估时间
License
MIT License