文档入口

docs/ 根目录只保留文档入口。具体文档按用途放入子目录；AI 助手通用入口以 AGENTS.md 为准。

目录分层

目录	内容	入口
rules	仓库级规则正文	rules/index.md
guides	日常操作、研究流程、环境说明	research-workflow.md
joinquant-api	聚宽 API 数据专题资料	JQ_场内基金数据.md
reference	外部平台资料和分析参考	joinquant-api.md
indexes	机器生成的文档、报告、数据和变体索引	docs_catalog.json

常用指南

文档	内容	备注
feishu-relay-tools.md	聚宽模拟交易飞书通知工具使用说明	—

维护约定

• 新增说明型文档优先放入 guides/ 或 reference/。
• 新增或移动文档后运行 .\.venv\Scripts\python.exe -m scripts.tools.path_tools.refactor check。
• 文档和报告索引用 .\.venv\Scripts\python.exe -m scripts.research.docs index 重新生成。

PR Intent Governance

• commit intent 和 PR Issue binding audit 属于 PR Flow 治理契约，入口见 rules/pr-workflow.md 、rules/governance.md 和 openspec/changes/archive/adr-0007-pr-flow-closed-loop-review-evidence/ 。