alter123-zz/niuamaxia-scheduler

牛马虾·智能日程管理器 🦞

macOS 智能日程管家。自动排程、写入系统日历、番茄钟专注，还能学习你的时间预估习惯，越用越懂你的节奏。

---

核心功能

| 功能 | 说明 | |------|------| | 🧠 智能排程 | 根据优先级自动计算最优时间安排 | | 📅 日历同步 | 直接读写 macOS 系统日历 | | ⚡ 冲突检测 | 写入前自动检查时间重叠 | | 🔄 动态调整 | 任务超时自动顺延后续安排 | | 📊 每日复盘 | 自动生成完成率与时间偏差分析 | | 🧬 习惯学习 | 记录时间预估偏差，持续优化 | | 🍅 番茄钟 | 专注计时，记录中断原因 | | 🏷️ 自动标签 | 根据任务名自动分类（写作/设计/开发等） |

---

快速开始

安装

将 .skill 文件导入 OpenClaw 即可使用。

命令行使用

# 创建日程
niuamaxia create "写方案" "15:20" "16:20" "明天评审"

# 列出今日事件
niuamaxia list

# 删除事件
niuamaxia delete "写方案"

# 批量删除
niuamaxia delete-batch "临时" "测试" "草稿"

# 标记完成
niuamaxia complete "写方案" 75 "15:25"

# 每日复盘
niuamaxia review

# 查看统计
niuamaxia stats

番茄钟

# 开始番茄钟（默认25分钟）
niuamaxia pomodoro-start "写方案" 25

# 查看状态
niuamaxia pomodoro-status

# 完成番茄钟
niuamaxia pomodoro-stop true

# 中断并记录原因
niuamaxia pomodoro-stop false "被同事打断"

# 番茄钟报告
niuamaxia pomodoro-report

智能排程（多任务）

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)

---

优先级说明

| 优先级 | 含义 | 处理方式 | |--------|------|----------| | P0 | 紧急且重要 | 立即安排，优先占用黄金时段 | | P1 | 重要不紧急 | 优先安排，可适度调整 | | P2 | 琐事/低优先级 | 填充间隙，可随时替换 |

---

自动标签分类

| 关键词 | 标签 | |--------|------| | 方案、文档、报告、PRD | 写作 | | 设计、UI、交互、Figma | 设计 | | 代码、开发、Bug、API | 开发 | | 会议、脑暴、评审、讨论 | 会议 | | 邮件、消息、回复、协调 | 沟通 | | 调研、分析、学习 | 研究 | | 规划、排期、整理 | 规划 |

---

文件结构

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           # 番茄钟记录

---

依赖

• macOS 系统（使用 AppleScript 操作日历）
• Python 3
• 日历应用写入权限

---

工作流程

用户输入任务
    ↓
收集信息（deadline、耗时、优先级）
    ↓
检查现有日程
    ↓
智能排程计算
    ↓
生成日程表 → 用户确认
    ↓
写入系统日历
    ↓
设置提醒
    ↓
完成！

---

复盘示例

🦞 牛马虾·2026-03-13 复盘报告

📊 总体统计
  总任务数: 5
  已完成: 4 ✅
  未完成: 1 ⏳
  完成率: 80%

📈 时间偏差分析
  写方案: +15分钟 (+25%)
  写需求单: -5分钟 (-17%)
  → 下次自动调整预估时间

---

许可证

MIT License