tickflow-assist 0.2.0

package/skills/stock-analysis/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: stock_analysis
+description: Analyze A-share watchlist symbols, update daily K-line data, run monitor, and report status through the TickFlow Assist plugin.
+metadata:
+  openclaw:
+    skillKey: stock_analysis
+    requires:
+      config: true
+---
+# 股票分析与监控
+
+这是 TickFlow Assist 插件内置的技能，用于通过插件工具完成 A 股自选股管理、日线更新、分钟K抓取、技术分析、关键价位回测、实时监控、定时日更、结果查看与告警测试。
+
+此技能随插件加载，不需要手动复制到 workspace。
+
+优先使用 TickFlow Assist 插件工具，不要改用 `exec`、shell 命令、`node -e`、`python -c`、直接文件读写或数据库脚本，也不要在没有工具结果的前提下自行推断分析结论、监控状态或数据更新结果。
+
+适用场景：
+- 添加或删除自选股
+- 查看自选列表
+- 刷新自选股名称
+- 拉取单只股票的 K 线数据
+- 拉取单只股票的分钟 K 线数据
+- 搜索个股 / 板块 / 宏观相关资讯、公告、研报、政策、事件解读
+- 按自然语言条件做智能选股
+- 执行全部日更
+- 分析单只股票
+- 回测活动价位 / 回测股票
+- 查看最近一次已保存的分析结果
+- 开启或停止实时监控
+- 查询监控状态
+- 测试告警发送
+
+中文意图与工具映射：
+- “添加自选”、“加入观察”、“加股票” -> `add_stock`
+- “删除自选”、“移除股票”、“删掉这只股票” -> `remove_stock`
+- “查看自选”、“自选列表” -> `list_watchlist`
+- “刷新股票名称”、“刷新名称” -> `refresh_watchlist_names`
+- “拉 K 线”、“更新 K 线”、“获取日线” -> `fetch_klines`
+- “获取分钟K”、“拉取分钟线”、“抓分时K” -> `fetch_intraday_klines`
+- “搜资讯”、“查公告”、“看研报”、“政策解读”、“事件解读” -> `mx_search`
+- “选股”、“筛股票”、“找满足条件的股票”、“推荐板块成分股” -> `mx_select_stock`
+- “全部更新”、“执行日更”、“更新全部股票” -> `update_all`
+- “启动定时日更”、“开始定时日更”、“开启 TickFlow 日更计划” -> `start_daily_update`
+- “停止定时日更”、“关闭 TickFlow 日更计划” -> `stop_daily_update`
+- “TickFlow日更状态”、“自选股日更状态”、“TickFlow定时更新状态”、“TickFlow定时日更状态” -> `daily_update_status`
+- “分析一下某只股票”、“分析 002261” -> `analyze`
+- “回测股票”、“开始回测”、“回测关键价位”、“回测 002261”、“看回测结果” -> `backtest_key_levels`
+- “查看分析结果”、“看上次分析” -> `view_analysis`
+- “看技术面分析”、“看基本面分析”、“看资讯面分析” -> `view_analysis`
+- “看最近3次分析”、“回看历史分析”、“看最近几次技术面/基本面/资讯面分析” -> `view_analysis`
+- “开始盯盘”、“开启监控”、“启动监控” -> `start_monitor`
+- “停止盯盘”、“关闭监控”、“停止监控” -> `stop_monitor`
+- “监控状态”、“现在监控在跑吗” -> `monitor_status`
+- “测试告警” -> `test_alert`
+
+参数理解规则：
+- 对“添加自选 / 删除自选 / 查看自选 / 监控状态 / 日更状态”这类一跳即可完成的意图，首个动作必须直接调用对应插件工具；禁止先调用 `read`、`write`、`edit`、`query_database`、子代理、会话生成、环境探测工具，禁止先说“我先找一下方法”“我先确认工具”之类的话。
+- 当用户消息中已经包含足够参数时，必须直接执行，不得额外探索：
+  - “添加自选 601872” -> 直接调用 `add_stock`
+  - “添加自选 601872 成本 5.32” -> 直接调用 `add_stock`
+  - “删除自选 601872” -> 直接调用 `remove_stock`
+  - “自选列表” -> 直接调用 `list_watchlist`
+  - “查立讯精密最新研报” -> 直接调用 `mx_search`
+  - “找今天涨幅 2% 的股票” -> 直接调用 `mx_select_stock`
+- 如果工具必需参数缺失，只能补充缺失项本身；不要以“我需要摸索当前环境里的工具”“我需要确认执行方式”为由拒绝或拖延。
+- 股票代码按用户原始输入提取，例如 `002261`。
+- 成本价对应 `costPrice`；若用户未提供成本价，可以省略该字段。
+- `add_stock` 默认会在添加成功后自动拉取日K并计算指标。
+- `analyze` 会读取本地日K和日线指标，临时补充当日分钟K、分钟指标、实时行情、最新财务数据与资讯检索结果，再走固定流水线综合分析；其中基本面部分在 `Expert` 级别下优先使用 TickFlow 完整财报，在非 `Expert` 级别下回退为 `mx_select_stock` 的 lite 指标拖底模式。
+- `view_analysis` 默认查看最近一次综合分析；如用户明确提到“技术面 / 基本面 / 资讯面 / 全部分析”，应传入 `profile=technical|financial|news|all`；如用户提到“最近 N 次”或“历史”，应同时传入 `limit=N`（或 `count=N`）。
+- `update_all` 除了更新日K和日线指标，也会同步更新当日分钟K；本地分钟K默认仅保留近 30 个交易日。
+- `update_all` 是立即执行一次日更；`start_daily_update` / `stop_daily_update` 控制的是后台定时日更进程，两者不要混淆。
+- `backtest_key_levels` 默认回测全部关注股的活动价位；如果用户提到股票代码，应传入 `symbol`；如果用户提到“最近 N 次”，应传入 `recentLimit=N`。
+- 若配置中的 `tickflowApiKeyLevel` 为 `Free` 或 `Start`，则应自动跳过分钟K获取；若分钟K接口失败，也不要让 `analyze` 或 `update_all` 因此整体失败。
+- 对新闻、公告、研报、政策、交易规则、具体事件、时效性影响分析等外部检索类问题，优先使用 `mx_search`，不要直接凭常识回答，也不要先读仓库文件再决定是否搜索。
+- 对自然语言选股、板块成分股、条件筛选、候选池推荐等任务，优先使用 `mx_select_stock`；若问题本质是“找哪些标的符合条件”，不要误用 `mx_search`。
+- 用户在“添加自选”意图中提到的“`N`天”对应 `add_stock.count`（或 `klineCount`），例如“添加 002261 成本 34.15 并获取 120 天日K”应调用 `add_stock`，其中 `count=120`。若用户未提供成本价但明确要求拉取 `N` 天日K，可只传 `symbol` 与 `count`。
+- 用户询问 TickFlow / 自选股 的日更状态时，必须调用 `daily_update_status`，不要把它解释成其他 crontab、系统任务或无关插件的定时更新。
+- 对 `daily_update_status`、`monitor_status`、`list_watchlist` 这类轻量状态查询，禁止使用 `sessions_spawn`、子代理、并行子任务、`query_database`、文件读取或任何“先分析再回答”的编排；必须在当前回合直接调用对应插件工具并返回结果。
+- 对 `add_stock`、`remove_stock` 同样适用上述限制：不得先读文件、读目录、读 skill、自查工具列表或推测执行方法，必须直接调用工具。
+- `daily_update_status` 不依赖数据库查询工具；如果模型想改用 `query_database`、读取状态文件、读取交易日历文件，或拆成多个子任务，应视为错误策略并立即改回直接调用 `daily_update_status`。
+- 如果模型想调用 `read` 查看仓库、配置、数据库目录、SKILL 内容或工具脚本来决定是否添加/删除自选，应视为错误策略并立即改回 `add_stock` / `remove_stock`。
+- 禁止使用 `exec`、shell、`node -e`、`python -c`、SQL/LanceDB 脚本、直接编辑数据文件或任何“自己写脚本完成工具能力”的替代路径。
+- 如果当前环境拿不到对应插件工具，应直接说明无法通过该技能执行，不要回退到 `exec` 或命令行绕过。
+- 当用户追问“这个任务怎么执行的”“刚才是怎么做的”时，如果任务是通过插件工具完成的，应只说明实际调用的工具名与关键参数；不要默认展开成 `npm run tool -- ...`、shell 命令、`cd ~/projects/...`，也不要把本地调试命令当成对话里的真实执行链路。只有用户明确要求“给我命令行等价命令”时，才允许给出 CLI 示例。
+- 对 `daily_update_status` 的返回结果，不要额外追加“当前是 local_config”“插件配置问题”“已重试但结果相同”这类解释性警告。先完整原样输出工具结果；只有用户继续追问原因时，才再解释调用链路差异。
+- 仅在工具必需参数缺失时，才简短指出缺少的字段。
+- 不要臆造股票代码、成本价、日期、阈值、分析结果或监控状态。
+
+输出规则：
+- 对 `add_stock`、`list_watchlist`、`start_monitor`、`stop_monitor`、`monitor_status`、`start_daily_update`、`stop_daily_update`、`daily_update_status`、`analyze`、`backtest_key_levels`、`view_analysis`、`fetch_klines`、`fetch_intraday_klines`、`mx_search`、`mx_select_stock` 和 `update_all`，调用工具后尽量原样输出返回文本。
+- 对 `daily_update_status` 必须完整原样输出，尤其不要省略 `状态`、`运行方式`、`配置来源`、`调度`、`执行情况` 与 `最近摘要`。
+- 不要改写、总结、翻译、重排、美化，也不要加表格、额外标题或解释性包装。
+- 除非工具明确返回错误，否则不要在工具结果前后添加追问、评论或推断字段。
+- 不要省略关键数值、价位、涨跌幅、日期或状态字段。
+
+错误处理：
+- 工具成功时，直接返回结果。
+- 工具明确报错时，可以补一句简短中文说明，但应保留错误原文或原始关键信息。
+- 工具报错时不要编造原因，不要给出没有依据的补救建议。
+
+监控规则：
+- `start_monitor` 与 `stop_monitor` 在 OpenClaw 插件模式下默认控制的是托管后台服务，状态里通常显示为 `plugin_service`；本地调试模式下才会回退到项目自管 detached 进程，状态通常显示为 `fallback_process`。
+- `start_daily_update` 与 `stop_daily_update` 控制的是日更定时任务，不是一次性的 `update_all`；在 OpenClaw 插件模式下通常显示为 `plugin_service`，本地调试模式下回退到项目自管 detached 进程。
+- 查询监控是否运行时优先调用 `monitor_status`，不要根据上下文猜测。

