用途:该技能用于为软件团队生成一份完整、结构化的 Git 工作流文档,输出为 Markdown(.md)或 Word(.docx),内容覆盖分支策略、提交信息格式、Pull Request 流程与合并规则,并贴合团队实际配置。
触发场景:用户要求记录或撰写 Git 工作流、创建分支策略指南、定义提交信息规范、记录 PR 或代码评审流程、编写合并规则或分支保护策略、为新工程师做版本控制流程入门,或创建 CONTRIBUTING.md 等开发者指南。
主要能力:先收集团队上下文,包括分支模型(Gitflow、GitHub Flow、trunk-based 或自定义)、长期分支、功能分支命名、提交信息格式、PR 流程、合并策略与部署模型;若用户未提供,会通过 ask_user_input 一次性集中提问;用户表示使用合理默认值时,默认采用 GitHub Flow。随后按固定章节撰写文档:概述、分支结构表、分支命名规范(<type>/<short-description>,kebab-case,类型含 feature、fix、hotfix、chore、docs、refactor、release)、提交信息格式(默认 Conventional Commits:<type>(<scope>): <description>,含正文与页脚示例,主题 72 字符、祈使语气、关联 issue)、PR 流程(创建、标题与描述格式、草稿 PR、评审要求与 CI 检查、评审礼仪)、合并规则(squash/merge commit/rebase、谁可合并、分支删除策略、受保护分支)、发布流程(语义化版本标签、变更日志)、热修复流程,以及可选的提示与常见错误。
使用方式:默认输出 Markdown,适合存入仓库;用户要求 Word 时读取 /mnt/skills/public/docx/SKILL.md 并生成 .docx。文件保存为 git-workflow.md 或 CONTRIBUTING.md,移动到 /mnt/user-data/outputs/ 并通过 present_files 交付。
默认值:GitHub Flow、主分支 main、功能分支 feature/<name> 从 main 分出、Conventional Commits、Squash and merge、1 个批准、合并后自动删除分支、保护 main。
限制:具体命令、CI 配置细节与平台差异未在资料中提供;文档质量依赖用户提供的团队上下文,缺失信息需向用户确认。