本仓库是 Vibe-Trading（AI 量化研究助理）+ vectorbt（本地回测框架） + JoinQuant（聚宽云端平台）+ 本地归档复盘的量化研究工作台。
- JoinQuant：正式回测和模拟交易只在 JoinQuant（聚宽）云端运行；本地只做策略编写、本地回测、资料整理、结果归档和复盘。
- Vibe-Trading：只作为研究、策略草稿、归因和报告工具；不作为正式回测或模拟交易裁判。
- vectorbt：本地唯一回测框架，用于模拟交易和策略验证；禁止自研本地回测框架，必须使用本仓库提供的框架。
- Python：默认必须提权使用项目
.venv，不使用系统 Python。 - 构建与验证：使用
build-and-verifySkill（技能）执行构建检查和验证；禁止自行新增构建和验证入口。
- 先行调查：进行任务前，先行调研，不推测未知内容；不确定时先验证。
- 执行边界：只执行用户明确授权的操作；未授权时先给方案或草案等待确认，禁止自行安装、改配置、重构、删除、提交、切换分支或启停服务。
- 文件规范：优先编辑现有文件；非必要不新建；任务后清理临时产物。
- Git（版本管理）：分支名使用 ASCII（英文字符）模板，提交说明用简体中文。
- PR 纪律：进入主干须通过 PR；用户显式授权才可直写主干；禁止把功能分支本地合入主干。
- 安全性：破坏性操作前必须确认，包括修改配置、删除、覆盖、强制推送、硬重置、
--no-verify。 - 密钥安全：禁止提交账号、密码、token（访问令牌）、cookie（浏览器凭证）和任何私密配置。
- 完成验证：逐项复核要求，说明已验证与无法验证的部分。
- 完整集成测试：必须运行覆盖对应主流程的端到端回归；端到端回归必须从用户入口或发布形态跑完整业务流程，不能用几个单元测试拼接替代。
- 输出：简体中文，简洁直白；英文技术名词后跟中文释义。
- 引用：引用本地文件时使用可点击路径。
问题以本地 Markdown（标记文档）文件形式保存在 myspec/changes/<change-name>/。详见 docs/agents/issue-tracker.md。
五种标准问题分流状态保持原名不变。详见 docs/agents/triage-labels.md。
本仓库采用 single-context（单上下文）布局。详见 docs/agents/domain.md。