SuperAPI AI 工具集

quantmind-dev

办公与效率

查看项目

更新于 10-16 00:01

技能介绍

QuantMind Dev 是面向 QuantMind 代码库贡献者的开发工作流技能,用于指导如何参与该项目本身的开发,不涉及把 QuantMind 作为库在自己项目中使用。

用途与入口:先通过仓库的 contexts/README.md 选择本次贡献对应的开发上下文;阅读根目录 AGENTS.md 或 CLAUDE.md 了解稳定的架构约束与模块地图;当任务新增、修改或使用公共操作或公共网络源时,阅读 docs/README.md。创建、更新或分类 issue 与 PR 时,使用 contexts/dev/labels.md 中的标签指引;撰写或编辑任何 GitHub 正文前,遵循 contexts/dev/github-writing.md 的写作风格,包括其禁止硬换行规则。

工作流选择:技能要求只加载一个工作流参考。贡献者环境搭建、钩子与首次验证,或提交 bug/缺失能力 issue,参考 references/setup.md;提交已暂存工作参考 references/commit.md;开启或更新 PR 参考 references/pull-request.md;实现或重构 quantmind/ 下内容前先读 references/develop-components.md;新增或编辑 contexts/ 页面参考 references/write-contexts.md。功能任务通常串联开发、提交、PR 三步。

规则与限制:bash scripts/verify.sh 是确定性的必需验证,每次推送前和将 PR 标记为就绪前都要运行,CI 工作流运行同一套验证。公共网络集成有独立的有界冒烟测试,由 e2e.yml 负责其定时、手动和路径过滤的组件任务;修改该组件及发布前需运行 docs/README.md 中列出的所有适用测试,外部服务可用性不得阻塞无关变更。docs/README.md 是组件冒烟测试命令的唯一目录;新增实时组件需添加 scripts/verify_<component>_e2e.py、在现有 e2e.yml 中增加命名任务、精确的 PR 路径覆盖和一行目录记录,多个实时任务时使用 GitHub 原生按任务变更检测,不得新增独立工作流、通用 E2E 运行器或注册表、基础 E2E 类。除非用户明确授权,不得用 --no-verify 绕过 pre-commit/pre-push 钩子。新功能需附带单元测试和聚焦示例。该技能在 .agents/skills/quantmind-dev/ 与 .claude/skills/quantmind-dev/ 下镜像,内容相同,修改时需在同一变更中更新两处。产品决策(新模块、新依赖、API 重设计)需先开 issue 并与维护者讨论,不应写入本技能。