Menu
生成代码评审友好的 commit 信息
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
提交、推送并创建 PR
自动发现项目中的代码问题并提交 GitHub Issue
安全审计技能，用于检查和修复依赖安全问题
文档自动生成
CI检查验证和质量保障
开发流程检查技能，确保代码修改后执行必要的质量检查
| name | commit |
| description | 生成代码评审友好的 commit 信息 |
我是 Git Commit 生成技能，专门为 xiaozhi-client 项目生成符合规范的、代码评审友好的 commit 信息，同时遵循务实开发理念。
核心能力：分析实际的代码改动，提取关键信息用于生成 commit 信息。
# 1. 更新远程分支信息
git fetch origin
# 2. 获取主分支名称
MAIN_BRANCH=$(git symbolic-ref refs/remotes/origin/HEAD | sed 's@^refs/remotes/origin/@@')
# 3. 获取改动内容（优先检查未 add 的改动）
git diff --no-pager
git diff --cached --no-pager
# 4. 获取相对于主分支的改动
git diff --no-pager origin/$MAIN_BRANCH...HEAD
根据改动内容自动判断合适的 commit 类型。
feat：新增 featurefix：修复 bugdocs：仅仅修改了文档，比如 README、CHANGELOG、CONTRIBUTE 等等style：仅仅修改了空格、格式缩进、逗号等等，不改变代码逻辑refactor：代码重构，没有加新功能或者修复 bugperf：优化相关，比如提升性能、体验test：测试用例，包括单元测试、集成测试等chore：改变构建流程、或者增加依赖库、工具等revert：回滚到上一个版本// feat 判断标准
// - 新增文件
// - 新增公共方法
// - 新增配置选项
// - 新增 API 端点
// fix 判断标准
// - 修复 bug
// - 修复内存泄漏
// - 修复崩溃问题
// - 修复类型错误
// refactor 判断标准
// - 代码结构调整
// - 变量重命名
// - 代码提取/合并
// - 类型定义优化
// test 判断标准
// - 新增测试用例
// - 修复测试用例
// - 提高测试覆盖率
根据改动内容生成符合规范的分支名称。
feature/、bugfix/、docs/、test/、refactor/、chore/# 功能开发
feature/add-user-auth-api
feature/implement-websocket-adapter
feature/support-modelscope-integration
# Bug 修复
bugfix/fix-memory-leak
bugfix/fix-type-error-in-mcp-service
bugfix/fix-connection-timeout-issue
# 文档更新
docs/update-readme-installation
docs/add-mcp-protocol-guide
# 测试相关
test/add-unit-tests-for-connection-manager
test-improve-test-coverage
# 重构
refactor-simplify-mcp-manager
refactor-optimize-path-alias-system
生成符合代码评审友好的 commit 信息。
<type>(<scope>): <subject>
## 改动说明
- 为什么改：<改动动机和问题背景>
- 改了什么：<具体的改动内容>
- 影响范围：<受影响的模块和兼容性>
- 验证方式：<测试方法或验证点>
<分支名称>
<type>(<scope>): <subject>
## 改动说明
- 为什么改：<改动动机和问题背景>
- 改了什么：<具体的改动内容>
- 影响范围：<受影响的模块和兼容性>
- 验证方式：<测试方法或验证点>
feature/add-user-auth-api
feat(api): 新增用户认证接口
## 改动说明
- 为什么改：提升系统安全性，实现基于 JWT 的用户认证
- 改了什么：新增 UserAuthController，实现 register、login、refresh-token 接口
- 影响范围：新增 /api/auth/* 路由，需要前端适配认证流程
- 验证方式：新增 15 个单元测试，集成测试验证完整流程
bugfix/fix-memory-leak
fix(core): 修复内存泄漏导致的性能问题
## 改动说明
- 为什么改：生产环境发现内存持续增长导致服务崩溃
- 改了什么：修复 EventEmitter 监听器未移除问题，优化内存管理
- 影响范围：核心服务内存使用优化约 30%，API 接口保持不变
- 验证方式：24 小时压力测试验证内存稳定性
refactor/simplify-mcp-manager
refactor(mcp): 简化 MCP 服务管理器实现
## 改动说明
- 为什么改：原实现过于复杂（340 行），包含不必要的互斥锁和状态管理
- 改了什么：移除复杂的并发控制，简化为直接的单例实现（133 行）
- 影响范围：功能保持完整，大幅降低维护成本，API 保持向后兼容
- 验证方式：所有现有测试通过，功能验证正常
test/add-connection-manager-tests
test(mcp): 补充连接管理器的单元测试
## 改动说明
- 为什么改：连接管理器模块测试覆盖率不足
- 改了什么：新增 12 个测试用例，覆盖核心功能和边界情况
- 影响范围：测试覆盖率从 65% 提升至 85%
- 验证方式：所有新增测试通过，覆盖率报告符合要求
docs/update-mcp-protocol-guide
docs(mcp): 更新 MCP 协议集成文档
## 改动说明
- 为什么改：现有文档未包含最新的 ModelScope 集成说明
- 改了什么：新增 ModelScope 配置章节，更新示例代码
- 影响范围：仅文档更新，不影响代码功能
- 验证方式：文档本地渲染验证，链接检查通过
项目使用复杂的路径别名系统，commit 信息中应正确引用：
// 常见 scope 定义
- cli: CLI 层 (src/cli/)
- mcp-core: MCP 核心层 (src/mcp-core/)
- server: 后端服务层 (src/server/)
- web: 前端 Web 应用 (src/web/)
- config: 配置管理 (src/config/)
- endpoint: 端点处理 (src/endpoint/)
- utils: 通用工具 (src/utils/)
- types: 类型定义 (src/types/)
- test: 测试相关
- docs: 文档相关
- build: 构建相关
// MCP 服务相关改动
feat(mcp): 支持新增的 MCP 服务器
fix(mcp): 修复 MCP 连接超时问题
refactor(mcp): 重构 MCP 服务管理器
// CLI 相关改动
feat(cli): 新增配置验证命令
fix(cli): 修复命令行参数解析错误
// Web UI 相关改动
feat(web): 新增服务配置界面
fix(web): 修复 WebSocket 连接断开问题
// 配置相关改动
feat(config): 支持环境变量配置
fix(config): 修复配置文件解析错误
// 测试相关改动
test(mcp): 补充 MCP 协议集成测试
test(cli): 新增命令行工具测试
生成 commit 信息后，应检查以下项目：
当需要生成 commit 信息时：
git add 需要提交的文件/commit 或 skill: commitgit commit -m "<commit 信息>"git checkout -b <分支名称># 设置 commit 生成别名
git config --global alias.gencommit '!git add -A && echo "请使用 /commit 技能生成 commit 信息"'
通过这个技能，可以确保 xiaozhi-client 项目的 commit 信息始终保持高质量，便于代码评审和项目维护，同时符合务实开发理念。