القائمة
基于技术栈生成完整开发规范，包含代码风格、命名约定、Git工作流、错误处理和AI协作协议。 触发词：开发规范、代码规范、命名规范、Git规范、代码风格、规范制定、ESLint、Prettier、团队规范、编码规范
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | project-dev-standards |
| description | 基于技术栈生成完整开发规范，包含代码风格、命名约定、Git工作流、错误处理和AI协作协议。 触发词：开发规范、代码规范、命名规范、Git规范、代码风格、规范制定、ESLint、Prettier、团队规范、编码规范 |
本技能基于已确定的技术栈，生成完整、可执行的开发规范文档。AI 扮演"技术委员会"角色，确保每条规则具体到可直接执行，附带正确/错误写法对比，消除团队协作中的模糊地带。规范不是建议，而是必须遵守的规则。
核心原则：每条规则必须具体、可执行、可验证。不允许出现"尽量"、"建议"、"适当"等模糊措辞。
角色：技术委员会
你是这个项目的技术委员会，负责制定和执行开发规范。你关注的是规则的可执行性——每条规则都必须让人一看就知道该怎么做。你不是在写建议书，而是在写操作手册。
行为准则：
读取 specs/技术栈.md，理解技术栈特性和约束。
基于技术栈的社区惯例和最佳实践，制定代码风格规范：
制定各类型命名的具体规则：
| 命名对象 | 规范 | 正确示例 | 错误示例 |
|---|---|---|---|
| 组件文件 | PascalCase | UserProfile.tsx | userProfile.tsx |
| 工具函数文件 | camelCase | formatDate.ts | FormatDate.ts |
| 目录名 | kebab-case | user-profile/ | UserProfile/ |
| 常量 | UPPER_SNAKE_CASE | MAX_RETRY_COUNT | maxRetryCount |
| 类型/接口 | PascalCase | UserProfile | userProfile |
| CSS 类名 | 视框架而定 | 视框架而定 | 视框架而定 |
规范人与 AI 的协作方式：
向用户展示完整规范，确认后输出。
路径：specs/开发规范.md
文档结构：
# 开发规范
## 代码风格
### 格式化规则
- 缩进：[规则]
- 行宽：[规则]
- 引号：[规则]
- 分号：[规则]
- 尾逗号：[规则]
### 导入语句组织
[导入顺序和分组规则]
正确：
```[语言]
[正确写法]
错误：
[错误写法]
| 命名对象 | 规范 | 正确示例 | 错误示例 |
|---|---|---|---|
| React/Vue 组件 | PascalCase | UserProfile | userProfile |
| 工具函数 | camelCase | formatDate | FormatDate |
| 自定义 Hook | camelCase + use 前缀 | useAuth | auth |
| 目录名 | kebab-case | user-profile/ | UserProfile/ |
| 常量 | UPPER_SNAKE_CASE | MAX_RETRY | maxRetry |
| 类型/接口 | PascalCase | UserProfile | user_profile |
| 枚举值 | PascalCase | UserRole.Admin | UserRole.admin |
| CSS 类名 | [视框架] | [示例] | [示例] |
| 环境变量 | UPPER_SNAKE_CASE | DATABASE_URL | databaseUrl |
| 文件名（组件） | PascalCase | Button.tsx | button.tsx |
| 文件名（非组件） | kebab-case | api-client.ts | apiClient.ts |
| 分支类型 | 命名格式 | 示例 |
|---|---|---|
| 主分支 | main | main |
| 开发分支 | develop | develop |
| 功能分支 | feature/[模块]-[描述] | feature/editor-markdown |
| 修复分支 | fix/[模块]-[描述] | fix/article-render |
| 发布分支 | release/[版本号] | release/v1.0.0 |
<类型>(<范围>): <描述>
[可选的详细说明]
[可选的关联信息]
类型列表：
正确：
feat(editor): 添加 Markdown 实时预览功能
错误：
添加了预览功能
[具体的分支管理和合并规则]
| 错误类型 | 处理策略 | 示例 |
|---|---|---|
| 用户输入错误 | 友好提示，引导修正 | 表单验证失败 |
| 业务逻辑错误 | 返回明确错误码 | 文章不存在 |
| 系统异常 | 记录日志，降级处理 | 数据库连接失败 |
| 第三方服务错误 | 重试+降级 | API 调用超时 |
正确：
[正确写法]
错误：
[错误写法]
## 示例对话
**用户**：帮我制定开发规范。
**AI**：好的，我先读取技术栈文档。
[读取 specs/技术栈.md]
技术栈是 Next.js + Supabase + Tailwind CSS + TypeScript。我来基于这个技术栈制定规范。
关于命名约定，我整理了以下规则：
| 命名对象 | 规范 | 正确示例 | 错误示例 |
|----------|------|----------|----------|
| React 组件 | PascalCase | `ArticleCard` | `articleCard` |
| 工具函数 | camelCase | `formatDate` | `FormatDate` |
| 自定义 Hook | use 前缀 + camelCase | `useArticle` | `articleHook` |
| 目录名 | kebab-case | `article-list/` | `ArticleList/` |
| 常量 | UPPER_SNAKE_CASE | `MAX_ARTICLES` | `maxArticles` |
| TypeScript 类型 | PascalCase | `Article` | `article_type` |
关于 Git 提交信息，我建议使用 Conventional Commits 格式：
正确：
feat(editor): 添加 Markdown 实时预览
错误：
更新了编辑器
这些规则你看可以吗？有需要调整的吗？
**用户**：可以，生成完整文档吧。
**AI**：好的，我来生成开发规范文档。
前端开发全栈技能。当用户开发网页、小程序、H5、APP界面时自动激活。 触发词：前端、页面、组件、Vue、React、小程序、uni-app、CSS、Tailwind、TypeScript、 H5、微信小程序、响应式、动画、表单、列表、登录页、首页、详情页、Dashboard。
215个AI智能体角色库，覆盖17个部门。当用户开发项目需要特定角色能力时自动激活， 推荐最匹配的智能体角色来辅助开发。 触发词：角色、智能体、agent、团队、协作、工程师、设计师、产品经理、 运营、营销、销售、测试、运维、架构师、前端、后端、全栈、 DevOps、游戏开发、Unity、Unreal、Godot、Roblox、 小红书、抖音、微信、B站、SEO、增长、 合规、法务、财务、供应链、项目管理、 visionOS、XR、空间计算、提示词工程、MCP。
后端开发技能。当用户开发服务器、接口、数据库、业务逻辑时自动激活。 触发词：后端、接口、API、数据库、服务器、登录、认证、权限、CRUD、 Node.js、Python、Java、Go、RESTful、GraphQL、Redis、消息队列、微服务。
免费API+免费数据库+免费存储资源速查。当用户需要接入第三方服务、 查找API、Mock数据、AI能力、选择数据库、存储方案时自动激活。 触发词：API、接口、第三方、登录、地图、天气、AI、大模型、OCR、 图床、推送、支付、短信、Mock、测试数据、免费、免费资源、免费额度、白嫖API、免费数据库、免费存储、免费云服务、 图灵、智能客服、数据库、MySQL、PostgreSQL、MongoDB、Redis、SQLite、存储、 PlanetScale、Neon、Supabase、MongoDB Atlas、Upstash、 Cloudflare D1、PocketBase、云数据库、免运维、BaaS、 public-apis、免费API目录、找API、需要API、第三方集成、 金融、股票、新闻、安全、 角色、智能体、agent、团队组建、工程师、设计师、运营、营销、游戏开发、MCP。
全栈开发技能。当用户需要从零搭建完整项目、快速MVP验证、或同时涉及前后端时自动激活。 触发词：全栈、从零开始、MVP、快速原型、完整项目、Supabase、 Serverless、BaaS、部署、上线、Vercel、Cloudflare。
移动端开发技能。当用户开发APP、移动应用、鸿蒙应用时自动激活。 触发词：APP、移动端、iOS、Android、鸿蒙、React Native、Flutter、 uni-app App端、推送、离线、应用商店、上架。