Git 协作与版本发布规范
用可审查、可回滚的 Git 流程管理代码变更与版本发布。
技能强调原子提交、检查暂存区、排除密钥、可回退提交和工作树隔离，显示出一定的最小化与恢复意识，因此未低分；但要求所有代码变更都触发，未要求用户确认，包含 git reset --hard、删除工作树、推送标签等外部或破坏性操作，也未说明权限边界、敏感数据处理、误操作恢复或数据流透明度，扣除9分。
内容结构一致，覆盖提交、分支、工作树、发布和验证路径；仓库 CI 会验证技能结构和评估脚本，因此保留部分分数。但命令假设 Node/npm/tsc 和特定项目布局，未提供环境探测、异常输入处理或失败诊断；“每次提交都测试”与项目实际测试命令可能不匹配，且静态审查不能证明可运行，扣除11分。
受众和常见场景较清楚，覆盖代码变更、并行代理、发布和版本管理；但“Always”会造成过度触发，未声明非适用范围、输入输出契约或触发排除条件，且没有中文使用说明或中国大陆网络适配信息，扣除7分。
技能具有清晰的分层结构、示例、反合理化表、红旗和验证清单；README 提供安装方式，仓库声明 MIT、维护团队和 CI。仍缺少该技能自身的版本、变更记录、明确维护责任与更新路径，部分交叉技能依赖未在此文件中说明，扣除5分。
原子提交、短分支、暂存区检查、版本语义和发布清单能直接帮助代理组织可审查、可回滚的 Git 工作；但规则较强约束且缺少针对不同仓库、非 Node 项目和用户偏好的适配，部分建议（如约100行）缺乏任务级依据，输出仍需人工判断，按静态上限给7分并扣8分。
技能提供命令、检查清单和可观察的 Git 状态；仓库 CI 存在真实工作流并运行结构验证和评估脚本，因此获得有限证据分。核心 Git 行为未由提交测试套件覆盖，DORA 等外部主张没有可核查引用，且未提供该技能专属评估结果，扣除6分。
- “Always”触发条件可能使该技能在只读分析、文档编辑或无需 Git 的任务中过度介入。
- 执行 git reset --hard、删除工作树或推送标签前应增加明确的用户确认、目标校验和恢复说明。
- npm test、npm run lint 和 npx tsc --noEmit 不是所有仓库都存在，执行前应探测项目工具链并提供失败原因。
- 未提供中文说明，也未证明核心功能在中国大陆网络环境中可稳定获取或安装。
这个 Skill 能做什么，适合哪些场景？
这是 addyosmani/agent-skills 集合中的一个 Git 工作流技能，专注于代码变更、分支、提交、冲突处理、发布和版本管理。它推荐以短生命周期分支配合主干开发，并要求将工作拆成可验证的原子提交。技能还覆盖工作树、提交前检查、生成文件处理、Git 调试、语义化版本、标签和面向用户的变更日志。它适合希望让 AI 编码代理持续产出清晰、可审查、可恢复历史的团队。
指导代理在每次代码变更时使用 Git；建议从主分支创建短生命周期的 feature、fix、chore 或 refactor 分支；将实现拆成“实现、测试、验证、提交”的小增量；要求提交信息采用 type 加简短描述的格式并解释原因；使用 Git worktree 支持并行分支；提交前检查暂存差异、秘密、测试、lint 和类型检查；区分应提交与不应提交的生成文件；使用 git bisect、log、diff、blame 和 grep 搜索进行调试；根据语义化版本选择 MAJOR、MINOR 或 PATCH，创建发布标签并维护按用户影响组织的变更日志；修改后输出 CHANGES MADE、THINGS I DIDN'T TOUCH 和 POTENTIAL CONCERNS 等结构化摘要。
- AI 代理正在实现一个多文件功能，需要按小切片提交并保留可回滚的保存点。
- 多个代理需要同时开发不同功能，希望用 Git worktree 隔离分支和工作目录。
- 团队准备合并变更，需要检查提交粒度、提交信息、秘密、测试、lint 和类型检查。
- 维护者准备发布一个有消费者依赖的软件，需要判断语义化版本、创建标签并编写变更日志。
- 开发者遇到回归问题，需要用 git bisect、log、diff 或 blame 缩小问题范围。
这个 Skill 有哪些优点和局限？
- 覆盖从分支和提交到发布标签、语义化版本和变更日志的完整流程。
- 提供具体的分支命名、提交格式、工作树命令和提交前检查。
- 强调原子提交、短生命周期分支、验证门槛和范围纪律，便于审查、调试和回滚。
- 对常见拖延或跳过流程的理由提供反驳，并列出红旗信号。
- 内容是工作流指导，不会替用户执行 Git 命令或验证项目状态。
- 测试、lint 和类型检查命令以 npm test、npm run lint 和 npx tsc --noEmit 为例，未针对具体项目配置。
- 技能没有说明特定 Git 托管平台、CI 系统或发布工具的集成方式。
- 源材料未提供该技能独立的测试套件或平台兼容性测试证据。
如何安装这个 Skill？
该技能随完整仓库安装。使用：npx skills add addyosmani/agent-skills --skill git-workflow-and-versioning。也可以先浏览技能：npx skills add addyosmani/agent-skills --list。仓库 README 还说明可安装完整的 24 个技能：npx skills add addyosmani/agent-skills。
如何使用这个 Skill？
在进行任何代码变更、提交、分支管理、冲突解决、并行工作、发布、版本升级或变更日志编写时启用它。例如："Apply git-workflow-and-versioning to this code change: split the work into tested atomic commits, check the staged diff for secrets, and recommend the version bump." 具体客户端的单技能调用语法未在该 SKILL.md 中单独规定。