ClawPlanOps

基于交付物证据的项目执行规划技能。当用户需要解析任务通知、生成项目计划、导出日历、检查真实文件进度、或动态调整计划时使用。

ClawPlanOps – 项目执行规划技能

核心理念

让 AI 做 AI 擅长的事（文本理解），让代码做代码擅长的事（确定性操作）。

• 文本解析 → 用你的 LLM 能力直接提取结构化信息
• 计划生成 → 调用代码工具（反向拆解 + 微任务生成）
• 日历导出 → 调用代码工具（ICS 文件生成 + VALARM）
• 进度检查 → 调用代码工具（文件扫描 + Git 证据）
• 动态重排 → 调用代码工具（压缩/砍功能/优先级调整）

工作流

当用户提供任务通知时：

Step 1 – 你自己解析文本（不要调用 parse_task_requirements 工具）

阅读用户提供的通知文本，直接提取以下结构化信息：

{
  "task_name": "完整的任务/比赛名称",
  "deadline": "2026-06-22T12:00:00",
  "deliverables": ["交付物1", "交付物2"],
  "constraints": ["限制条件1", "限制条件2"],
  "submission_rules": ["提交规则1"]
}

重要规则：

• deadline 取最终提交截止时间，不要取报名时间
• 如果文本有多个日期，找"作品提交""材料报送""截止"相关的
• deliverables 列出所有需要产出/提交的东西
• 如果通知只有一个邮箱和申请表，那交付物就是申请表

Step 2 – 调用 clawplanops_build_deliverable_plan

把 Step 1 的 JSON 作为 task_requirements 参数传入。 可选参数：

• available_days — 手动指定可用天数（默认从 deadline 自动计算）
• daily_available_hours — 每天可用小时数（默认 2）
• custom_templates — 自定义交付物模板，格式：

  {
    "商业计划书": {
      "sub_tasks": ["市场调研", "撰写正文", "财务分析"],
      "evidence": ["商业计划书.pdf"]
    }
  }
  

  自定义模板会覆盖内置模板中同名的条目。

Step 3 – 调用 clawplanops_generate_calendar_schedule

用 plan 中的 micro_tasks、start_date、deadline 生成日历。 可选参数：

• preferred_work_time — 工作时间段，如 "20:00-22:00"（默认）
• output_path — 输出路径（默认 ./output/schedule.ics）

Step 4 – 总结并告知用户

用中文总结：任务名、截止日期、几个阶段、几个微任务、日历文件位置。

---

当用户要求检查进度时：

调用 clawplanops_check_progress_evidence，传入项目路径。

汇报：进度百分比、风险等级、缺失项、下一步建议。

---

当用户进度落后时：

先调用 clawplanops_check_progress_evidence 获取当前进度， 再调用 clawplanops_reschedule_plan 获取重排建议。

---

工具列表

工具	用途	输入
clawplanops_parse_task_requirements	仅限 CLI 备用 — 代码规则解析，不如你亲自解析准确，不要在技能流程中使用	content, input_type
clawplanops_build_deliverable_plan	生成交付物计划 + 微任务	task_requirements, available_days?, daily_available_hours?, custom_templates?
clawplanops_generate_calendar_schedule	生成 .ics 日历文件	micro_tasks, start_date, deadline, preferred_work_time?, output_path?
clawplanops_check_progress_evidence	扫描项目文件 + Git 证据	project_path
clawplanops_reschedule_plan	动态重排建议	progress_report, original_plan, deadline

macOS 日历直连

CLI 用户可使用 --apple-cal 标志将日历事件直接导入 macOS Calendar.app：

claw-planops calendar plan.json --apple-cal
claw-planops full notice.txt . --apple-cal

导入前会显示事件摘要并要求用户确认（y/N）。事件会写入名为 "ClawPlanOps" 的专属日历。

编程方式调用：

import { importToAppleCalendar } from 'claw-planops';
const result = importToAppleCalendar(calendarEvents);
// result: { success, imported_count, calendar_name, errors }

配置文件

用户可以在项目根目录创建 .planopsrc.json 自定义行为：

{
  "name": "my-project",
  "preferred_work_time": "09:00-12:00",
  "daily_available_hours": 3,
  "output_dir": "./output",
  "deliverables": {
    "商业计划书": {
      "sub_tasks": ["市场调研", "撰写正文"],
      "evidence": ["商业计划书.pdf"]
    }
  },
  "exclude_patterns": ["node_modules", ".git", "dist"]
}

示例

用户：

帮我分析这个比赛通知：郑州大学"四创"大赛，6月22日12:00前提交申请表电子版到 [e-mail]，纸质版下午送到办公室

你应该：

1. 自己提取结构化信息（不要调用 parse_task_requirements）
2. 调用 build_deliverable_plan
3. 调用 generate_calendar_schedule
4. 用中文总结

关键原则

• 解析靠 AI，不靠正则 — 语言理解能力远超任何正则表达式
• 计划生成靠代码 — 反向拆解、微任务估算、日历生成由工具完成
• 进度检查靠文件证据 — 不靠用户打卡，扫描目录 + Git log
• 日历自带提醒 — ICS 含 30分钟前 + 1天前 VALARM