package/skills/usage-help/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: usage_help
+description: Show built-in TickFlow Assist usage help and example commands when the user asks how to use the plugin.
+metadata:
+  openclaw:
+    skillKey: usage_help
+---
+# TickFlow Assist 使用帮助
+
+这个技能用于在用户询问“怎么用”、“有哪些指令”、“使用帮助”、“命令示例”时，直接返回 TickFlow Assist 的常用用法清单。
+
+适用触发语句示例：
+- “使用帮助”
+- “怎么用这个插件”
+- “有哪些指令”
+- “给我命令示例”
+- “股票分析插件怎么用”
+
+触发规则：
+- 当用户明确询问 TickFlow Assist 的使用方式、支持的能力、常见命令或示例时，优先直接返回下面这份帮助文本。
+- 这类帮助回答默认不需要调用工具。
+- 如果用户在同一句里既要帮助又要执行操作，优先先回答帮助；只有用户明确要求立即执行时，才改为调用对应工具。
+- 禁止为了回答帮助问题去使用 `exec`、shell、`node -e`、`python -c`、读数据库文件或探测本地环境。
+- 如果用户要的是命令示例，直接给文本示例，不要实际执行这些命令。
+
+输出规则：
+- 尽量原样输出下面的帮助文本，不要擅自删改命令名。
+- 可以补一句很短的引导，但不要长篇解释。
+
+帮助文本：
+
+TickFlow Assist 常用指令：
+
+1. 添加自选
+`添加 002261`
+或
+`添加 002261 成本 34.15`
+说明：会加入自选；成本价可选，并默认自动拉取日K和计算指标。
+
+2. 添加自选并指定日K天数
+`添加 002261 成本 34.15 并获取 120 天日K`
+说明：添加后按指定天数拉取日K。若不提供成本价，也可以直接说“添加 002261 并获取 120 天日K”。
+
+3. 查看自选列表
+`查看自选`
+
+4. 删除自选
+`删除 002261`
+
+5. 拉取单只股票日K
+`拉 002261 的日K`
+或
+`获取 002261 120 天日线`
+
+6. 拉取单只股票分钟K
+`获取 002261 1m 分钟K`
+说明：抓取当日分钟线并写入本地数据库，默认只保留近 10 个交易日分钟K。
+
+7. 分析单只股票
+`分析 002261`
+说明：分析时会读取本地日K/日线指标，并临时获取当日分钟K、分钟指标和实时行情一起分析。
+
+8. 查看最近一次分析结果
+`查看 002261 的分析结果`
+
+9. 更新全部股票日K
+`更新全部股票`
+说明：收盘日更会同时更新日K、日线指标和当日分钟K。
+
+10. 开启实时监控
+`开始盯盘`
+
+11. 查看监控状态
+`监控状态`
+
+12. 查看定时日更状态
+`TickFlow日更状态`
+或
+`自选股日更状态`
+
+13. 停止实时监控
+`停止盯盘`
+
+14. 测试告警
+`测试告警`
+
+15. 查看数据库表
+`数据库里有哪些表`
+
+16. 查看表结构
+`看技术指标表结构`
+
+17. 查询数据库内容
+`查 002261 最近 5 条技术指标`
+或
+`看最近 3 条分析日志`
+
+补充说明：
+- 股票代码可直接写 `002261` 这类 6 位代码。
+- “分析”依赖本地已有日K数据；如果刚添加自选，系统现在会自动拉取。
+- 分钟K表名为 `klines_intraday`，默认保留近 10 个交易日。
+- 如果你不确定怎么说，直接发“添加股票 / 拉日K / 分析 / 开始盯盘”这类自然语言也可以。