ClawHub 开发日历

概述

为 ClawHub 技能开发工作流生成定制化日历。支持格式：ICS（适用于各类日历应用）、PDF/HTML/PNG（通过 canvas/浏览器生成）、Markdown/纯文本。

关键集成项：

• ClawHub 开发里程碑（references/dev_milestones.md）
• 萨斯喀彻温省（SK）法定节假日（references/sask_holidays.json）
• 多项目支持
• 时区：America/Regina（脚本中手动配置偏移量）

快速开始

文本格式月度日历：

exec command="cal -3 2026-04"

项目 ICS 日历：

1. 复制 assets/project_template.json → project.json，并编辑内容
2. exec "python3 scripts/generate_ics.py project.json dev.ics" pty=true
3. message media="dev.ics" caption="Dev calendar attached"

工作流：完整项目日历

1. 输入：编写 project.json，包含项目名称、起始时间（ISO 格式）及里程碑数组（每个元素含 name 和 hours）
2. 节假日处理：脚本从 sask_holidays.json 中标记法定节假日
3. 生成 ICS：运行 scripts/generate_ics.py 输出 .ics 文件
4. HTML 时间线：修改 assets/calendar_template.html，或使用 exec python 调用 HTML 生成脚本
5. 可视化呈现：canvas present url="data:text/html;base64,base64 html"，或通过浏览器导出为 PDF
6. 共享：通过 message 发送文件，或将文件写入 workspace/ 或 memory/

示例 project.json：

{
  "name": "clawhub-dev-calendar",
  "start": "2026-04-01T09:00:00-06:00",
  "milestones": [
    {"name": "Init", "hours": 2},
    {"name": "Research/Plan", "hours": 4},
    {"name": "Develop", "hours": 6},
    {"name": "SKILL.md", "hours": 4},
    {"name": "Test", "hours": 3},
    {"name": "Publish", "hours": 1}
  ]
}

资源

scripts/

• generate_ics.py：将里程碑作为事件生成 ICS 文件。用法：python3 generate_ics.py project.json [output.ics] 支持时区偏移处理与节假日检查（所有节假日事件均为全天事件）。

references/

• dev_milestones.md：标准开发阶段、对应工时及累计耗时
• sask_holidays.json：2026–2027 年萨斯喀彻温省法定节假日日期列表（YYYY-MM-DD 格式）

assets/

• project_template.json：供复制和自定义的输入模板示例

规划过程中可按需加载 references/ 下的资源。