// SpringBlade 通用 Git 提交工具。基于 Gitmoji 规范生成提交信息。当用户要求提交代码、commit 变更、生成 commit message、或使用 /blade-commit 时触发。默认强制简单模式（gitmoji + 一句话描述），仅当显式传入 --d 或 --detail 参数时才启用详细模式（gitmoji + conventional commit + 变更列表）。只执行 commit，绝不 push 或执行其他远程操作。确保每次提交都带有 gitmoji 图标。
| name | blade-commit |
| description | SpringBlade 通用 Git 提交工具。基于 Gitmoji 规范生成提交信息。当用户要求提交代码、commit 变更、生成 commit message、或使用 /blade-commit 时触发。默认强制简单模式（gitmoji + 一句话描述），仅当显式传入 --d 或 --detail 参数时才启用详细模式（gitmoji + conventional commit + 变更列表）。只执行 commit，绝不 push 或执行其他远程操作。确保每次提交都带有 gitmoji 图标。 |
通用 Git 提交工具，基于 Gitmoji 规范生成风格统一的提交信息。
git push、git pull、git rebase、git merge、git reset --hard 或任何非暂存/提交的 git 操作Powered by、Created by、Co-authored-by、Generated by 或任何形式的工具/AI 署名:sparkles:）/blade-commit — 简单模式（默认，强制单行）/blade-commit --d 或 /blade-commit --detail — 详细模式（多行带变更列表）/blade-commit -m "自定义信息" — 使用用户指定的信息，自动补全 gitmoji 格式无论变更多大、涉及多少文件，只要用户没有显式传入 --d 或 --detail 参数，就必须使用简单模式。 不要因为 diff 内容多就自动升级为详细模式——模式选择权在用户手中，而非由变更规模决定。
单行格式：:<gitmoji>: <简要描述>
一句话说清楚改了什么。无论改动大小，只要没有 --d / --detail 参数，一律使用此格式。
:sparkles: 新增角色授权接口
:bug: 修复用户分页查询未过滤已删除数据
:zap: 优化字典查询排序逻辑
:recycle: 重构租户删除逻辑，迁移至 TenantService
:memo: 补充 OSS 接入文档
:wrench: 调整 application-dev.yml 数据源配置
:tada: x.x.x.RELEASE
--d 或 --detail）多行格式，适用于涉及多文件、多项改动的较大提交：
:<gitmoji>: <type>(<scope>): <标题摘要>
- <变更点1>
- <变更点2>
- ...
标题行由 gitmoji + conventional commit 类型 + 作用域 + 摘要组成，空一行后用 bullet points 逐条列出具体变更。
示例 1 — 新功能：
:sparkles: feat(system): 新增接口权限模块
- 新增 ApiScope 实体与对应 Mapper / Service / Controller
- 新增 ApiScopeHandler 处理端点级权限过滤
- 在 RoleController 中追加接口权限授权接口
- 补充 blade_api_scope 建表语句与初始化菜单 SQL
示例 2 — Bug 修复：
:bug: fix(auth): 修复登录 IP 锁定后刷新令牌仍可通过的问题
- RefreshTokenGranter 增加 IP 锁定状态校验
- LoginAttemptService 补充刷新场景下的失败计数复位逻辑
- 新增单元测试覆盖刷新 Token 的 IP 锁定分支
示例 3 — 重构：
:recycle: refactor(resource): 重构 OssEndpoint 按职责拆分 Controller
- 拆分文件上传、文件下载、文件删除为独立 Controller
- 抽取 OssService 处理跨厂商统一逻辑
- 原 OssEndpoint 保留兼容入口，内部委派至新 Controller
示例 4 — 性能优化：
:zap: perf(system): 优化字典批量查询性能
- DictCache 改用 Caffeine 二级缓存，减少 Redis 往返
- DictMapper 补充 code + dict_key 联合索引提示
- 调整 DictService 的 getList 为按租户分片查询
根据变更内容选择最匹配的 gitmoji：
| Gitmoji | 图标 | type | 场景 |
|---|---|---|---|
:sparkles: | ✨ | feat | 新增功能、新特性 |
:bug: | 🐛 | fix | 修复 Bug |
:zap: | ⚡ | perf | 性能优化、改进提升 |
:recycle: | ♻️ | refactor | 重构（不改变外部行为） |
:memo: | 📝 | docs | 文档新增或变更 |
:wrench: | 🔧 | chore | 配置变更、杂项 |
:white_check_mark: | ✅ | test | 添加或修改测试 |
:tada: | 🎉 | release | 发布新版本、里程碑 |
:fire: | 🔥 | remove | 移除代码或文件 |
:lipstick: | 💄 | style | UI / 样式调整 |
:ambulance: | 🚑 | hotfix | 紧急修复 |
:construction: | 🚧 | wip | 开发进行中 |
:arrow_up: | ⬆️ | deps | 升级依赖版本 |
:arrow_down: | ⬇️ | deps | 降级依赖版本 |
:lock: | 🔒 | security | 安全相关修复 |
:truck: | 🚚 | move | 移动 / 重命名文件 |
:art: | 🎨 | style | 改进代码结构 / 格式化 |
:package: | 📦 | build | 构建系统变更 |
:rewind: | ⏪ | revert | 回退变更 |
:heavy_plus_sign: | ➕ | deps | 添加依赖 |
:heavy_minus_sign: | ➖ | deps | 移除依赖 |
并行执行：
git status — 查看工作区状态git diff --staged — 已暂存的变更git diff — 未暂存的变更git log --oneline -5 — 最近提交记录，确认当前项目的提交风格阅读 git log 结果，判断当前项目的提交语言（中文/英文）和习惯。提交信息的语言应与项目历史保持一致：
阅读 diff 内容，判断：
system、auth、desk、resource、develop、gateway、tool 等）git add <具体文件路径> 逐个添加，不要用 git add . 或 git add -A.env、密钥文件、IDE 配置（.idea/、.vscode/）、编译产物（target/、dist/）、系统文件（.DS_Store）package.json、vite.config.*、vue.config.* 等前端工程标识文件，则自动将 website.js（通常位于 src/config/website.js）从暂存列表中排除，即使该文件有变更也不提交。如果 website.js 已被暂存，执行 git reset HEAD <website.js路径> 将其移出暂存区website.js）根据模式选择对应格式，使用 HEREDOC 执行 commit：
简单模式：
git commit -m "$(cat <<'EOF'
:sparkles: 新增角色授权接口
EOF
)"
详细模式：
git commit -m "$(cat <<'EOF'
:sparkles: feat(system): 新增接口权限模块
- 新增 ApiScope 实体与对应 Mapper / Service / Controller
- 新增 ApiScopeHandler 处理端点级权限过滤
- 在 RoleController 中追加接口权限授权接口
- 补充 blade_api_scope 建表语句与初始化菜单 SQL
EOF
)"
执行 git status 确认提交成功，向用户展示提交结果。
:sparkles: 适用于大多数新功能，:zap: 适用于优化改进-m 指定了信息，保留用户原意，只在格式上对齐规范（补 gitmoji、调整格式）Avue 组件代码生成与配置指南。当用户需要创建、配置或生成基于 Avue (avue-crud, avue-form, avue-tree 等) 的 Vue 页面代码时使用此 skill。覆盖 CRUD 表格、表单、树组件、数据展示等全部 Avue 组件。支持 Composition API 和 Options API 两种代码风格。当用户提到 avue、crud表格、动态表单、JSON配置表单、低代码表单、avue-crud、avue-form 等关键词时，务必使用此 skill。
SpringBlade 全栈代码生成器。根据用户提供的模块名、实体名和字段列表，自动生成符合 SpringBlade 开源版框架规范的后端代码（Boot 单体/Cloud 微服务）、前端页面（Saber Options API/Composition API）和 MySQL 建表语句。当用户说"帮我生成代码"、"创建一个新模块"、"生成 CRUD"、"新建实体"、"建表语句"、"生成前端页面"、"生成后端接口"、"生成 SpringBlade 代码"、"写一个 xxx 管理功能"、"帮我设计 xxx 表"、"blade-design"等时触发。即使用户只是描述了业务字段或给出了表结构，也应触发此技能来生成对应的 SpringBlade 规范代码。
SpringBlade 轻量规划执行工作流。将中等复杂度需求快速拆解为「分析规划 → 逐任务执行 → 完成总结」 三步流程，用 Claude Code 内置任务系统追踪进度，全程无辅助文件。适用于新增中等功能模块、修复跨模块 Bug、 中等规模重构、添加新 Starter 等涉及 5~15 个文件变更的开发任务。 当用户说"帮我做一个XX功能"、"这个改动涉及几个文件"、"帮我重构一下XX"、"帮我加个XX"、 "plan"、"规划一下再做"、"先想清楚再写"、"这个稍微有点复杂"等时触发。也可直接使用 /blade-plan 调用。 不适用于简单单文件修改（直接对话即可），也不适用于需要完整架构设计的复杂系统（建议分阶段拆解为多次会话）。 即使用户没有说"plan"，只要需求涉及多文件改动或需要一定设计思考，也应主动建议使用本工作流。