lanyuanxiaoyao
e09ced44ee
- openspec/config.yaml 保留最高级前端规约和样式红线 - docs/development/README.md 引用前端专题文档避免重复 - docs/development/frontend.md 补充 antd、组件、样式、表单、测试等具体规范
39 lines
3.0 KiB
YAML
39 lines
3.0 KiB
YAML
schema: fast-drive
|
||
|
||
context: |
|
||
- 使用中文（注释、文档、交流），面向中文开发者
|
||
- **优先阅读 docs/README.md** 获取文档路由、归属矩阵和影响分析规则
|
||
- **其次阅读 docs/development/README.md** 获取开发规范、常用命令、质量门禁和全局规则
|
||
- 文档文件名优先使用单个英文单词（usage.md、config.md、deploy.md、troubleshoot.md），目录上下文足以消歧时不在文件名重复限定词
|
||
- 每次代码变更必须执行文档影响分析：
|
||
- 用户可见行为、配置、部署、运行行为变更 → 更新 docs/user/ 对应文档
|
||
- 开发流程、架构、测试、构建发布流程变更 → 更新 docs/development/ 对应文档
|
||
- 项目定位、快速开始、核心能力列表、文档导航变更 → 更新 README.md
|
||
- 文档同步规则或文档归属矩阵变更 → 更新 docs/README.md 和本文件
|
||
- 无需更新文档时必须在收尾说明中说明原因
|
||
- 新增代码优先复用已有组件、工具、依赖库，不引入新依赖
|
||
- 新增的逻辑必须编写完善的测试，并保证测试的正确性，不允许跳过任何测试
|
||
- 这是基于bun实现的前端后一体化项目，使用bun作为唯一包管理器，严禁使用pnpm、npm，使用bunx运行工具，严禁使用npx、pnpx
|
||
- src/server目录下是基于bun实现的后端代码
|
||
- 后端库使用优先级：Bun 内置 API > es-toolkit > 主流三方库 > 项目公共工具 > 自行实现
|
||
- src/web目录下是基于Bun HTML import、React、Ant Design实现的前端代码
|
||
- 前端最高规约：优先使用 antd 组件默认能力和组件 props 组合界面，具体组件、样式、数据流和测试细节遵循 docs/development/frontend.md
|
||
- 前端样式红线：禁止组件内联 style、覆盖 antd 内部类名、使用 !important、硬编码色值
|
||
- Git提交: 仅中文; 格式"类型: 简短描述", 类型: feat/fix/refactor/docs/style/test/chore; 多行描述空行后写详细说明
|
||
- 禁止创建git操作task
|
||
- 积极使用subagents精心设计并行任务，节省上下文空间，加速任务执行
|
||
- 优先使用提问工具对用户进行提问
|
||
- 本项目为 Bun 全栈应用（Alfred·阿福），docs/user/ 记录用户使用方法，docs/development/ 记录开发技术细节
|
||
- 本项目无需考虑向前兼容性
|
||
|
||
rules:
|
||
design:
|
||
- fast-drive的design.md章节标题和正文使用中文；仅OpenSpec术语、文件名、schema字段名、命令和代码符号保留英文
|
||
- 先前的讨论技术方案要尽可能体现在设计文档中，便于指导实现阶段不偏离已定的技术路线
|
||
tasks:
|
||
- fast-drive的tasks.md分组标题、任务描述和验证说明使用中文；每个任务必须保留OpenSpec CLI可解析的单行checkbox格式
|
||
- 一行一个任务，严禁任务内容跨行
|
||
- 如果是代码存在更新必须
|
||
- 执行完整的测试、代码检查、格式检查等质量保障手段
|
||
- 执行文档影响分析，更新 README.md 和/或 docs/ 下对应文档
|