commit
SKILL.md
Skill: Commit
智能代码提交技能 - 分析变更并生成规范提交信息。
核心功能
- 📊 变更分析 - 识别文件类型、影响范围和修改性质
- 🏷️ 类型检测 - 自动识别 feat/fix/docs/refactor/style/test/chore 等类型
- 📍 Scope识别 - 自动确定变更所属模块或功能区域
- 📝 信息生成 - 生成符合 Conventional Commits 规范的提交信息
- ✅ 质量检查 - 检查敏感信息、未完成 TODO、调试代码等
- 🚫 纯净提交 - 绝不添加 AI 工具标识,保持提交历史专业
快速使用
# 分析并生成提交信息
/commit analyze
# 执行质量检查
/commit check
# 一键提交
/commit create
Conventional Commits 规范
提交信息格式
<type>(<scope>): <subject>
<body>
<footer>
类型说明
| 类型 | 说明 | 示例 |
|---|---|---|
| feat | 新功能 | feat(auth): 添加用户登录功能 |
| fix | Bug 修复 | fix(api): 修复用户列表分页问题 |
| docs | 文档更新 | docs(readme): 更新安装说明 |
| refactor | 重构代码 | refactor(utils): 优化日期格式化函数 |
| style | 代码格式 | style: 统一缩进为2空格 |
| test | 测试相关 | test(user): 添加用户服务单元测试 |
| chore | 构建/工具 | chore(deps): 升级依赖版本 |
| perf | 性能优化 | perf(list): 优化列表渲染性能 |
Scope 命名规范
- 按模块:
auth,api,ui,db - 按功能:
login,search,payment - 按层级:
components,services,utils
分析流程
- 获取变更 - 使用
git diff --staged获取暂存区变更 - 分类识别 - 分析文件类型和修改性质
- 类型推断 - 根据变更内容推断提交类型
- Scope 确定 - 识别变更影响的模块范围
- 信息生成 - 组装符合规范的提交信息
- 质量检查 - 检测潜在问题
质量检查项
- 无敏感信息泄露(密钥、密码、token)
- 无调试代码残留(console.log、debugger)
- 无未完成的 TODO 标记
- 无过大的提交(建议单次提交 < 500 行)
- 提交信息清晰描述变更内容
配置
{
"commit": {
"messageFormat": "conventional",
"qualityChecks": true,
"autoScope": true,
"maxSubjectLength": 72,
"signCommits": false
}
}
最佳实践
✅ 推荐做法
- 原子提交:每个提交只做一件事
- 频繁提交:小步快跑,便于回滚
- 有意义的描述:说明"为什么"而不仅是"做了什么"
- 使用祈使句:"添加功能"而非"添加了功能"
❌ 避免做法
- 一个提交包含多个不相关的修改
- 提交信息过于模糊(如"fix bug"、"update")
- 提交未编译或无法运行的代码
- 在提交信息中添加 AI 工具标识
详细信息
Weekly Installs
6
Repository
protagonistss/i…-pluginsFirst Seen
Jan 24, 2026
Security Audits
Installed on
antigravity6
claude-code6
opencode6
qoder5
gemini-cli5
codex4