{"id":51452322,"url":"https://github.com/spz-ecosystem/git-workflow","last_synced_at":"2026-07-05T22:01:31.459Z","repository":{"id":367678854,"uuid":"1235174823","full_name":"spz-ecosystem/git-workflow","owner":"spz-ecosystem","description":"git-workflow整合技能包，是为spz一体化工作台（基于codex搭建）准备的底层基础设施之一，该技能包可以在codex、trae、codebuddy等多个ai编程工具使用","archived":false,"fork":false,"pushed_at":"2026-06-27T03:37:09.000Z","size":63,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-27T05:12:28.333Z","etag":null,"topics":["git","release-automation","workflow-automation","worktree-workflow"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spz-ecosystem.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-11T04:41:47.000Z","updated_at":"2026-06-27T03:37:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/spz-ecosystem/git-workflow","commit_stats":null,"previous_names":["spz-ecosystem/git-workflow"],"tags_count":null,"template":true,"template_full_name":null,"purl":"pkg:github/spz-ecosystem/git-workflow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spz-ecosystem%2Fgit-workflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spz-ecosystem%2Fgit-workflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spz-ecosystem%2Fgit-workflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spz-ecosystem%2Fgit-workflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spz-ecosystem","download_url":"https://codeload.github.com/spz-ecosystem/git-workflow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spz-ecosystem%2Fgit-workflow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35170542,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-05T02:00:06.290Z","response_time":100,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["git","release-automation","workflow-automation","worktree-workflow"],"created_at":"2026-07-05T22:01:30.431Z","updated_at":"2026-07-05T22:01:31.451Z","avatar_url":"https://github.com/spz-ecosystem.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Git Workflow Umbrella Skill\r\n\r\n统一管理所有git工作流操作，提供标准化、自动化、可追溯的git操作规范。\r\n\r\n## 🚀 快速开始\r\n\r\n### 安装\r\n\r\n```bash\r\n# 克隆或下载到 ~/.codebuddy/skills/git-workflow/\r\ngit clone \u003crepository-url\u003e ~/.codebuddy/skills/git-workflow\r\n\r\n# 或者运行安装脚本\r\n./scripts/install.sh\r\n```\r\n\r\n### 验证安装\r\n\r\n```bash\r\ngit-workflow --help\r\n```\r\n\r\n## 📦 功能特性\r\n\r\n### 六大核心模块\r\n\r\n| 模块 | 功能 | 示例命令 |\r\n|------|------|----------|\r\n| **push** | 推送管理 | `git-workflow push --precheck` |\r\n| **branch** | 分支管理 | `git-workflow branch create feature-new` |\r\n| **worktree** | Worktree管理 | `git-workflow worktree create feature-new` |\r\n| **release** | 发版预检 | `git-workflow release check` |\r\n| **security** | 安全审查 | `git-workflow security review` |\r\n| **cleanup** | 清理工具 | `git-workflow cleanup remote` |\r\n\r\n### 分支管理增强功能\r\n\r\n| 功能 | 描述 | 示例命令 |\r\n|------|------|----------|\r\n| **分支状态报告** | 显示详细的分支状态信息 | `git-workflow branch status --all` |\r\n| **分支恢复** | 恢复已删除的分支 | `git-workflow branch restore feature-old` |\r\n| **定时清理** | 配置分支清理定时任务 | `git-workflow branch schedule --weekly` |\r\n| **安全删除** | 9项安全检查后删除分支 | `git-workflow branch delete feature-old` |\r\n| **智能清理** | 自动清理已合并和过期分支 | `git-workflow branch cleanup --dry-run` |\r\n\r\n### 核心优势\r\n\r\n- ✅ **统一入口**：所有git工作流操作通过`git-workflow`命令执行\r\n- ✅ **标准化操作**：遵循统一的git操作规范\r\n- ✅ **自动化流程**：减少人工操作，提高效率\r\n- ✅ **可追溯性**：记录所有操作历史，便于审计\r\n- ✅ **跨平台支持**：自动处理Windows/WSL路径问题\r\n- ✅ **模块化设计**：各模块独立，便于维护和扩展\r\n- ✅ **安全第一**：9项分支删除安全检查\r\n- ✅ **智能备份**：自动备份分支引用，支持恢复\r\n- ✅ **定时任务**：支持配置分支清理定时任务\r\n\r\n## 🛠️ 使用指南\r\n\r\n### 1. 推送管理\r\n\r\n```bash\r\n# 标准推送\r\ngit-workflow push\r\n\r\n# 推送前预检（推荐）\r\ngit-workflow push --precheck\r\n\r\n# PR回退（分支保护时）\r\ngit-workflow push --pr-fallback\r\n```\r\n\r\n### 2. 分支管理\r\n\r\n```bash\r\n# 创建新分支（自动创建隔离worktree）\r\ngit-workflow branch create feature-new-feature\r\n\r\n# 删除分支（安全审查后）\r\ngit-workflow branch delete feature-old-feature\r\n\r\n# 清理已合并分支\r\ngit-workflow branch cleanup\r\n\r\n# 显示分支状态报告\r\ngit-workflow branch status --all\r\n\r\n# 恢复已删除的分支\r\ngit-workflow branch restore feature-old-feature\r\n\r\n# 配置分支清理定时任务\r\ngit-workflow branch schedule --weekly --time 02:00\r\n\r\n# 分支清理dry-run模式\r\ngit-workflow branch cleanup --dry-run\r\n```\r\n\r\n### 3. Worktree管理\r\n\r\n```bash\r\n# 创建隔离worktree\r\ngit-workflow worktree create feature-new-feature\r\n\r\n# 删除worktree\r\ngit-workflow worktree delete feature-old-feature\r\n\r\n# 清理孤立worktree\r\ngit-workflow worktree cleanup\r\n```\r\n\r\n### 4. 发版预检\r\n\r\n```bash\r\n# 执行发版可行性检查\r\ngit-workflow release check\r\n\r\n# 准备发版\r\ngit-workflow release prepare v1.0.0\r\n```\r\n\r\n### 5. 安全审查\r\n\r\n```bash\r\n# 执行安全审查\r\ngit-workflow security review\r\n\r\n# 执行安全审计\r\ngit-workflow security audit\r\n```\r\n\r\n### 6. 清理工具\r\n\r\n```bash\r\n# 清理远程跟踪引用\r\ngit-workflow cleanup remote\r\n\r\n# 清理孤立worktree\r\ngit-workflow cleanup worktree\r\n\r\n# 清理临时分支\r\ngit-workflow cleanup branches\r\n```\r\n\r\n## ⚙️ 配置管理\r\n\r\n### 配置文件位置\r\n\r\n- **WSL路径**：`/root/.codebuddy/skills/git-workflow/git-workflow.yaml`\r\n- **Windows路径**：`/mnt/c/Users/HP/.codebuddy/skills/git-workflow/git-workflow.yaml`\r\n\r\n### 环境变量覆盖\r\n\r\n```bash\r\nexport GIT_WORKFLOW_CONFIG=\"/custom/path/to/git-workflow.yaml\"\r\nexport GIT_WORKFLOW_LOG=\"/custom/path/to/logs\"\r\nexport GIT_WORKFLOW_BACKUP=\"/custom/path/to/backups\"\r\n```\r\n\r\n### 自动检测机制\r\n\r\n脚本会自动检测Windows路径并创建符号链接：\r\n1. 检查WSL路径下的配置文件是否存在\r\n2. 如果不存在，检测Windows路径\r\n3. 自动创建符号链接到WSL路径\r\n4. 使用默认配置作为后备方案\r\n\r\n## 📁 目录结构\r\n\r\n```\r\ngit-workflow/\r\n├── README.md                    # 本文件\r\n├── DESIGN.md                    # 设计文档\r\n├── SKILL.md                     # 主文档\r\n├── CHANGELOG.md                 # 更新日志\r\n├── CONTRIBUTING.md              # 贡献指南\r\n├── LICENSE                      # 许可证\r\n├── git-workflow.yaml            # 配置文件\r\n├── scripts/\r\n│   ├── git-workflow.sh          # 主脚本（994行）\r\n│   ├── branch-delete-safety-check.sh  # 分支删除安全检查（444行）\r\n│   ├── install.sh               # 安装脚本\r\n│   ├── uninstall.sh             # 卸载脚本\r\n│   └── package.sh               # 打包脚本\r\n├── examples/\r\n│   ├── basic-usage.md           # 基础使用示例\r\n│   ├── advanced-usage.md        # 高级使用示例\r\n│   └── workflows.md             # 工作流示例\r\n├── templates/\r\n│   ├── git-workflow.yaml        # 配置模板\r\n│   └── hooks/                   # Git hooks模板\r\n├── tests/\r\n│   ├── test-git-workflow.sh     # 测试脚本（386行）\r\n│   └── test-config.yaml         # 测试配置\r\n└── docs/\r\n    ├── installation.md          # 安装指南\r\n    ├── configuration.md         # 配置指南\r\n    ├── troubleshooting.md       # 故障排除\r\n    └── best-practices.md        # 最佳实践（445行）\r\n```\r\n\r\n## 🔧 故障排除\r\n\r\n### 常见问题\r\n\r\n#### 1. 配置文件不存在\r\n```bash\r\n# 自动检测会创建符号链接\r\ngit-workflow --help\r\n\r\n# 或手动创建符号链接\r\nln -s /mnt/c/Users/HP/.codebuddy/skills/git-workflow /root/.codebuddy/skills/git-workflow\r\n```\r\n\r\n#### 2. 权限问题\r\n```bash\r\n# 确保脚本有执行权限\r\nchmod +x ~/.codebuddy/skills/git-workflow/scripts/*.sh\r\n```\r\n\r\n#### 3. 网络问题\r\n```bash\r\n# 使用代理\r\nexport http_proxy=http://proxy:port\r\nexport https_proxy=http://proxy:port\r\n```\r\n\r\n#### 4. 分支删除失败\r\n```bash\r\n# 检查分支是否受保护\r\ngit-workflow branch status\r\n\r\n# 使用安全检查脚本\r\n~/.codebuddy/skills/git-workflow/scripts/branch-delete-safety-check.sh --dry-run \u003c分支名\u003e\r\n\r\n# 检查分支是否有关联的worktree\r\ngit worktree list | grep \u003c分支名\u003e\r\n```\r\n\r\n#### 5. 分支恢复失败\r\n```bash\r\n# 检查备份目录是否存在\r\nls -la ~/.codebuddy/backups/git-workflow/branch-deletes/\r\n\r\n# 手动恢复分支\r\ngit branch \u003c分支名\u003e \u003c备份文件路径\u003e\r\n```\r\n\r\n#### 6. 定时任务配置失败\r\n```bash\r\n# 检查crontab是否可用\r\ncrontab -l\r\n\r\n# 手动添加定时任务\r\ncrontab -e\r\n# 添加：0 2 * * 0 cd \u003c仓库路径\u003e \u0026\u0026 ~/.codebuddy/skills/git-workflow/scripts/git-workflow.sh branch cleanup --non-interactive --no-remote\r\n```\r\n\r\n## 📚 文档\r\n\r\n- [设计文档](DESIGN.md) - 详细的设计说明\r\n- [主文档](SKILL.md) - 完整的功能说明\r\n- [安装指南](docs/installation.md) - 详细安装步骤\r\n- [配置指南](docs/configuration.md) - 配置选项说明\r\n- [故障排除](docs/troubleshooting.md) - 常见问题解决\r\n- [最佳实践](docs/best-practices.md) - 使用建议\r\n\r\n## 🤝 贡献\r\n\r\n欢迎贡献代码！请查看 [贡献指南](CONTRIBUTING.md)。\r\n\r\n## 📄 许可证\r\n\r\n本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件\r\n\r\n## 📞 支持\r\n\r\n- **问题反馈**：提交 Issue\r\n- **功能建议**：提交 PR\r\n- **文档改进**：提交 PR\r\n\r\n## 🙏 致谢\r\n\r\n感谢所有贡献者和用户的支持！\r\n\r\n---\r\n\r\n**Git Workflow Umbrella Skill** - 让git工作流更简单、更安全、更高效","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspz-ecosystem%2Fgit-workflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspz-ecosystem%2Fgit-workflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspz-ecosystem%2Fgit-workflow/lists"}