| 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 信息始终保持高质量，便于代码评审和项目维护，同时符合务实开发理念。
自动发现项目中的代码问题并提交 GitHub Issue
安全审计技能，用于检查和修复依赖安全问题
文档自动生成
CI检查验证和质量保障
开发流程检查技能，确保代码修改后执行必要的质量检查
文档创建技能，用于创建标准化的项目文档