Files

T

dingyuntian 749b9974c0 chore(meta): 添加项目 AI 助手元数据与技能定义

2026-06-22 14:49:23 +08:00

3.9 KiB

Raw Blame History

name, description

name	description
source-command-split-commit	将当前未提交改动拆分为多个符合规范的原子提交

source-command-split-commit

Use this skill when the user asks to run the migrated source command split-commit.

Command Template

将当前未提交改动拆分为多个原子提交。执行前会分析变更、生成分组方案，经用户确认后逐组提交。

执行流程

Step 1: 前置检查

清理残留文件：若存在 msg.txt，先 rm -f msg.txt
读取规范：确认 COMMIT_CONVENTION.md 存在且可读

Step 2: 保护分支检查

保护分支列表（按优先级）：AGENTS.md > .cursor/rules/ > .git/config branch.protected > 默认(master|main|develop)

若当前在保护分支，询问用户：

A - 创建 feature 分支后继续拆分（推荐）
B - 转移到新分支后压成单提交
C - 取消

Step 3: 盘点变更

执行以下命令分析：

git status - 整体状态
git diff --stat - 文件统计
git diff - 详细改动
git diff --cached - 已暂存改动

Step 4: 规则化分组

按"意图一致"原则分组，优先按 type 分，再按 scope 分。

必须拆分的情况：

同一组可归属多个 type
同文件包含多个独立目的（如功能+重构）
资源替换与代码逻辑混合

可以合并的情况（最小拆分原则）：

同一功能的多文件改动（脚本+Prefab）
同一模块的多个相关 Bug 修复

Step 5: 生成方案表格

以表格形式展示拆分方案：

顺序	文件	变更目的	提交头	依据	方式
1	`路径`	描述	`type(scope): subject`	原因	`git add`/`git add -p`

Type 选择优先级：fix > feat > art > audio > scene > yarn > perf|refactor|...

Scope 规则：单模块用模块名（如 blockpuzzle），跨模块省略。

Step 6: 用户确认

询问：[Y 执行 / n 取消 / 提出调整]

若调整：根据反馈修改方案，再次确认
若执行：进入 Step 7
若取消：清理并退出

Step 7: 逐组提交

对每组执行：

git add <file> 或 git add -p <file>
复查：git diff --cached --stat 和 git diff --cached
写入 msg.txt 并提交：git commit -F msg.txt
检查状态：git status

失败处理：

git add -p 跳过关键 hunk → 暂停，提示处理方案
pre-commit hook 失败 → 询问 [R]重试 [S]跳过 [A]中止

Step 8: 结果校验

输出：

git log --oneline -<N>
回放清单（验证 type/scope/subject 合规性）
若不合规，询问是否修正

Step 9: 清理

rm -f msg.txt

Unity 改动速查表

改动类型	type	scope 示例
脚本逻辑修复	`fix`	`blockpuzzle`, `dialog`
脚本新功能	`feat`	`huoshan`, `clue`
美术资源（贴图/模型/动画）	`art`	对应模块或省略
音频资源	`audio`	`audio-kit` 或省略
场景配置（灯光/镜头）	`scene`	对应模块或省略
Yarn 对话	`yarn`	`dialog`
测试代码	`test`	对应模块

规范校验清单（执行前检查）

格式：<type>(<scope>): <subject> 或 <type>: <subject>
type ∈ {feat,fix,art,audio,scene,yarn,perf,refactor,style,docs,build,chore,test}
subject：中文、动词开头、≤50字、无句号
一次提交只做一件事

中文提交方法

由于 PowerShell 中文乱码问题，统一使用文件方式：

echo "type(scope): 描述" > msg.txt
git commit -F msg.txt
rm -f msg.txt

关于 Pre-commit Hooks

若配置了 husky/lint-staged：

每次提交都会触发检查
如需跳过（不推荐）：git commit -F msg.txt --no-verify
跳过可能导致 CI 失败

开始执行请回复 "开始"，或告知需要的调整。

3.9 KiB Raw Blame History Unescape Escape