reminder-engine

提醒引擎(专业版)

专业版增强能力

能力矩阵

时间解析（增强版）

支持三类时间格式：

自然语言日期解析：

详细代码示例已移至 references/detail.md

安全校验（完整版）

完整版新增：上下文感知检测、白名单模式、编码验证.

多渠道同时投递

多渠道投递策略：

同时投递示例：

递增提醒

间隔逐渐缩短的提醒模式，适用于紧急程度递增的场景：

周期性提醒

生命周期管理

初学指南

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

典型场景

场景一：多渠道项目截止提醒（项目经理角色）

场景描述：项目临近截止，需要通过Discord和Telegram同时发送递增提醒.

场景二：批量会议提醒（行政助理角色）

场景描述：一天内有多个会议，批量创建提醒.

MEETINGS_JSON='[
  {"time": "today 10:00", "content": "产品评审会议", "channels": ["discord"]},
  {"time": "today 14:00", "content": "技术方案讨论", "channels": ["discord", "telegram"]},
  {"time": "today 16:30", "content": "客户对接会议", "channels": ["telegram"]},
  {"time": "tomorrow 09:30", "content": "晨会", "channels": ["discord"]}
]'
# ...

场景三：Webhook集成提醒（运维工程师角色）

场景描述：系统部署完成后，创建提醒通过Webhook触发监控系统的检查任务.

REMIND_AT=$(date -u -d "+5 minutes" +"%Y-%m-%dT%H:%M:%SZ")
# ...
skill-platform cron add \
  --name "reminder-deploy-verify" \
  --at "$REMIND_AT" \
  --session isolated \
  --message "验证最新部署的功能" \
  --webhook "https://monitoring.example.com/hooks/verify" \
  --webhook-signing-secret "monitor-secret" \
  --delete-after-run

场景四：周期性工作提醒（团队负责人角色）

场景描述：配置每日站会、每周周报、每月总结的周期性提醒.

场景五：紧急程度分级提醒（技术负责人角色）

场景描述：生产事故处理，根据紧急程度投递到不同渠道.

操作流程

30秒上手（创建多渠道提醒）

用户说"1小时后提醒我参加项目评审，发到Discord和Telegram"：

120秒标准搭建（批量创建提醒）

使用批量创建脚本一次创建多个提醒：

详细内容已移至 references/detail.md -

300秒完整配置（递增提醒 + 周期性提醒）

以下是提醒引擎(专业版)的快速搭建流程，从初始化到完整配置的步骤说明.

输入规范

输出规范

