SuperAPI AI 工具集

git-workflow

编程与开发

查看项目

更新于 10-16 09:28

技能介绍

用途:该技能用于对 XerahS 代码库执行提交、推送或版本变更操作,仅在任务明确包含这些操作时使用。使用时应遵循 AGENTS.md 中的 wrapper 与 fallback 指引。

版本与提交格式:应用版本由根目录 Directory.Build.props 提供。提交应用前需与现有最高的 XerahS 发布标签比较,版本必须严格更高,必要时提升到下一个未发布版本。应用提交格式为 [vX.Y.Z] [Type] Concise description,类型包括 Fix、Feature、Build、Docs、Refactor 等。共享库/子模块提交(含 ShareX.ImageEditor)使用 [Type] Concise description,不带应用版本。版本递增规则:修复递增补丁号;功能递增次版本号并重置补丁号;破坏性变更递增主版本号并重置次版本与补丁号。不要在各项目文件中写入应用版本;仅当其他受跟踪属性确实承载 XerahS 应用版本时才同步,不要覆盖独立的库版本。发布自动化会同步派生的 Chocolatey 元数据并校验生成的包。

验证与集成:暂存前检查状态、任务差异、跟踪分支与子模块状态,保留无关改动。集成需要时在确认本地工作可保留后再拉取/变基或更新子模块,不要无条件拉取到脏工作区。推送代码或构建配置前,运行 AGENTS.md 要求的桌面解决方案构建及相关测试,不要禁用 warnings-as-errors。例外:仅文档变更时检查差异、链接与一致性,若可执行指令或脚本变更则运行相关脚本检查;仅根 Directory.Build.props 版本号变更时,确认任务差异只含预期版本改动且提交前缀匹配。

收尾:对已授权的提交/推送,暂存任务明确路径,检查暂存差异后提交,再推送到已验证的远程与分支。不要用 add . 暂存无关工作,相关文档应包含在同一逻辑变更中。保留已配置的钩子,修复钩子失败后重试,除非明确要求否则不要绕过钩子。绝不隐式创建分支或标签。