完成任务16：编写 04_长期发展/环境保护.md

active_skills/cron/SKILL.md

@@ -0,0 +1,201 @@
+---
+name: cron
+description: Use this skill only for scheduled or recurring tasks. Manage cron jobs with copaw cron list/create/get/state/pause/resume/delete/run. Always pass --agent-id explicitly. | 仅在需要未来定时执行或周期执行时使用本 skill。用 copaw cron list/create/get/state/pause/resume/delete/run 管理任务；必须显式传 --agent-id
+metadata: { "builtin_skill_version": "1.1", "copaw": { "emoji": "⏰" } }
+---
+
+# Cron（定时任务管理）
+
+## 什么时候用
+
+只有在需要**未来某个时间自动执行**，或**按周期重复执行**时，使用本 skill。
+
+### 应该使用
+- 用户要求"每天 / 每周 / 每小时"执行某事
+- 用户要求"明天 9 点 / 下周一 / 某个时间"自动提醒或执行
+- 需要长期周期性通知、检查、汇报
+
+### 不应使用
+- 只是要**现在立即执行一次**
+- 只是当前会话中的正常回复
+- 用户没有明确执行时间或周期
+- 目标 channel / user / session 还不明确
+
+## 决策规则
+
+1. **只有在未来定时执行或周期执行时才使用 cron**
+2. **如果只是立即做一次，通常不要创建 cron**
+3. **创建前必须确认执行时间/周期、目标 channel、target-user、target-session**
+4. **所有 cron 命令都必须显式传 `--agent-id`**
+5. **不要依赖默认 agent，否则任务可能落到 default workspace**
+
+---
+
+## 硬规则
+
+### 必须显式指定 `--agent-id`
+
+所有 `copaw cron` 命令都**必须**传：
+
+```bash
+--agent-id <your_agent_id>
+```
+
+你的 agent_id 在系统提示中的 Agent Identity 部分（Your agent id is ...）。  
+不得省略，否则任务可能错误创建到 default agent 的 workspace。
+
+---
+
+## 常用命令
+
+```bash
+# 列出任务
+copaw cron list --agent-id <agent_id>
+
+# 查看任务详情
+copaw cron get <job_id> --agent-id <agent_id>
+
+# 查看任务状态
+copaw cron state <job_id> --agent-id <agent_id>
+
+# 创建任务
+copaw cron create --agent-id <agent_id> ...
+
+# 删除任务
+copaw cron delete <job_id> --agent-id <agent_id>
+
+# 暂停 / 恢复任务
+copaw cron pause <job_id> --agent-id <agent_id>
+copaw cron resume <job_id> --agent-id <agent_id>
+
+# 立即执行一次已有任务
+copaw cron run <job_id> --agent-id <agent_id>
+```
+
+---
+
+## 创建任务
+
+支持两种类型：
+- **text**：定时发送固定消息
+- **agent**：定时向 agent 提问，并把回复发送到目标 channel
+
+### 创建前最少要确认
+- `--type`
+- `--name`
+- `--cron`
+- `--channel`
+- `--target-user`
+- `--target-session`
+- `--text`
+- `--agent-id`
+
+如果缺少这些信息，应先向用户确认，再创建任务。
+
+### 创建示例
+
+```bash
+copaw cron create \
+  --agent-id <agent_id> \
+  --type text \
+  --name "每日早安" \
+  --cron "0 9 * * *" \
+  --channel imessage \
+  --target-user "CHANGEME" \
+  --target-session "CHANGEME" \
+  --text "早上好！"
+```
+
+```bash
+copaw cron create \
+  --agent-id <agent_id> \
+  --type agent \
+  --name "检查待办" \
+  --cron "0 */2 * * *" \
+  --channel dingtalk \
+  --target-user "CHANGEME" \
+  --target-session "CHANGEME" \
+  --text "我有什么待办事项？"
+```
+
+### 从 JSON 创建
+
+```bash
+copaw cron create --agent-id <agent_id> -f job_spec.json
+```
+
+---
+
+## 最小工作流
+
+```
+1. 判断是否真的是"未来定时"或"周期执行"
+2. 确认执行时间/周期
+3. 确认 channel、target-user、target-session
+4. 显式带上 --agent-id
+5. copaw cron create 创建任务
+6. 后续用 list / state / pause / resume / delete 管理
+```
+
+---
+
+## Cron 表达式示例
+
+```
+0 9 * * *      每天 9:00
+0 */2 * * *    每 2 小时
+30 8 * * 1-5   工作日 8:30
+0 0 * * 0      每周日零点
+*/15 * * * *   每 15 分钟
+```
+
+---
+
+## 常见错误
+
+### 错误 1：把一次性立即执行当成 cron
+
+如果只是现在执行一次，通常不要创建 cron。
+
+### 错误 2：没传 --agent-id
+
+这会导致任务落到错误的 agent / workspace。所有 cron 命令都必须显式传 `--agent-id`。
+
+### 错误 3：信息没补全就创建
+
+如果用户没说明时间、周期、目标 channel 或目标 session，应先追问。
+
+### 错误 4：操作已有任务前不先查
+
+暂停、恢复、删除前，先用：
+
+```bash
+copaw cron list --agent-id <agent_id>
+```
+
+找到正确的 `job_id`。
+
+---
+
+## 使用建议
+
+- 缺少参数时，先问用户再创建
+- 修改/暂停/删除前，先 `copaw cron list --agent-id <agent_id>`
+- 排查问题时，用 `copaw cron state <job_id> --agent-id <agent_id>`
+- 给用户展示命令时，提供完整、可直接复制的版本
+
+---
+
+## 帮助信息
+
+```bash
+copaw cron -h
+copaw cron list -h
+copaw cron create -h
+copaw cron get -h
+copaw cron state -h
+copaw cron pause -h
+copaw cron resume -h
+copaw cron delete -h
+copaw cron run -h
+```