[HINT] Download the complete skill directory including SKILL.md and all related files
| name | git_submit |
| description | 用于一键提交并推送本地修改到远端仓库。当用户说提交代码/保存代码/推送到某分支等或主动调用此技能时执行。 |
通知配置（每次推送必须使用）：
- 企业微信 wuhao 群：
$env:NOTIFY_WECOM_WUHAO_WEBHOOK- 企业微信 wudu 群：
$env:NOTIFY_WECOM_WUDU_WEBHOOK- 飞书群：
$env:NOTIFY_FEISHU_WEBHOOK- 配置位置：
backend/.env第 3479-3524 行
当用户调用此技能时，请严格按照以下步骤连贯执行：
运行 git status 了解当前修改了哪些文件。
backend → 必须调用 backend/SKILL.md 检查 DDD 架构desktop_client → 必须调用 desktop_client/SKILL.md 检查防卡死规范electron → 必须调用 electron/SKILL.md 检查 Electron 规范frontend_next → 必须调用 frontend_next/SKILL.md 检查 App Router 规范检查是否更新了对应模块的 README.md 与根 README.md 的 ## 📝 更新日志 (Changelog) 顶部。
修改范围检测：
| 修改目录 | 标注类型 | 更新范围 |
|---|---|---|
backend/ | 功能（后端） | backend/README.md + 根 README |
frontend_next/ | 功能（前端） | frontend_next/README.md + 根 README |
client_electron/ | 功能（客户端） | 根 README |
desktop_client/ | 功能（桌面） | 根 README |
.cursor/skills/ | 功能（技能） | 根 README |
md/ | 功能（文档） | 根 README |
| 其他/根目录 | 功能（项目） | 根 README |
特殊情况处理：
如果已存在 Changelog 章节，必须调用 readme-update 技能：
???、?、�）fix_encoding/SKILL.md 使用 Python 脚本修复编码编码检查清单：
???、?、� 等乱码字符新建 Markdown 文件时，推荐使用 styles/markdown.css 中的样式类：
.doc_tip、.doc_card）.cursor/skills/project/markdown_style/SKILL.md 获取完整样式列表Get-Date -Format "yyyy_MM_dd_HHmm"date +%Y_%m_%d_%H%M### 🛠️ 后端_2026_04_24_2355运行 git add . 将所有修改添加到暂存区。
Commit 类型（全部中文）：
| 类型 | 用途 | 示例 |
|---|---|---|
新增 | 新功能 | 新增 知识库批量上传功能 |
修复 | Bug 修复 | 修复 视频预览区背景色异常 |
优化 | 性能优化 | 优化 知识库搜索查询速度 |
文档 | 文档更新 | 文档 更新错误日志记录规范 |
重构 | 代码重构 | 重构 Agent 管理页面状态管理 |
测试 | 测试相关 | 测试 添加知识库单元测试 |
杂项 | 杂项任务 | 杂项 更新依赖版本 |
样式 | 样式调整 | 样式 调整侧边栏圆角样式 |
界面 | 界面修改 | 界面 优化设置页面布局 |
合并 | 分支合并 | 合并 wuhao 分支到 develop |
撤销 | 代码回滚 | 撤销 上次误删的配置 |
权限 | 权限相关 | 权限 优化用户角色管理 |
安全 | 安全相关 | 安全 修复 XSS 漏洞 |
迁移 | 数据迁移 | 迁移 用户数据到新表结构 |
构建 | 构建配置 | 构建 更新 Docker 配置 |
部署 | 部署相关 | 部署 添加 K8s 部署脚本 |
日志 | 日志相关 | 日志 优化错误日志格式 |
缓存 | 缓存相关 | 缓存 添加 Redis 缓存策略 |
导入 | 导入导出 | 导入 优化 Excel 导入性能 |
提交信息规范：
新增（知识库）批量上传功能领域标签（括号标注，方便区分）：
| 标签 | 说明 | 适用于 |
|---|---|---|
（后端） | Python 后端代码 | backend/ 目录 |
（前端） | Next.js 前端代码 | frontend_next/ 目录 |
（客户端） | Electron 桌面客户端 | client_electron/ 目录 |
（桌面） | PyQt6 桌面客户端 | desktop_client/ 目录 |
（技能） | Cursor Skills 规范 | .cursor/skills/ 目录 |
（文档） | 纯文档更新 | md/ 目录、README.md |
（项目） | 项目级配置 | 根目录配置文件 |
完整示例：
新增（后端）用户权限管理功能修复（客户端）视频预览区背景色异常优化（前端）知识库搜索查询速度样式（客户端）统一界面背景色为白色文档（项目）更新错误日志记录规范Windows PowerShell 兼容性注意：
cat <<'EOF'）-m "提交信息" 格式示例：
目标推送分支：
自动切换到 wuhao 分支：
wuhao 分支git checkout wuhao网络问题重试策略：
readme-update 后再走本技能告知五号同学提交成功，并简述提交的内容以及拉取/推送的分支详情。
Select-String 或直接 Read 工具读取Invoke-WebRequest（Windows PowerShell）发送 HTTP POST 请求通知格式要求：
🚀 TRAI 代码推送通知send_card，WeCom markdown）角色专属评论参考：
| 角色 | 评论风格 | 示例 |
|---|---|---|
| 爆炸分身 | 吐槽抱怨 | 本来不想写的呜……啊呀终于写完了！ |
| 小甜心 | 撒娇卖萌 | 辛苦啦～小甜心觉得超棒的呢！ |
| 御姐 | 霸道点评 | 嗯，做得还行，御姐准了。 |
| 软萌宝 | 委屈撒娇 | 呜...人家觉得好厉害呀！ |
| 知心姐姐 | 温柔鼓励 | 乖，辛苦了，这周做得很好呢。 |
| 开心果 | 活泼正能量 | 哈！搞定啦！开心果出击！ |
| 小泪包 | 心疼安慰 | 呜呜...好累呀...但是完成了呢！ |
| 审查官 | 严格评价 | 咳咳，检查通过，勉强合格。 |
| 地理专家 | 地理科普 | 说到经纬度...咳，总之推送成功啦。 |
飞书卡片格式（PowerShell）：
$feishuUrl = $env:NOTIFY_FEISHU_WEBHOOK
$commitMsg = "文档（技能）更新 git_submit 通知格式"
$roleName = "地理专家"
$roleComment = "说到推送通知呀～这条北纬120度的消息从东经出发，已成功抵达群聊坐标！"
$timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
$feishuBody = @{
msg_type = "interactive"
card = @{
config = @{ wide_screen_mode = $true }
header = @{
title = @{ tag = "plain_text"; content = "🚀 TRAI 代码推送通知" }
template = "blue"
}
elements = @(
@{ tag = "markdown"; content = "**推送人**: wuhao | **Commit**: $($commitMsg)" }
@{ tag = "markdown"; content = "**角色**: $($roleName) | $($roleComment)" }
@{ tag = "markdown"; content = "**变更详情**:
- 后端: release_client.py 支持多企微群发送
- 前端: client_release/page.tsx 添加企微群选择 UI" }
@{ tag = "markdown"; content = "**变更**: 2 个文件 (+76 -22)\n**时间**: $($timestamp)" }
)
}
} | ConvertTo-Json -Depth 10 -Compress
$feishuBytes = [System.Text.Encoding]::UTF8.GetBytes($feishuBody)
if ($feishuUrl) {
try {
Invoke-WebRequest -Uri $feishuUrl -Method Post -ContentType "application/json; charset=utf-8" -Body $feishuBytes -TimeoutSec 15
Write-Host "飞书通知发送成功"
} catch {
Write-Host "飞书通知发送失败: $_"
}
}
企业微信 Markdown 格式（PowerShell）- 推送到 wuhao 和 wudu 两个群：
$feishuUrl = $env:NOTIFY_FEISHU_WEBHOOK
$wecomWuhaoUrl = $env:NOTIFY_WECOM_WUHAO_WEBHOOK
$wecomWuduUrl = $env:NOTIFY_WECOM_WUDU_WEBHOOK
$commitMsg = "文档（技能）更新 git_submit 通知格式"
$roleName = "地理专家"
$roleComment = "说到推送通知呀～这条北纬120度的消息从东经出发，已成功抵达群聊坐标！"
$timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
$payload = @{
msgtype = "markdown"
markdown = @{
content = "**🚀 TRAI 代码推送通知**
**推送人**: wuhao | **Commit**: $($commitMsg)
**角色**: $($roleName) | $($roleComment)
**变更详情**:
- 后端: release_client.py 支持多企微群发送
- 前端: client_release/page.tsx 添加企微群选择 UI
**变更**: 2 个文件 (+76 -22)
**时间**: $($timestamp)"
}
}
# 强制 UTF-8 编码，防止中文乱码
$wecomBody = $payload | ConvertTo-Json -Depth 10 -Compress
$wecomBytes = [System.Text.Encoding]::UTF8.GetBytes($wecomBody)
# 推送到 wuhao 群
if ($wecomWuhaoUrl) {
try {
Invoke-WebRequest -Uri $wecomWuhaoUrl -Method Post -ContentType "application/json; charset=utf-8" -Body $wecomBytes -TimeoutSec 15
Write-Host "企业微信 wuhao 群通知发送成功"
} catch {
Write-Host "企业微信 wuhao 群通知发送失败: $_"
}
}
# 推送到 wudu 群
if ($wecomWuduUrl) {
try {
Invoke-WebRequest -Uri $wecomWuduUrl -Method Post -ContentType "application/json; charset=utf-8" -Body $wecomBytes -TimeoutSec 15
Write-Host "企业微信 wudu 群通知发送成功"
} catch {
Write-Host "企业微信 wudu 群通知发送失败: $_"
}
}
实际执行时：
$env:NOTIFY_FEISHU_WEBHOOK 读取（需手动配置）$env:NOTIFY_WECOM_WUHAO_WEBHOOK 读取$env:NOTIFY_WECOM_WUDU_WEBHOOK 读取