| name | astra-trade-alarm |
| description | AstraTrade alarm 任务管理 skill。用于让 Agent 自主创建、更新、启用、禁用或删除 config/alarm.json 中的 alarm 定时任务，并通过 alarm 在指定时间以 manual 形式唤醒主 Agent。适用于用户要求“提醒我之后检查某股票”“明天盘前分析候选池”“收盘后复盘”“定时让 Agent 执行某个自然语言任务”等场景。 |
AstraTrade Alarm
功能定位
使用本 skill 管理 AstraTrade 项目中的 config/alarm.json。
alarm 用于保存用户或 Agent 生成的定时任务。到达触发时间后，外部 scheduler/alarm runner 应读取 config/alarm.json，并将对应 task 以 manual 调用方式唤醒主 Agent。
本 skill 只负责生成和维护 alarm 配置，不负责真正运行常驻调度器。
文件结构
本 skill 包含：
astra-trade-alarm/
├── SKILL.md
└── scripts/
└── alarm_manager.py
使用原则
- 当需要新增、更新、启用、禁用、删除 alarm 时，调用
scripts/alarm_manager.py。
- 不要手动编辑
config/alarm.json，除非脚本不可用。
- alarm 任务的
task 必须是可直接传给主 Agent 的自然语言任务。
- alarm 到点后默认以
manual 模式唤醒主 Agent，不需要在 alarm 配置里保存 mode 字段。
- 时间使用项目运行环境的本地时间，不在
alarm.json 中保存 timezone。
alarm.json 结构
目标文件路径：
config/alarm.json
基础结构：
{
"enabled": true,
"alarms": []
}
周期型 alarm 示例：
{
"alarm_id": "alarm_0910",
"name": "盘前重点候选检查",
"enabled": true,
"trigger_time": "09:10",
"weekdays": [1, 2, 3, 4, 5],
"task": "检查当前候选池和市场状态，筛选今日盘前最值得关注的候选股票，并给出观察重点。",
"run_once": false
}
一次性 alarm 示例：
{
"alarm_id": "alarm_20260512092000",
"name": "一次性人工任务",
"enabled": true,
"trigger_datetime": "2026-05-12 09:20:00",
"task": "分析 300059 是否值得加入候选池。",
"run_once": true
}
alarm_id 规则
由脚本自动生成，不要手动传入。
周期型：
alarm_HHMM
例如：09:10 → alarm_0910
一次性：
alarm_YYYYMMDDHHMMSS
例如：2026-05-12 09:20:00 → alarm_20260512092000
如果同一时间已存在 alarm，脚本会自动追加序号：
alarm_0910_02
alarm_20260512092000_02
创建周期型 alarm
使用 add-recurring：
python skills/astra-trade-alarm/scripts/alarm_manager.py add-recurring \
--project-root . \
--time 09:10 \
--weekdays 1,2,3,4,5 \
--name "盘前重点候选检查" \
--task "检查当前候选池和市场状态，筛选今日盘前最值得关注的候选股票，并给出观察重点。"
参数说明：
--project-root：AstraTrade 项目根目录，默认 .。--time：触发时间，格式 HH:MM。--weekdays：生效星期，使用 1,2,3,4,5 表示周一至周五。--name：alarm 展示名称。--task：到点后传给主 Agent 的自然语言任务。--disabled：可选，创建后默认关闭。
创建一次性 alarm
使用 add-once：
python skills/astra-trade-alarm/scripts/alarm_manager.py add-once \
--project-root . \
--datetime "2026-05-12 09:20:00" \
--name "检查 300059" \
--task "分析 300059 是否值得加入候选池。"
参数说明：
--datetime：触发时间，格式 YYYY-MM-DD HH:MM:SS。--name：alarm 展示名称。--task：到点后传给主 Agent 的自然语言任务。--disabled：可选，创建后默认关闭。
更新 alarm
使用 update，通过 alarm_id 指定目标：
python skills/astra-trade-alarm/scripts/alarm_manager.py update \
--project-root . \
--alarm-id alarm_0910 \
--name "盘前候选池检查" \
--task "检查候选池，删除不适合继续观察的股票，并保留最值得跟踪的标的。"
可更新字段：
--name--task--enabled true|false--time HH:MM--datetime "YYYY-MM-DD HH:MM:SS"--weekdays 1,2,3,4,5
注意：
- 使用
--time 会把目标改为周期型 alarm，并设置 run_once=false。
- 使用
--datetime 会把目标改为一次性 alarm，并设置 run_once=true。
- 更新时间后，脚本会根据新时间重新生成
alarm_id。
删除 alarm
python skills/astra-trade-alarm/scripts/alarm_manager.py delete \
--project-root . \
--alarm-id alarm_0910
启用或关闭整个 alarm 系统
python skills/astra-trade-alarm/scripts/alarm_manager.py set-global \
--project-root . \
--enabled true
查看当前 alarm 配置
python skills/astra-trade-alarm/scripts/alarm_manager.py list \
--project-root .
执行建议
当用户提出模糊需求时，先自行转化为明确的 alarm 参数，不要过度追问。
示例：
用户说：
明天开盘前提醒我分析一下机器人板块
可转化为：
- 类型：一次性 alarm
- 时间：下一个交易日 09:10:00
- name：机器人板块盘前分析
- task：分析机器人板块最新行情、热点持续性和候选股票机会，给出是否需要加入候选池的建议。
用户说：
每天收盘后让 Agent 复盘一下
可转化为：
- 类型：周期型 alarm
- 时间：15:30
- weekdays：1,2,3,4,5
- name：盘后复盘
- task：复盘今日持仓、候选池、交易记录和市场状态，总结今日决策表现，并生成下一交易日观察计划。