{
  "success": true,
  "data": {
    "result": "处理结果",
    "status": "success",
    "metadata": {
    "metadata": {
      "template_used": "reviewer",
      "word_count": 0,
      "style": "专业"
    }
  },
  "error": null
}

输出模板参考: assets/output.json

异常处置

运行环境

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Bash: 4.0+（用于安全校验脚本与批量创建脚本）
• date命令: 支持 -d 参数（GNU date，Linux/macOS自带）
• jq: 1.6+（用于JSON解析）
• Python: 3.8+（用于自然语言日期解析）

依赖说明(补充)

LLM模型路由

• 专业版使用 GPT-4o 模型路由，确保复杂提醒场景的创建质量
• 支持自然语言时间解析与多渠道投递的精细控制

API Key 配置

• Discord投递需要Discord Bot Token（存储在Agent Gateway配置中）
• Telegram投递需要Telegram Bot Token（存储在Agent Gateway配置中）
• WhatsApp投递需要WhatsApp Business API凭证
• Webhook签名密钥由用户自定义，存储在作业配置中
• 禁止在SKILL.md或脚本中硬编码Token

可用性分类

• 分类: MD+EXEC（Markdown指令+命令行执行）
• 说明: 通过自然语言指令驱动Agent创建企业级提醒

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

案例展示

与CI/CD系统集成

skill-platform cron add \
  --name "reminder-deploy-verify" \
  --at "$(date -u -d '+5 minutes' +"%Y-%m-%dT%H:%M:%SZ")" \
  --session isolated \
  --message "验证最新部署的功能" \
  --webhook "https://ci.example.com/hooks/verify" \
  --webhook-signing-secret "ci-secret" \
  --delete-after-run

与监控系统集成

skill-platform cron add \
  --name "reminder-incident-alert" \
  --at "$(date -u -d '+1 minute' +"%Y-%m-%dT%H:%M:%SZ")" \
  --session isolated \
  --message "触发告警：生产事故" \
  --webhook "https://alerts.example.com/hooks/incident" \
  --webhook-signing-secret "alert-secret" \
  --delete-after-run

与团队协作平台集成

skill-platform cron add \
  --name "reminder-meeting" \
  --at "$REMIND_AT" \
  --session main \
  --system-event "产品评审会议开始" \
  --agent "$AGENT" \
  --announce \
  --channel discord \
  --to "-1001234567890:topic:meetings" \
  --delete-after-run

与日历系统集成

calender_events=$(get_calendar_events --today)
echo "$calender_events" | jq -c '.[]' | while read -r event; do
  TIME=$(echo "$event" | jq -r '.start')
  CONTENT=$(echo "$event" | jq -r '.title')
done

常见疑问

Q1：免费版与专业版有什么区别？

免费版提供单频道投递、基础时间解析（相对+绝对）、基础安全校验、单次提醒创建。专业版解锁多渠道同时投递、批量创建、递增提醒、周期性提醒、Webhook投递、完整安全校验脚本（含上下文感知检测）、自然语言时间解析增强（支持"后天"/"下周一"等）。此外提供多角色场景指南、性能优化策略、多平台集成示例、完整FAQ（15问）与故障排查表（16项）.

Q2：如何实现多渠道同时投递？

为每个渠道创建独立的cron作业，使用相同的--at时间。例如同时投递到Discord和Telegram，创建两个作业，时间相同但--channel和--to不同。这确保即使一个渠道失败，另一个仍能正常投递.

Q3：递增提醒如何实现？

使用循环脚本，根据截止时间计算多个提前量（如2小时前、1小时前、30分钟前等），为每个时间点创建独立的提醒作业。通过URGENCY数组为每个提醒添加紧急程度标签，实现视觉上的紧急感递增.

Q4：安全校验的"拒绝"和"转义"有什么区别？

转义（escape）是将危险字符转换为安全形式，但容易遗漏边界情况，导致绕过攻击。拒绝（reject）是直接拒绝包含任何危险模式的输入，强制用户重新表述，从根本上消除风险。专业版还提供白名单模式，仅允许已知安全字符通过，安全性更高.

Q5：支持哪些自然语言日期格式？

专业版支持：后天、大后天、下周一至下周日、下个月X号、X天后、X小时后、X分钟后。这些格式通过语义解析后转换为ISO 8601时间戳。无法识别的格式会提示用户用明确格式表达.

Q6：周期性提醒和一次性提醒有什么区别？

一次性提醒使用--at参数，指定具体时间，执行后自动删除（配合--delete-after-run）。周期性提醒使用--cron参数，指定cron表达式（如30 9 * * 1-5表示工作日9:30），按规则重复执行，不自动删除，需手动管理.

Q7：如何批量创建提醒？

使用批量创建脚本，将多个提醒定义为JSON数组，循环解析并为每个提醒执行安全校验、时间解析、作业创建。支持错误隔离，单条失败不影响其他。详见"120秒标准搭建"示例.

Q8：Webhook投递如何工作？

任务执行完成后，调度器将结果以JSON格式POST到指定的HTTP端点。请求包含X-Signature头（HMAC-SHA256签名），服务端可验证请求来源。Webhook模式仅适用于isolated会话任务.

Q9：如何获取投递目标？

调用session_status工具获取当前会话的投递上下文。返回的deliveryContext.accountId用于--agent参数，deliveryContext.to用于--to参数。这确保提醒结果投递到用户当前所在的频道。也可手动指定--to参数.

Q10：为什么使用--session main而非isolated？

一次性提醒通常需要继承主会话上下文（如引用之前的对话），使用main模式可确保提醒在正确上下文中触发。同时使用--system-event payload类型。--delete-after-run确保执行后自动清理。Webhook投递的任务必须使用isolated模式.

Q11：超过48小时的提醒怎么办？

建议用户使用日历应用。提醒引擎设计为短期提醒（分钟级到小时级），长时间跨度的提醒更适合日历系统。若用户坚持创建，引擎仍会执行，但建议提示用户："此提醒距离现在超过48小时，建议同时添加到日历以免遗漏".

Q12：如何暂停和恢复周期性提醒？

使用skill-platform cron pause 暂停，暂停后不再被调度执行。使用skill-platform cron resume 恢复。暂停状态不影响作业配置。一次性提醒（已设置--delete-after-run）无需暂停，执行后自动删除.

Q13：如何清理历史提醒？

使用skill-platform cron cleanup --status done --older-than 7d清理7天前已完成的提醒。可根据需要调整--status和--older-than参数。建议定期清理，避免作业列表膨胀.

Q14：安全校验脚本如何升级？

专业版提供sanitize-message-pro.sh，新增上下文感知检测（URL编码、Unicode转义、HTML实体）、扩展危险命令列表、白名单模式、长度限制。直接替换免费版的sanitize-message.sh即可.

Q15：多渠道投递失败时如何处理？

启用bestEffort模式，单个渠道失败不阻塞其他渠道。对于关键提醒，建议同时投递多个渠道确保触达。检查失败渠道的凭证配置，必要时手动重试。专业版支持优先级降级策略，主渠道失败时尝试备用渠道.

功能边界

• 需要LLM支持
• 不能替代专业安全审计，仅提供辅助检查能力
• 加密强度依赖正确配置的密钥与算法参数
• 安全策略需定期更新以应对新威胁

创新亮点

效率提升量化分析

差异化对比

核心痛点解决

诊断与修复

安全规范

1. 确保所有通信渠道的安全配置，防止未授权访问。
2. 定期更新安全校验脚本，以应对新出现的漏洞。
3. 对敏感信息进行加密处理，防止数据泄露。
4. 实施访问控制策略，限制对提醒引擎的访问权限。
5. 定期进行安全审计，确保系统的安全性。

安全风险防范

核心功能特性

• 自动化执行: 一次性提醒创建引擎专业版，含多渠道投递、批量创建、递增提醒、周期性提醒与完整安全校验。提醒引擎专业版是在免费版基础上的全
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果

异常应对措施

针对提醒引擎(专业版)使用中可能遇到的常见问题,提供以下排查方案:

提醒引擎(专业版)通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

错误处理指引

针对提醒引擎(专业版)使用中可能遇到的常见问题,提供以下排查方案: