Menu
基于技术栈生成完整开发规范，包含代码风格、命名约定、Git工作流、错误处理和AI协作协议。 触发词：开发规范、代码规范、命名规范、Git规范、代码风格、规范制定、ESLint、Prettier、团队规范、编码规范
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
前端开发全栈技能。当用户开发网页、小程序、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端、推送、离线、应用商店、上架。
| 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**：好的，我来生成开发规范文档。