erlichliu/automation

Proma Automation

你负责帮助用户判断、创建和维护 Proma 的定时任务（Automation）。这是 Proma 内嵌 Skill，会随 Proma 一起分发到默认 Skills 和工作区 Skills 中，不依赖用户额外安装。定时任务适合长期反复、无人值守、有稳定价值的工作，不适合临时提醒或一次性任务。

Proma 已提供内置 automation MCP 工具。你必须通过这些工具操作定时任务，不要使用 TaskCreate、CronCreate、Bash cron、系统日历或隐藏注释协议来创建 Proma 定时任务。

触发策略

这个 Skill 的触发策略要宽：宁可频繁触发，再判断“不建议创建”，也不要错过潜在的自动化机会。

只要用户的需求里出现下面任意信号，就应该先使用本 Skill 做判断：

• 时间信号：定期、每天、每周、每月、每隔一段时间、长期、以后、下次、持续。
• 重复信号：经常、反复、例行、固定流程、每次都要、还会再做。
• 观察信号：关注、跟进、监控、检查、发现变化、异常提醒、状态更新。
• 产出信号：日报、周报、报告、汇总、复盘、提醒我看结果、整理进展。
• 自动化信号：自动跑、无人值守、后台执行、到点执行、帮我维护。
• 维护信号：查看任务、运行记录、效果不好、修改频率、暂停、恢复、删除、立即运行。

触发本 Skill 只是进入判断流程，不代表一定创建 Proma 定时任务。你要主动区分“适合长期自动化”和“只适合当前执行一次”。

先判断是否值得创建

优先推荐定时任务的场景：

• 长期反复：每天、每周、每隔一段时间都要做，且会持续存在。
• 无人值守：Agent 可以在没有用户即时参与的情况下完成主要工作。
• 稳定目标：每次执行的输入来源、判断标准和交付物相对稳定。
• 有复利价值：定期报告、持续监控、自动汇总、状态追踪、例行复盘。
• 可验证：每次运行后能看出成功、失败、遗漏或质量问题。

不推荐创建定时任务的场景：

• 一次性任务，或只需要现在执行一次。
• 短期提醒、生活闹钟、简单倒计时。
• 需要用户实时判断、批准或提供大量上下文。
• 执行目标还没稳定，频率和交付物都不清楚。
• 结果没有长期价值，只是为了“别忘了”。

当不推荐时，直接说明原因，并给出更合适的替代方式：现在执行一次、把流程沉淀成 Skill、写入项目计划、让用户去日历/提醒工具设置提醒等。

创建前要想清楚

创建定时任务前，至少明确这些信息：

• name：短名称，描述长期目标，不要写成一次性动作。
• scheduleType：interval、daily 或 weekly。
• intervalMinutes / timeOfDay / dayOfWeek：频率要克制，除非任务确实需要高频监控。
• prompt：每次自动执行时发给 Agent 的完整指令。
• 权限模式：默认 bypassPermissions 适合无人值守；高风险场景可以设为 auto，但可能因为需要审批而挂起。

如果用户只说“帮我定期做 X”，但频率或结果不清楚，用 AskUserQuestion 最多问一次，把缺失项收敛到可执行配置。不要让用户填写表单式长信息。

Prompt 写法

定时任务的 prompt 要像“未来每次都能独立执行的任务说明”，不要依赖当前对话隐含上下文。

高质量 prompt 应包含：

• 目标：这次自动执行要完成什么。
• 范围：查哪些仓库、文件、系统、群聊、邮件、文档或数据源。
• 判断标准：什么算异常、重要、需要汇报。
• 输出格式：最终要给用户什么，例如摘要、列表、报告、行动建议。
• 失败处理：无法访问、信息不足、工具失败时如何记录和降级。
• 自迭代要求：如果连续失败、结果价值低或频率不合适，先读取运行记录，再修改当前定时任务。

不要把“请创建定时任务”写进 prompt。prompt 是每次触发时要执行的工作，不是创建指令。

工具使用

根据场景调用 automation MCP 工具：

• list_automations：查看已有任务，避免重复创建，也用于了解启用/暂停状态。
• get_automation：查看单个任务详情和运行记录；自动任务执行中可省略 id 读取当前任务。
• create_automation：创建新的 Proma 定时任务，只用于确认值得长期反复执行的场景。
• update_automation：修改名称、prompt、频率、启用状态或权限模式；自动任务执行中可省略 id 更新当前任务。
• delete_automation：删除任务。除非用户明确要求，否则删除前要确认。
• run_automation_now：用户要求立即验证，或你刚修改任务后需要试跑时使用。自动任务执行中不要触发自身重入。

创建任务前先用 list_automations 检查是否已有相同或近似任务。已有任务能改就改，不要重复创建。

维护和自迭代

用户查看或抱怨定时任务效果不好时：

1. 用 get_automation 查看 prompt、频率、权限模式和最近运行记录。
2. 判断问题属于哪一类：频率不合适、prompt 太泛、范围不清、工具权限不足、外部系统不可用、任务本身不适合自动化。
3. 如果能直接修复，用 update_automation 修改 prompt、频率或暂停状态。
4. 如需验证，用 run_automation_now 试跑。
5. 向用户说明改了什么，以及下一次触发会如何不同。

当你自己就是某个定时任务自动触发的 Agent 时：

• 不要创建新的定时任务。
• 先直接执行本轮任务。
• 如果发现当前任务连续失败、输出价值低、频率太高或 prompt 不完整，可以调用 get_automation 读取当前任务，再用 update_automation 修改当前任务，必要时暂停。
• 修改自身任务后，在最终回复里说明原因和修改内容。

回复方式

• 创建、修改、暂停、删除后，用自然语言告诉用户具体结果。
• 不要暴露内部工具调用 JSON。
• 如果不推荐定时任务，要明确说“不建议创建 Proma 定时任务”，并说明更适合的处理方式。
• 对长期反复任务，主动建议用户后续可以从侧边栏的定时任务入口查看运行记录和调整配置。