- app.ts 单体路由拆分为 routes/ + helpers + middleware + static 独立模块 - 类型去重:CheckFailure/CheckResult 以 shared/api.ts 为唯一源头,收紧 phase 联合类型 - es-toolkit 替换:isPlainObject/isNil/isEmptyObject/isEqual/isError/Semaphore/groupBy - Bun 内置 API:Object.fromEntries 替代手写 headersToRecord - bun:sqlite 规范:prepare() → query() 利用内置缓存,避免 N+1 查询 - 新增 getLatestChecksMap/allGetTargetStats 批量查询方法 - 新增 backend-code-quality/api-route-separation/batch-data-queries 规范 - 补充 openspec/config.yaml 后端开发规范与 DEVELOPMENT.md 后端开发指引
32 lines
2.1 KiB
YAML
32 lines
2.1 KiB
YAML
schema: spec-driven
|
||
|
||
context: |
|
||
- 使用中文(注释、文档、交流),面向中文开发者
|
||
- openspec文档的关键字按openspec规范使用,不要翻译为中文
|
||
- **优先阅读README.md和DEVELOPMENT.md**获取项目概览与开发规范,所有代码风格、命名、注解、依赖、API等规范以DEVELOPMENT.md为准
|
||
- 涉及模块结构、API、实体等变更时同步更新README.md
|
||
- 新增代码优先复用已有组件、工具、依赖库,不引入新依赖
|
||
- 新增的逻辑必须编写完善的测试,并保证测试的正确性,不允许跳过任何测试
|
||
- 这是基于bun实现的前端后一体化项目,使用bun作为唯一包管理器,严禁使用pnpm、npm,使用bunx运行工具,严禁使用npx、pnpx
|
||
- src/server目录下是基于bun实现的后端代码
|
||
- src/web目录下是基于vite、react、TDesign实现的前端代码
|
||
- 后端库使用优先级:Bun 内置 API > es-toolkit > 主流三方库 > 项目公共工具 > 自行实现
|
||
- 前端样式开发优先级:TDesign组件 > 组件props > TDesign CSS tokens(--td-*) > styles.css CSS类 > 自行开发组件
|
||
- 前端严禁:组件内联style属性、CSS覆盖TD内部类名、使用!important、硬编码色值
|
||
- Git提交: 仅中文; 格式"类型: 简短描述", 类型: feat/fix/refactor/docs/style/test/chore; 多行描述空行后写详细说明
|
||
- 禁止创建git操作task
|
||
- 积极使用subagents精心设计并行任务,节省上下文空间,加速任务执行
|
||
- 优先使用提问工具对用户进行提问
|
||
- (当前项目未上线,不需要考虑向前兼容)
|
||
|
||
rules:
|
||
proposal:
|
||
- 仔细审查每一个过往spec判断是否存在Modified Capabilities
|
||
design:
|
||
- 先前的讨论技术方案要尽可能体现在设计文档中,便于指导实现阶段不偏离已定的技术路线
|
||
tasks:
|
||
- 一行一个任务,严禁任务内容跨行
|
||
- 如果是代码存在更新必须
|
||
- 执行完整的测试、代码检查、格式检查等质量保障手段
|
||
- 更新 README.md 和/或 DEVELOPMENT.md
|