SuperAPI AI Directory

niuamaxia-scheduler

General & other

View repository

Updated 10-16 08:37

About this skill

Niumaxia·Smart Schedule Manager 🦞

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