| name | git-commit |
| description | CS 匹配助手项目的 Git 提交规范与流程。Conventional Commits 英文前缀 + 中文说明。 仅负责分析变更、暂存、commit，可选 push；不涉及发版、构建 exe 或 GitHub Release。 Use when the user asks to commit, 提交, git commit, or mentions @git-commit without release/发版 intent. |
CS 匹配助手 — Git 提交
发版、构建 exe、GitHub Release 请使用 git-release skill，本 skill 不涵盖。
项目约定
| 项 | 值 |
|---|
| 仓库 | qianjiachun/cs-match-helper |
| 远程 | origin → git@github.com:qianjiachun/cs-match-helper.git |
| 主分支 | main |
硬性规则：
- 仅在用户明确要求时 才执行
git commit（及 push）
- Git commit 使用 Conventional Commits：英文类型前缀 + 冒号 + 中文说明；正文条目也用中文
- 不提交
release/、dist/、src-tauri/target/、node_modules/ 等忽略目录
- 不提交敏感文件（
.env、密钥、token 等）
- 本 skill 不执行
npm run build、npm run version:set、gh release create 等发版操作
提交信息规范
采用 Conventional Commits：前缀必须是英文，冒号后及正文用中文。
<英文类型>[可选作用域]: <中文简要说明>
<可选正文，中文条目列表>
硬性规则：
- 前缀类型只用英文：
feat / fix / chore / docs / refactor / perf / build / ci / release 等
- 禁止中文前缀（如
功能：、修复：、发版：）
- 冒号后第一行摘要、正文 bullet 一律中文
常用类型：
| 类型 | 用途 | 示例 |
|---|
feat | 新功能 | feat: 支持 5E 平台 CDP 数据采集 |
fix | Bug 修复 | fix: 修复从设置返回时重复触发 AI 分析 |
refactor | 重构 | refactor: 拆分 5E 与完美平台 AI prompt |
perf | 性能 | perf: 优化匹配数据表渲染 |
docs | 文档 | docs: 补充 5E 接口字段说明 |
chore | 杂项/工具 | chore: 更新依赖版本 |
build | 构建配置 | build: 调整 Tauri capabilities |
ci | CI 相关 | ci: 添加前端单测 workflow |
release | 版本号发布提交 | release: v1.1.0（通常与发版一起，见 git-release） |
示例
feat: 5E 平台独立 AI 分析 prompt
- 按 platformId 分流完美/5E system prompt
- 新增 buildP5eMatchSummary 结构化摘要
fix: 顶部 AI 胶囊 Even 显示改为中文「势均力敌」
refactor: 主页面与设置页切换改用 view-shell 动画
Git Safety Protocol
- 不修改 git config
- 不执行 destructive 命令（
push --force、reset --hard 等），除非用户明确要求
- 不 skip hooks（
--no-verify），除非用户明确要求
- 不 force push 到
main / master；若用户要求则先警告
- 避免
git commit --amend，仅当：用户明确要求、HEAD 为本会话创建、且未 push 远程
- commit 失败或被 hook 拒绝时，新建 commit，不要 amend
- 不 push 到远程，除非用户在本次请求中明确要求
提交流程
1. 并行收集上下文：
git status
git diff
git log -3 --oneline
2. 分析变更：
- 区分已暂存与未暂存
- 不暂存
release/、target/、密钥等
- 根据变更性质选择 Conventional Commits 类型
- 摘要聚焦「为什么」，1–2 句中文说明
3. 暂存并提交：
git add <相关文件>
git commit -m "$(cat <<'EOF'
feat: 简要中文说明
- 变更要点一
- 变更要点二
EOF
)"
4. 验证：
git status
5. 推送（仅用户明确要求时）：
git push -u origin HEAD
Windows PowerShell 中文乱码
将 message 写入 UTF-8 无 BOM 文件后提交：
git commit -F .commitmsg.txt
提交完成后删除临时文件。
与发版的边界
| 用户意图 | 使用 skill |
|---|
| 「帮我 commit」「提交一下」 | git-commit |
| 「发版 v1.2.0」「build exe 并 release」 | git-release |
| 「commit 并 push」（无发版） | git-commit + push |
| 「发版并提交」 | git-release（内含 commit 步骤，格式仍遵循本 skill） |
用户触发示例
@git-commit 提交当前改动
Agent 应：status / diff / log → 起草英文前缀 + 中文 message → git add + git commit → git status 确认；不自动 push 或发版。
