tradingSystem/AGENTS.md

6.7 KiB
Raw Blame History

项目工作规则

用可读中文沟通和写文档,句子完整,少用符号和自造缩写。PMS负责命令、数量和账本;bionic负责研判与择时;QMT负责委托成交。

产品设计原则

本系统必须站在交易员角度思考文字、界面和功能设计,而不是程序员或开发者角度。

  • 主界面优先回答当前结论、关键依据、能否操作及下一步该做什么。已有当前有效结论时,应直接展示该结论,不能用历史“未取得”、缓存状态或内部取数差异替代交易员需要的判断。
  • 同一股票的卡片、摘要和详情须使用清晰一致的业务口径。历史决策依据和技术追溯信息按需查看,不抢占主要信息;保留原始审计,不用当前数据改写历史。
  • 中性、尚无有效信号、分析未完成、数据不可用须准确区分。异常提示应说明对交易的实际影响和可采取的操作,不把“无读数”“未取得”“版本变化”等内部状态直接当作用户结论,也不把缺失伪装为中性。
  • 设计功能时先核对交易员要完成的操作。等待提示须写明这笔交易到了哪一步、有何限制、由谁继续处理;原因尚未查明时,只展示已核实的进度。
  • 同类页面和表格优先复用已有组件、列顺序、字号、间距、配色和交互。策略之间仅按业务需要增删列。优先改善业务表达与功能本身,不靠增加标签、解释段落或开发参数让用户理解内部实现。
  • 验收必须从真实交易员任务检查:是否能迅速理解当前判断、限制原因和操作结果,摘要与详情是否造成矛盾。测试通过、字段准确或程序逻辑自洽,不等于产品设计符合预期。

研究、分析与交易范围

北交所证券一律排除在本项目的研究、分析、回测、选股及交易范围之外。“全市场”“全部股票”也不包含北交所,须在沪深范围内按当次资格条件取样。按交易所信息和规范化证券代码在数据读取或样本构建入口排除,不为北交所额外导出数据、补资料、核验异常或生成交易动作。历史材料中已包含的北交所结果仅保留归档,不作为继续开展相关工作的依据。

工作流程

  1. 开工先看git status --short、git worktree list和相关提交。保护已有未提交文件及其他工作树,不覆盖、不清理。新分支用codex/前缀;推送状态直接核对远程。
  2. 从开发入口选择本任务资料,不通读历史日志。修改前读取目标目录及其父目录的适用规则,包括存在的AGENTS.override.md;从仓库根目录启动不能假定子目录规则已经自动加载。
  3. 按影响范围验证。单测必须隔离配置、禁止联网;部署前用候选镜像完成断网回归。页面改动跑三道护栏,布局与交互另做浏览器验收。纯文档修改检查内容和链接即可。
  4. 在开发机修改,经Git提交后部署,提交说明用简短中文。交付说明改动、验证机器、实际结果和未完成事项。重要节点追加DEVLOG.md;当前状态写接续记录,注明核验时间。历史回执不等于当前健康,本地通过不等于真机判收。

故障修复与防止返工

  • 修复前先写清违反的业务约束、规则来源和适用范围。错误实现不能成为新规则;补一个限制时,同时核对原来允许的动作仍然可达。
  • 数据、信号或异步链路按应覆盖名单逐路判收,区分输入新鲜、具备计算资格、已计算未触发、无法计算、发布和消费。顶层成功、总消息数、其他来源正常不能替代本路证据。
  • 超时按各来源的发布周期和交易时段判断,区分服务心跳、原始数据时间及名单生效时间。正常结算、午休和新名单同步等待不报故障;等待须有上限,不能随快照刷新重置,也不能放宽真实数据失效条件。
  • 修复须沿实际入口到最终保存或动作检查同一业务的其他调用方、缓存和版本,并以旧故障反例验证预防措施。线上故障定位、重复返工或恢复验收使用pms-incident-review;不要求普通文案和研究试验走完整故障流程。

授权边界

  • 按当前任务及会话已有授权推进,不因旧文档或技能重复索要许可。当前155模拟PMS的必要服务器、容器、数据库操作及PMS重启已获授权;不扩展为宿主机重启、新的破坏性清账或其他系统的写操作。
  • 188真实PMS不在本阶段范围内。执行前核对主机、实例表前缀、运行模式及实际镜像。范围不清或确需超出授权时才询问,并说明具体原因。
  • 用户新增命令和暂停优先于既有计划。已经取消的观察期、旧参数和历史暂停不能重新套用;运行值到ParamStore及实际回执核实。

关键禁区

  • 命令至上。自动动作不得突破用户约束,命令冲突交用户裁决。研判不可用按既定保守规则和人工确认降级,不自建第二套研判。
  • 先记账后动作,故障守成。指令落表后才下发,以QMT实际持仓对账;不伪造信号、成交、冻结时间或验收结果,不将研究结论自动上线。
  • QMT只保留一个pms-ws连接。禁止扩副本、忽略验签、归零序号或反复重连掩盖缺口。ONLINE不代表确认、资金和账本都正常。
  • 资金占用不得重复计算。成交按委托和策略归属,不跨策略认领,不回灌已归档旧仓。规则版本、快照与在手轮次必须一致。
  • 业务参数经ParamStore读取。密钥只由环境注入并登记SECRET_KEYS,不入库、不进页面、日志或Git。SQL严格单表,跨表数据在服务层组合。
  • 测试不得连接真实服务或用真实成交补账。新外部依赖补内存桩,不靠吞异常通过测试。
  • 改Python后必须构建镜像并重建受影响容器,restart不能更新代码。先检查实际挂载和私有覆盖文件,不为追平版本重复重启。

按需入口

规则按上述范围维护,不复制多份。CLAUDE.md保留原样,停止同步维护;后续修改和提交不要求附带它。最新参数、镜像、故障与实验结果放接续文档,不继续堆入本文件。