القائمة
Git commit message 规范指南，基于 Conventional Commits 标准。Invoke when user asks to commit code, create commit message, or needs commit convention guidance.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Intelligent orchestrator that analyzes user intent and routes to the right skill(s). Invoke FIRST when user request involves code creation, UI/UX work, code review, or ambiguous multi-intent tasks. Prevents skill conflicts by establishing clear ownership.
Review Buddy skill — runs a structured 5-check gate on every PR before it reaches QA or Lead. Checks scope compliance, AC verifiability, do-not-touch violations, schema compliance, and pattern compliance. Outputs a clear PASS or FAIL with specific callouts. Role-aware: checks patterns for the Buddy's role only. Triggers on: review this PR, pre-review, buddy review.
Generates complete CRUD module scaffolding (list/form/detail/api) following project conventions. Invoke when user asks to create a new management page, add CRUD features, or scaffold a new system module.
Professional UI/UX design guidance with deep expertise in visual hierarchy, interaction patterns, accessibility, and design systems. Invoke when user needs layout optimization, component styling, UX improvements, or design system decisions.
| name | git-commit-guide |
| description | Git commit message 规范指南，基于 Conventional Commits 标准。Invoke when user asks to commit code, create commit message, or needs commit convention guidance. |
本 Skill 规范化 git commit message，基于 Conventional Commits 标准，适配项目现有风格。
This skill owns: Git commit message 格式、类型定义、示例模板。
Does NOT own: 执行 git 命令、代码审查（由 pre-review-checklist 负责）、代码生成（由 crud-module-generator 负责）。
Integration with dev-router: 当用户说"提交代码"、"帮我写个 commit"时，dev-router 应路由到此 Skill。
Invoke this skill when:
Do NOT invoke for:
pre-review-checklistcrud-module-generator<type>(<scope>): <subject>
<body>
<footer>
<type>: <subject>
或带 scope：
<type>(<scope>): <subject>
| 部分 | 必须 | 说明 |
|---|---|---|
<type> | ✅ | commit 类型，见下表 |
<scope> | ❌ | 影响范围（可选），如 home、user、router |
<subject> | ✅ | 简短描述，≤50字符，不以句号结尾 |
<body> | ❌ | 详细描述（可选），每行≤72字符 |
<footer> | ❌ | 关联 issue/PR（可选），如 Closes #123 |
| Type | 说明 | 示例 |
|---|---|---|
feat | 新功能 | feat: 新增用户管理模块 |
fix | 修复 bug | fix: 修复登录页面验证码不显示 |
refactor | 重构（既非新功能也非 bug 修复） | refactor: 优化路由配置结构 |
perf | 性能优化 | perf: 优化表格渲染性能 |
style | 代码风格（不影响逻辑） | style: 统一代码缩进格式 |
docs | 文档变更 | docs: 更新 README 安装说明 |
test | 测试相关 | test: 添加用户模块单元测试 |
chore | 构建/工具/依赖变更 | chore: 升级 Vite 到 8.x |
revert | 回滚 commit | revert: 回滚用户模块改动 |
是新功能？ → feat
是修 bug？ → fix
改代码结构但不改行为？ → refactor
提升性能？ → perf
只改格式/注释？ → style
改文档？ → docs
改测试？ → test
改构建/配置/依赖？ → chore
回滚？ → revert
| Scope | 适用场景 |
|---|---|
home | 首页/仪表盘相关 |
user | 用户管理模块 |
role | 角色管理模块 |
menu | 菜单管理模块 |
dict | 字典管理模块 |
dept | 部门管理模块 |
org | 组织机构模块 |
router | 路由相关 |
api | API 层 |
hooks | Hooks |
components | 公共组件 |
utils | 工具函数 |
styles | 样式相关 |
mock | Mock 数据 |
skills | Skills 相关 |
org）feat: 新增用户登录功能
fix: 修复表格分页不生效问题
refactor: 简化路由配置逻辑
perf: 优化首页加载速度
chore: 升级 React 到 19.x
新增用户登录功能 // 缺少 type
feat 新增用户登录功能 // 冒号格式错误
feat: 新增用户登录功能。 // 不应以句号结尾
feat: Add user login feature // 项目用中文，应保持一致
feat: 新增了用户登录功能并且优化了登录页面的样式和交互 // 太长，应拆分
<type>: 开头feat: 新增用户管理模块
- 新增用户列表页面，支持搜索和分页
- 新增用户表单，包含基本信息录入
- 新增用户详情抽屉
- API 层封装 useUserListApi 等 hooks
- 开头Closes #123
Fixes #456
Refs #789
BREAKING CHANGE: 用户 API 返回格式变更，需更新调用方
feat: 新增用户头像上传功能
fix(user): 修复用户列表搜索不生效问题
refactor(router): 重构路由配置结构
- 移除 AuthRouter 冗余包装
- 使用 import.meta.glob 替代手动 import
- 添加路由切换进度条（NProgress）
feat(org): 新增组织机构管理模块
- API层: useOrgListApi/CreateApi/UpdateApi/DeleteApi
- 列表页: 支持编码/名称/类型/负责人/状态多字段搜索
- 表单: 机构编码/名称/类型/负责人/联系电话/状态/备注
- Mock: 38条测试数据 + 4个CRUD接口
接入步骤：
1. 字典管理添加 org_type/org_status 字典
2. 菜单管理添加组织机构菜单（路由 /system/org）
feat(api): 统一 API 返回格式
BREAKING CHANGE: 所有 API 返回从 { data } 改为 { code, data, message }
调用方需适配新的返回格式
在提交前，检查以下项：
<type>: 前缀git commit -m "随便写"改动包含以下内容 → 应拆分为多个 commit：
├── 新功能 + bug修复 → feat + fix
├── 新功能 + 重构 → feat + refactor
├── 新功能 + 样式调整 → feat + style
├── 新功能 + 依赖升级 → feat + chore
├── 多个独立模块改动 → 每个模块一个 commit
改动内容：新增用户模块 + 修复登录 bug + 升级依赖
拆分为 3 个 commit：
1. feat(user): 新增用户管理模块
2. fix(login): 修复登录验证码不显示
3. chore: 升级 React 到 19.x
# 方法 1：多次 git add + commit
git add src/pages/user
git commit -m "feat(user): 新增用户管理模块"
git add src/pages/login
git commit -m "fix(login): 修复登录验证码不显示"
git add package.json
git commit -m "chore: 升级 React 到 19.x"
# 方法 2：一次性 add，交互式 commit
git add .
git commit --patch # 选择每个文件的改动
用户说"提交代码"
↓
dev-router 分析意图
↓
路由到 git-commit-guide
↓
git-commit-guide 生成规范 commit message
↓
执行 git commit
| Skill | 触发时机 | 职责 |
|---|---|---|
git-commit-guide | commit 前 | 规范 commit message 格式 |
pre-review-checklist | PR 提交后 | 审查代码合规性、scope 合规性 |
开发完成 → git-commit-guide 规范 commit → 多次 commit 后 → pre-review-checklist 审查 PR
项目已有的 commit 示例（保持一致风格）：
a1b6711 fix: 修复所有详情页 Descriptions 组件的 span 警告
381c3ec feat: route调整
113084f perf: 优化路由切换延迟
ab8c8c9 chore: 升级其他低风险依赖
5bbab12 chore: 升级 Vite 6.x → 8.x 及 @vitejs/plugin-react
风格特点：
当用户请求 commit message 时，按以下格式输出：
## 📝 Commit Message 建议
### 方案 1（推荐）
:
### 方案 2（带 scope）
():
### 详细版（带 body）
():
```选择理由：<为什么推荐这个格式>
## Quick Reference
feat: 新功能 fix: 修 bug refactor: 重构 perf: 性能优化 style: 代码风格 docs: 文档 test: 测试 chore: 构建/工具/依赖 revert: 回滚
格式：: 规则：中文、≤50字符、无句号、祈使语气