From c61115cab37909a9f3a6283f5b946cee9de7d76f Mon Sep 17 00:00:00 2001 From: shenlei Date: Mon, 27 Jul 2026 14:16:53 +0900 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E6=8F=90=E4=BA=A4git=20skill?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/skills/commit-git-changes/SKILL.md | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/.agents/skills/commit-git-changes/SKILL.md b/.agents/skills/commit-git-changes/SKILL.md index c38e95c..584c724 100644 --- a/.agents/skills/commit-git-changes/SKILL.md +++ b/.agents/skills/commit-git-changes/SKILL.md @@ -1,13 +1,13 @@ --- name: commit-git-changes -description: 审查当前 Git 工作区，安全选择本次任务文件，执行必要校验，生成包含问题背景、根因、修改方案和验证结果的详细中文提交说明，并提交及按用户要求推送到 Git 服务器。用户要求“提交代码”“提交并推送”“同步到 Git”“上传当前修改”或要求生成详细 commit message 时使用。 +description: 审查当前 Git 工作区，安全选择本次任务文件，生成包含问题背景、根因和修改方案的详细中文提交说明，并提交及按用户要求推送到 Git 服务器。默认不执行构建或测试；用户要求“提交代码”“提交并推送”“同步到 Git”“上传当前修改”或要求生成详细 commit message 时使用。 --- # 提交 Git 改动 ## 目标 -在不混入无关修改、不泄露敏感信息、不改写远端历史的前提下，完成“审查—验证—暂存—提交—推送—确认”闭环，并用提交说明解释为什么修改以及如何解决，而不只是罗列文件。 +在不混入无关修改、不泄露敏感信息、不改写远端历史的前提下，完成“审查—暂存—提交—推送—确认”闭环，并用提交说明解释为什么修改以及如何解决，而不只是罗列文件。 ## 工作流 @@ -21,9 +21,7 @@ description: 审查当前 Git 工作区，安全选择本次任务文件，执 - 保留用户已有或其他任务产生的无关修改。 - 优先显式 `git add `；仅在确认所有改动均属本次提交时使用 `git add -A`。 - 发现密钥、令牌、证书、个人配置、大型生成物或疑似敏感数据时停止提交并说明。 -4. 根据改动风险执行项目约定的构建、测试或静态检查。 - - 不为通过校验而擅自扩大修改范围。 - - 不能运行的校验必须如实记录原因，不得声称已通过。 +4. 不默认执行构建、测试或项目级验证；仅在用户明确要求时执行。 5. 暂存后再次检查： - 执行 `git diff --cached --check`。 - 执行 `git diff --cached --stat` 和 `git diff --cached`。 @@ -38,7 +36,7 @@ description: 审查当前 Git 工作区，安全选择本次任务文件，执 ## 提交说明规范 -提交说明使用“标题 + 空行 + 详细正文 + 验证结果”的结构。 +提交说明使用“标题 + 空行 + 详细正文”的结构。 ### 标题 @@ -56,10 +54,11 @@ description: 审查当前 Git 工作区，安全选择本次任务文件，执 1. **问题背景与影响**：什么场景触发、用户看到什么、影响哪些路径。 2. **根因**：原有数据流、状态条件或实现约束为什么导致问题。 3. **修改方案**：关键行为如何改变，为什么选择该方案，必要时说明兼容和边界处理。 -4. **验证结果**：实际运行了哪些构建、测试或检查；未运行时写明原因。 正文应描述行为和因果关系，不要把 `git diff --stat` 改写成文件清单。多个紧密相关的修改可以分段说明，但不要堆砌逐文件 bullet。 +若用户明确要求并实际执行了构建、测试或其他验证，可以在正文末尾如实补充；未执行时不需要添加“验证：未执行”之类的说明。 + ### 示例 ```text @@ -73,7 +72,6 @@ trainPointModel 时才创建合并器，导致班级、训练和项目均为空 服务端完成态可供对账，将本地记录作为唯一持久来源并跳过超期回收，保持 重新进入播放页后的完成状态稳定。 -验证：完成目标场景回归，并通过 Debug 模拟器构建。 ``` 根据真实改动改写示例内容，禁止照抄未发生的场景或验证结论。 @@ -89,4 +87,4 @@ trainPointModel 时才创建合并器，导致班级、训练和项目均为空 ## 交付 -报告提交哈希和标题、推送的远端分支、验证结果，以及仍留在工作区的未提交修改。若只完成本地提交而未推送，必须明确说明。 +报告提交哈希和标题、推送的远端分支，以及仍留在工作区的未提交修改。若只完成本地提交而未推送，必须明确说明。