大数跨境
0
0

Qoder-Rules 开源发布!让 Qoder 开发更规范、高效、智能!遵循开发规范、阿里云AI云原生与卓越架构、最佳实践

Qoder-Rules 开源发布!让 Qoder 开发更规范、高效、智能!遵循开发规范、阿里云AI云原生与卓越架构、最佳实践 沐然云计算
2025-11-10
52
导读:Qoder开发更轻松,遵循开发规范、阿里云AI卓越架构、AI云原生应用架构、最佳实践

我们开源了Qoder-Rules


AI开发的痛点,讲又不听,听又不懂

跟AI对话又爱又恨,跟电影中的一段台词非常像。

讲你又不听

听又不懂

懂又不做

做你又做错

错又不认

认又不改

改又不服

不服你又不说

开发者在使用Qoder时需要大模型自动生成一些文档,再生成代码,这个过程中确定性并不高、每次生成的文档和代码随意性较大。这次问题每次都要提,不如通过Qoder Rules固定下来。需要一个开源Rules模板,开发者可以直接使用或二次开发。

* 图来自网络

需要一堆最佳实践模板Rules

在Qoder中配置Rules可以在一定程度上解决这个问题,对于每个开发者来说每次都重新写Rules也费时费力,所以整理一套Rules脚手架模板,开发者可以直接git clone下载并作为Qoder Rules来使用。帮助Qoder开发者更快、更好的开发项目。

Qoder-Rules:https://github.com/lvzhaobo/qoder-rules

Qoder-Rules遵循的流程、框架、规范

  1. 开发全生命周期流程

  2. 开发者总结的最佳实践

  3. 阿里云AI卓越架构

4. AI原生应用架构白皮书


目录与模板


Requirements Spec (开发需求规范)

13 条关键规则,确保代码完整性、可运行性和质量:

  • ✅ RULE 1 - 生成完整可运行代码(无 TODO、无占位符)

  • ✅ RULE 2 - 复用现有代码和 API

  • ✅ RULE 3 - 最小化新增依赖

  • ✅ RULE 6 - 验证所有 API 是否存在(关键)

  • ✅ RULE 10 - 确保代码成功编译(关键)

  • ✅ RULE 13 - 只使用真实存在的库(关键)


Testing Spec (测试规范)

12 条测试标准,确保代码质量:

  • 测试完整性 - 新功能必须包含测试

  • 覆盖率目标 - Web 70%+, CLI 80%+, Library 85%+

  • 测试分层 - 单元测试 70%, 集成 20%, E2E 10%

  • Mock 规范 - 外部依赖必须 Mock


Security Spec (安全规范)

12 条安全标准,防护常见漏洞:

  • 输入验证与清理 - 防止注入攻击

  • 认证与授权 - 强认证细粒度授权

  • 敏感数据保护 - 加密存储和传输

  • OWASP Top 10 防护


Error Handling Spec (错误处理规范)

12 条错误处理标准:

  • 错误分类 - 业务/系统/第三方错误

  • 自定义错误类 - 领域特定错误

  • 用户友好提示 - 清晰可操作消息

  • 全局错误处理器 - 统一错误中间件


spec-coding-design-patterns/├── core/                          # 核心规范(必需)│   ├── requirements-spec.txt      # 开发需求规范(13条规则)│   ├── requirements-spec.zh-CN.txt│   ├── workflow-spec.txt          # 工作流规范(12条规则)│   ├── workflow-spec.zh-CN.txt│   ├── naming-conventions.txt     # 命名约定(12条约定)│   ├── naming-conventions.zh-CN.txt│   ├── spec-index.txt             # 中心索引和配置│   └── spec-index.zh-CN.txt├── quality/                       # 质量保证规范(推荐)│   ├── testing-spec.zh-CN.txt    # 测试规范(12条规则)│   ├── security-spec.zh-CN.txt   # 安全规范(12条规则)│   └── error-handling-spec.zh-CN.txt  # 错误处理规范(12条规则)├── architecture/                  # 架构设计规范(可选)│   ├── api-design-spec.txt       # API 设计规范│   └── database-spec.txt         # 数据库规范├── templates/                     # 快速启动模板│   ├── web-starter/              # Web 应用脚手架│   ├── cli-starter/              # CLI 工具脚手架│   └── library-starter/          # 库/SDK 脚手架├── tools/                         # 规范验证工具│   ├── spec-lint.py              # 规范检查工具│   └── spec-report.js            # 合规报告生成器└── ide-integration/               # IDE 集成配置    ├── .vscode/settings.json     # VS Code 配置    └── .editorconfig             # 编辑器通用配置

如何使用:先git clone,再@

  • 简单方法,通过git clone下载到Qoder项目的.qoder/rules目录中

cd .qoder/rulesgit clone https://github.com/lvzhaobo/qoder-rules.git

即可通过@来加载

  • 测试,使用@architecture/alibaba-cloud-ai-spec.zh-CN.md来生成MBTI性格分析网页,并且对比使用这个规则Rule和不使用会有哪些不同。显示采用规则Rule的构建能够遵循规则文档中的说明,按照预期模板来构建应用。

  • 继续对比使用这个Rule和不使用的差别
  • 生成的MBTI性格分析测试网页,看页面并没有哪些差别,底层代码部分会更规范、会遵循阿里云AI卓越架构的设计规范。

  • 在活动中分享,不少开发者很感兴趣并且认为是很创新的思路

推广计划

  • 跟德国一开源项目团队沟通,确定了当前方案的合理性、可行性;

  • 在线上智能体和提示词直播中也介绍了这种方案,很多开发者感兴趣并且认为具有很大创新性;

  • 继续通过开源让更多开发者参与Qoder Rules贡献、测试、使用并改进;

  • 可作为Qoder插件或开源项目,帮助更多开发者,我们也将提供更多真实个人开发者、企业开发者使用Qoder的最佳实践。


欢迎参与

Qoder-Rules:https://github.com/lvzhaobo/qoder-rules

在这里或点击阅读原文使用Qoder:https://qoder.com/referral?referral_code=PmAdAZZq77OX6QL0rdkdig1zLCFVpuMi

【声明】内容源于网络
0
0
沐然云计算
生成式AI与云计算领域知识分享、开发与架构经验交流,以动手实践为驱动的Hands-on Lab方式进阶、关注儿童AI教育领域
内容 297
粉丝 0
沐然云计算 生成式AI与云计算领域知识分享、开发与架构经验交流,以动手实践为驱动的Hands-on Lab方式进阶、关注儿童AI教育领域
总阅读198
粉丝0
内容297