49 lines
5.4 KiB
Markdown
49 lines
5.4 KiB
Markdown
# 项目工作规则
|
||
|
||
用可读中文沟通和写文档,句子完整,少用符号和自造缩写。PMS负责命令、数量和账本;bionic负责研判与择时;QMT负责委托成交。
|
||
|
||
## 产品设计原则
|
||
|
||
**本系统必须站在交易员角度思考文字、界面和功能设计,而不是程序员或开发者角度。**
|
||
|
||
- 主界面优先回答当前结论、关键依据、能否操作及下一步该做什么。已有当前有效结论时,应直接展示该结论,不能用历史“未取得”、缓存状态或内部取数差异替代交易员需要的判断。
|
||
- 同一股票的卡片、摘要和详情须使用清晰一致的业务口径。历史决策依据和技术追溯信息按需查看,不抢占主要信息;保留原始审计,不用当前数据改写历史。
|
||
- 中性、尚无有效信号、分析未完成、数据不可用须准确区分。异常提示应说明对交易的实际影响和可采取的操作,不把“无读数”“未取得”“版本变化”等内部状态直接当作用户结论,也不把缺失伪装为中性。
|
||
- 沿用现有页面风格、信息密度和交互习惯。优先改善业务表达与功能本身,不靠增加标签、解释段落或开发参数让用户理解内部实现。
|
||
- 验收必须从真实交易员任务检查:是否能迅速理解当前判断、限制原因和操作结果,摘要与详情是否造成矛盾。测试通过、字段准确或程序逻辑自洽,不等于产品设计符合预期。
|
||
|
||
## 研究、分析与交易范围
|
||
|
||
北交所证券一律排除在本项目的研究、分析、回测、选股及交易范围之外。“全市场”“全部股票”也不包含北交所,须在沪深范围内按当次资格条件取样。按交易所信息和规范化证券代码在数据读取或样本构建入口排除,不为北交所额外导出数据、补资料、核验异常或生成交易动作。历史材料中已包含的北交所结果仅保留归档,不作为继续开展相关工作的依据。
|
||
|
||
## 工作流程
|
||
|
||
1. 开工先看`git status --short`、`git worktree list`和相关提交。保护已有未提交文件及其他工作树,不覆盖、不清理。新分支用`codex/`前缀;推送状态直接核对远程。
|
||
2. 从[开发入口](docs/开发入口.md)选择本任务资料,不通读历史日志。修改前读取目标目录及其父目录的适用规则,包括存在的`AGENTS.override.md`;从仓库根目录启动不能假定子目录规则已经自动加载。
|
||
3. 按影响范围验证。单测必须隔离配置、禁止联网;部署前用候选镜像完成断网回归。页面改动跑三道护栏,布局与交互另做浏览器验收。纯文档修改检查内容和链接即可。
|
||
4. 在开发机修改,经Git提交后部署,提交说明用简短中文。交付说明改动、验证机器、实际结果和未完成事项。重要节点追加`DEVLOG.md`;当前状态写接续记录,注明核验时间。历史回执不等于当前健康,本地通过不等于真机判收。
|
||
|
||
## 授权边界
|
||
|
||
- 按当前任务及会话已有授权推进,不因旧文档或技能重复索要许可。当前155模拟PMS的必要服务器、容器、数据库操作及PMS重启已获授权;不扩展为宿主机重启、新的破坏性清账或其他系统的写操作。
|
||
- 188真实PMS不在本阶段范围内。执行前核对主机、实例表前缀、运行模式及实际镜像。范围不清或确需超出授权时才询问,并说明具体原因。
|
||
- 用户新增命令和暂停优先于既有计划。已经取消的观察期、旧参数和历史暂停不能重新套用;运行值到ParamStore及实际回执核实。
|
||
|
||
## 关键禁区
|
||
|
||
- 命令至上。自动动作不得突破用户约束,命令冲突交用户裁决。研判不可用按既定保守规则和人工确认降级,不自建第二套研判。
|
||
- 先记账后动作,故障守成。指令落表后才下发,以QMT实际持仓对账;不伪造信号、成交、冻结时间或验收结果,不将研究结论自动上线。
|
||
- QMT只保留一个`pms-ws`连接。禁止扩副本、忽略验签、归零序号或反复重连掩盖缺口。`ONLINE`不代表确认、资金和账本都正常。
|
||
- 资金占用不得重复计算。成交按委托和策略归属,不跨策略认领,不回灌已归档旧仓。规则版本、快照与在手轮次必须一致。
|
||
- 业务参数经ParamStore读取。密钥只由环境注入并登记`SECRET_KEYS`,不入库、不进页面、日志或Git。SQL严格单表,跨表数据在服务层组合。
|
||
- 测试不得连接真实服务或用真实成交补账。新外部依赖补内存桩,不靠吞异常通过测试。
|
||
- 改Python后必须构建镜像并重建受影响容器,`restart`不能更新代码。先检查实际挂载和私有覆盖文件,不为追平版本重复重启。
|
||
|
||
## 按需入口
|
||
|
||
- 后端分层与数据约束:[app/AGENTS.md](app/AGENTS.md)。前端另读[app/web/AGENTS.md](app/web/AGENTS.md)。
|
||
- 测试与脚本:[scripts/AGENTS.md](scripts/AGENTS.md)。历史实验:[research/AGENTS.md](research/AGENTS.md)。
|
||
- 部署时使用[pms-release](.agents/skills/pms-release/SKILL.md);QMT联调或排障时使用[pms-qmt-diagnose](.agents/skills/pms-qmt-diagnose/SKILL.md)。普通改文档不加载这两个技能。
|
||
|
||
规则按上述范围维护,不复制多份。`CLAUDE.md`保留原样,停止同步维护;后续修改和提交不要求附带它。最新参数、镜像、故障与实验结果放接续文档,不继续堆入本文件。
|