Initial commit

2025-11-30 08:29:56 +08:00
commit c6caa36a85
10 changed files with 2117 additions and 0 deletions
--- a/git-commit/SKILL.md
+++ b/git-commit/SKILL.md
@@ -0,0 +1,314 @@
+---
+name: git-commit
+description: 智能 Git 提交助手：审查代码变更、分析提交历史、生成符合项目规范的提交信息并执行提交。支持自定义规范、提交前确认和智能暂存区处理。
+---
+
+# Git Commit 技能
+
+智能化的 Git 提交工作流，集成代码审查、历史分析和规范化提交信息生成。
+
+## 🎯 使用场景
+
+### 触发条件
+- 用户明确请求创建 Git 提交
+- 关键词：`提交`、`commit`、`git commit`、`提交代码`
+- 用户完成代码修改后需要提交变更
+
+### 典型示例
+```
+用户: "帮我提交这些代码"
+用户: "审查并提交当前的修改"
+用户: "创建一个 commit"
+用户: "把这些改动提交到 git"
+```
+
+## 📋 工作流程
+
+### 1. 检查暂存区状态
+```bash
+# 检查暂存区
+git status --porcelain
+git diff --cached --stat
+
+# 如果暂存区为空，列出工作区文件
+git status --short
+git diff --name-status
+```
+
+**决策逻辑**：
+- **暂存区非空** → 直接使用暂存区文件
+- **暂存区为空** → 列出工作区修改文件，询问用户确认提交范围
+
+### 2. 用户确认（暂存区为空时）
+**列出工作区文件**：
+```bash
+# 获取所有修改、新增、删除的文件
+git status --short
+# 输出格式：
+#  M src/main.rs        (修改)
+#  A src/config.rs      (新增)
+#  D old/legacy.rs      (删除)
+# ?? untracked.txt      (未跟踪)
+```
+
+使用 `AskUserQuestion` 工具询问：
+- 提交所有修改的文件？
+- 提交特定文件？（展示上述文件清单供选择）
+- 取消提交？
+
+根据用户选择执行 `git add` 操作。
+
+### 3. 简单代码审查
+检查项：
+- 语法错误（通过 `cargo check`、`npm run lint` 等）
+- 明显的逻辑问题
+- 调试代码残留（console.log、println!、TODO 等）
+- 敏感信息泄露（密钥、令牌、凭证）
+
+**不执行深度审查**（不调用 Codex MCP），保持快速反馈。
+
+### 4. 分析提交历史
+```bash
+git log --oneline -10
+git log --format="%s" -20
+```
+
+**分析目标**：
+- 识别项目的提交信息风格
+- 提取常用的 type 和 scope
+- 保持提交风格一致性
+
+### 5. 读取项目提交规范
+从 Memory 中查找项目级提交规范：
+```
+# 使用项目级精确查询，避免跨项目污染
+mcp__memory__search_nodes(query: "project:<repo>:commit-convention")
+mcp__memory__open_nodes(names: ["project:<repo>:commit-convention"])
+```
+
+**命名空间说明**：
+- `<repo>` 应替换为实际的仓库名称（如 `ccode`、`myproject`）
+- 使用 `project:` 前缀确保查询范围限定在当前项目
+- 避免使用模糊查询（如 `"commit convention"`），防止匹配到其他项目的规范
+
+**规范来源优先级**：
+1. Memory 中的项目规范
+2. 提交历史中的风格模式
+3. 通用的简洁描述格式
+
+### 6. 生成提交信息
+使用 `mcp__sequential-thinking__sequentialthinking` 分析变更并生成提交信息：
+
+**思考步骤**（6-8 步）：
+1. 分析 `git diff --cached` 的变更内容
+2. 识别变更的主要目的（新功能、修复、重构等）
+3. 提取关键的文件和模块
+4. 匹配项目提交规范格式
+5. 生成简洁准确的提交信息
+6. 验证提交信息是否符合规范
+
+**提交信息格式**（根据项目规范）：
+- 自定义规范：遵循 Memory 中的定义
+- 无规范时：`<type>: <简洁描述>`
+
+### 7. 展示变更摘要和提交信息
+向用户展示：
+```
+📊 变更摘要：
+  - 修改文件：3 个
+  - 新增行：+45
+  - 删除行：-12
+
+📝 提交信息：
+  feat(config): 添加 TOML 配置支持
+
+  - 实现 TOML 配置读取
+  - 添加 .env 文件支持
+  - 更新配置迁移逻辑
+
+✅ 代码审查：通过（无明显问题）
+
+是否确认提交？
+```
+
+### 8. 执行提交
+用户确认后执行：
+```bash
+git commit -m "$(cat <<'EOF'
+<提交信息>
+EOF
+)"
+```
+
+验证提交成功：
+```bash
+git log -1 --oneline
+```
+
+## 🔧 MCP 工具调用
+
+### Memory 工具
+```json
+{
+  "name": "mcp__memory__search_nodes",
+  "parameters": {
+    "query": "project:<repo>:commit-convention"
+  }
+}
+```
+
+```json
+{
+  "name": "mcp__memory__open_nodes",
+  "parameters": {
+    "names": ["project:<repo>:commit-convention"]
+  }
+}
+```
+
+**注意**：`<repo>` 应替换为实际仓库名，如 `project:ccode:commit-convention`
+
+### Sequential Thinking 工具
+```json
+{
+  "name": "mcp__sequential-thinking__sequentialthinking",
+  "parameters": {
+    "thought": "分析 git diff 变更内容...",
+    "thoughtNumber": 1,
+    "totalThoughts": 6,
+    "nextThoughtNeeded": true
+  }
+}
+```
+
+## 📝 协作模板
+
+### 标准提交流程
+```markdown
+1. 检查暂存区状态（git status --porcelain, git diff --cached --stat）
+2. 如果暂存区为空：
+   - 使用 git status --short 列出所有工作区修改文件
+   - 询问用户选择提交范围（全部/特定文件/取消）
+   - 根据选择执行 git add
+3. 简单代码审查（语法、明显问题）
+4. 分析最近 20 条提交历史（git log --format="%s" -20）
+5. 从 Memory 读取项目提交规范（使用 project:<repo>:commit-convention 精确查询）
+6. 使用 Sequential Thinking 生成提交信息
+7. 展示变更摘要和提交信息
+8. 等待用户确认
+9. 执行 git commit
+10. 验证提交成功（git log -1 --oneline）
+```
+
+### 提交信息生成模板
+```markdown
+根据以下信息生成提交信息：
+
+**变更内容**：
+<git diff --cached 输出>
+
+**项目规范**：
+<Memory 中的规范或历史风格>
+
+**要求**：
+- 简洁准确，一行概括主要变更
+- 如有多个变更，在正文中分点说明
+- 遵循项目规范格式
+- 避免技术细节，关注变更目的
+```
+
+## ⚙️ 配置项目提交规范
+
+### 在 Memory 中记录规范
+```json
+{
+  "name": "mcp__memory__create_entities",
+  "parameters": {
+    "entities": [{
+      "name": "project:<repo>:commit-convention",
+      "entityType": "convention",
+      "observations": [
+        "使用 Conventional Commits 格式：<type>(<scope>): <subject>",
+        "常用 type：feat, fix, docs, refactor, test, chore",
+        "scope 为可选，表示影响的模块",
+        "subject 使用中文，简洁描述变更",
+        "正文可选，详细说明变更原因和影响"
+      ]
+    }]
+  }
+}
+```
+
+**命名规范**：
+- 实体名称格式：`project:<repo>:commit-convention`
+- `<repo>` 替换为实际仓库名（如 `ccode`、`myproject`）
+- 使用 kebab-case 命名风格
+- 确保命名空间隔离，避免跨项目污染
+
+### 示例规范
+```
+type(scope): subject
+
+body (可选)
+
+footer (可选)
+```
+
+**type 类型**：
+- `feat`: 新功能
+- `fix`: 修复 bug
+- `docs`: 文档更新
+- `refactor`: 重构
+- `test`: 测试相关
+- `chore`: 构建/工具/依赖更新
+
+## ✅ 最佳实践
+
+### 推荐做法
+1. **提交前审查**：始终检查 `git diff` 确认变更内容
+2. **原子提交**：每次提交只包含一个逻辑变更
+3. **清晰描述**：提交信息应让他人快速理解变更目的
+4. **遵循规范**：保持项目提交风格一致
+5. **及时提交**：完成一个功能点后立即提交
+
+### 避免事项
+1. **混合变更**：不要在一次提交中包含多个不相关的修改
+2. **模糊描述**：避免 "update code"、"fix bug" 等无意义信息
+3. **提交敏感信息**：检查是否包含密钥、令牌等
+4. **跳过审查**：即使是小改动也应快速检查
+5. **忽略规范**：不要随意偏离项目约定的格式
+
+## 🚨 错误处理
+
+### 暂存区为空且用户取消
+```
+暂存区为空，需要先添加文件。
+已取消提交操作。
+```
+
+### 代码审查发现问题
+```
+⚠️ 代码审查发现以下问题：
+  - src/main.rs:42: 包含 println! 调试代码
+  - config/.env: 可能包含敏感信息
+
+建议修复后再提交。是否继续？
+```
+
+### 提交失败
+```
+❌ 提交失败：<错误信息>
+
+可能原因：
+  - pre-commit hook 失败
+  - 提交信息格式不符合要求
+  - Git 配置问题
+
+请检查错误信息并重试。
+```
+
+## 📚 相关资源
+
+- [Conventional Commits 规范](https://www.conventionalcommits.org/)
+- [Git 提交最佳实践](https://git-scm.com/book/zh/v2)
+- [如何编写 Git 提交信息](https://cbea.ms/git-commit/)