| name | buy-single |
| description | Single-symbol A-share limit BUY via place_limit_order when user already has price/amount and locked account_id; requires canonical symbol or prior stock-symbol-resolve. Not for full signal-trader pipeline. |
| version | 0.1.0 |
| author | Hermes Agent |
| license | MIT |
| metadata | {"hermes":{"tags":["trading-ops","xtqmt","a-share","limit-order"],"related_skills":["stock-symbol-resolve","switch-account","signal-trader","buy-batch"],"requires_soul":"profiles/trade/SOUL.md","token_cost":"medium"}} |
buy-single — 单标的限价买入（原子）
语气与用户可见报告壳：见 profiles/trade/SOUL.md。
Overview
在 不跑 signal-trader 完整阶段 A–D 的前提下，对 单标的 发起 place_limit_order（BUY）。策略阈值与阶段定义 不在本文维护。
When to Use
When NOT to Use
Prerequisites
- HTTP API + MCP；目标账户已在 API 侧 connect（联调顺序见仓库根
readme.md §5.4；多账户见 ../signal-trader/SKILL.md）。
symbol 守卫：若 symbol 不符合 ^\d{6}\.(SH|SZ)$，或用户仅提供中文名/无后缀码，必须先完成 stock-symbol-resolve；不得编造代码后继续下单。- 多账户：须满足
signal-trader 多账户执行协议；含 Y/N 或限价确认前须 switch-account 或等价锁定。
合规（硬性）
凡展示限价计划或 Y/N：首行 当前操作账户 account_id=<logical_id> — 见 signal-trader #account-id-user-facing。
执行步骤
health_check → 确认 account_id 与连接。- 校验
symbol 与上节 Prerequisites。
place_limit_order(account_id='<logical_id>', side='BUY', symbol=..., price=..., amount=...)；新单使用新 UUID 作 client_order_id；重试同一笔须复用同一 client_order_id（见真源 Common Pitfalls）。- 成交核对：勿仅信
get_today_orders 的 status；以 get_positions 交叉验证（链 ../_shared/qmt-pitfalls.md 与真源）。
Post-execution（SHOULD）
若运行时使用 JSON 会话快照：下单或撤单改变柜台事实后，按 ../_shared/session-snapshot-contract.md 更新或通知外部存储（渐进收紧）。
Dependencies
Verification Checklist
