版本控制CLI【免费下载链接】gitoxideAn idiomatic, lean, fast safe pure Rust implementation of Git项目地址https://gitcode.com/GitHub_Trending/gi/gitoxide点击查看免费下载导读本文以 gitoxide 仓库的 Agent 技能文档.agents/skills/tix-qa-sweep/SKILL.md为核心骨架系统讲解如何在由 Tix 管理的提交栈stack或提交树tree中从最旧的提交开始逐个访问所有未带✔️检查通过标记的可见提交运行用户选择的 Fast / Thorough 两档 QA 配置并修复失败最终让每个提交都通过检查——整个过程不进行 squash、不重排提交并完整保留已通过人工评审的补丁。读完本文你将掌握 Tix 变更 IDchange ID的稳定寻址方式、gitoxide 仓库本地 QA 脚本etc/scripts/ci-check-local.sh的两档运行模式、逐提交遍历与修复循环repair loop的完整操作规程以及遇到旅行冲突travel conflict和未知失败时的正确止损姿势。一、背景Tix 是什么为什么需要 QA Sweepgitoxide 仓库使用一个名为tix的、受tig启发的提交历史浏览与编辑工具来管理工作区内的可见提交详见 gix-tix/README.md 与行为规范 gix-tix/spec.md。Tix 的核心特征在于变更 IDchange IDtix show输出的每一行中每个 7 位提交哈希后面紧跟一个 7 位 reverse-hex 变更 ID。由于任何编辑都会改写提交哈希跨编辑操作稳定寻址必须使用变更 ID而不是哈希。富化enrichment标记Tix 把todo、note、checks-pass等元数据以 Git notes 的形式存储在工作区本地的refs/worktree/tix/enrich与refs/worktree/tix/enrich-tree引用下见 gix-tix/spec.md 第 292-303 行。其中✔️表示该精确树exact tree的检查已通过而✨表示人工评审通过——两者互不蕴含对方。旅行traveltix travel change-id用于在提交之间切换检出版本并同步处理 pending-replay祖先被编辑后后代变更会被延迟重放与冲突物化。QA Sweep 的技能文档 .agents/skills/tix-qa-sweep/SKILL.md 正是围绕逐提交验证并修复这一工作流编写的目标不是把整个工作区一次性跑一遍检查而是让栈中每一个可见提交各自通过检查因为一个修复了祖先提交的补丁会改变后代的树从而使其既有的✔️标记失效。二、前置知识读透 Tix 的修复策略与历史变更命令执行 sweep 之前必须先阅读配套技能文档 .agents/skills/tix/SKILL.md并遵循其中的修复策略和历史变更命令——包括 amendment 与 fixup 的选择、评审保留、作者身份authorship、签名以及检出版本恢复。这些规则同样适用于格式化修复。Tix 技能文档给出了关键的任务-默认操作对照表任务默认操作增加独立的工作创建新提交只改提交信息直接对目标 reword修改一个不含✨的提交内容直接 amend无论其他富化标记如何不创建 fixup修改一个含✨的提交内容保留该提交在其正上方插入fixup!需要特别强调两条红线✨只能由人工评审者显式设置或清除对应tix enrich patch refackiewed类命令。Agent 一律不得调用该命令包括--clearAgent 的评审意见、检查通过、正面反馈或请收尾等请求都不构成授权。✔️只记录某个精确树检查通过。不得在变更后伪造标记也不得把一次聚焦测试当作完整的 QA 配置来打标记。实操中最常用的三条命令均来自 .agents/skills/tix/SKILL.md# 切换到目标变更从干净的 index 与 worktree 出发确认 HEAD 后再编辑 tix travel $target_change # 修改不含 ✨ 的提交用 --index 消费整个索引显式纳入新文件 tix amend --index # 创建 fixup先用 git 生成精确首行再以完整消息文件创建 git show -s --formatfixup! %s HEAD $message_file tix new --index --author $agent_author --file $message_file注意tix show渲染 Markdown可能省略字面反引号因此 fixup 首行必须用git show -s从HEAD提取不要从tix show复制。tix new没有--fixup标志。三、第一步选择 QA ProfileFast / Thorough在执行任何仓库命令之前必须先确定用户想要的 QA 配置档位Fast运行项目的格式化formatting、lint、类型检查以及配置好的静态或依赖检查。Thorough在 Fast 基础上额外运行项目的标准构建build、测试tests以及配置好的文档或集成检查。如果请求明确说了 fast 或 thorough就推断对应档位否则必须让用户在Fast与Thorough之间做出选择——优先使用可用的问卷questionnaire机制没有问卷就在聊天中直接询问在用户回答之前不得开始 sweep。一个笼统的请验证/请清扫请求不能用来推断档位。四、第二步选定 QA 命令以 gitoxide 的 ci-check-local.sh 为主先用git rev-parse --show-toplevel解析出被清扫的仓库根目录并从该仓库选择 QA 命令——即使本技能是通过 symlink 全局安装的也要使用目标仓库自己的入口以保证工具链、feature flags、包管理器与工作目录保持一致。gitoxide 的优先入口是 etc/scripts/ci-check-local.sh用法为ci-check-local.sh (--fast|--thorough)。从脚本源码第 59-91 行可以看到两档的实际内容Fast 档run_fast_checkscargo fmt --all -- --check # 格式化检查 cargo machete # 未使用依赖检查 just clippy -D warnings -A unknown-lints --no-deps cargo deny --workspace --all-features check bans licenses sourcesThorough 档先跑require_clean要求git status --porcelainv1为空再依次执行run_fast_checks env GIX_TEST_IGNORE_ARCHIVES1 just ci-test # check doc unit-tests check-mode just doc-tests # 文档测试 env GIX_TEST_CREATE_ARCHIVES_EVEN_ON_CI1 cargo nextest run --workspace --no-fail-fast --exclude gix-error # 生成归档的测试会合法地改写/新增 tracked fixtures只清理这一已知类别 git restore -- :(glob)**/tests/fixtures/generated-archives/*.tar git clean -f -- :(glob)**/tests/fixtures/generated-archives/*.tar just ci-journey-tests # journey-tests-pure / -small / -async / journey-tests require_clean tix enrich tree checks-pass # 打 ✔️ 标记上述just配方均定义在仓库根目录的 justfile 中例如ci-test: check doc unit-tests check-mode、doc-tests、ci-journey-tests分别对应全工作区构建检查、doctest 与四个档位的 journey 测试max-pure、small、lean-async、max。这些配方解释了脚本第 76-83 行的行为普通 CI 避免重写平台相关的归档 fixtures而显式的 nextest 全工作区运行仍然会执行创建归档的测试GIX_TEST_CREATE_ARCHIVES_EVEN_ON_CI1允许其在 CI 上也生成归档随后只回滚/清理tests/fixtures/generated-archives/*.tar这一已知类别保证其他任何变更都保持可见。脚本还包含两个值得注意的细节需要真实 PTY 运行非 CI 的 journey 快照会练习 TUI 输出macOS 的script(1)会改变它们要验证的字节流第 24-25 行注释。缓存规模监控脚本要求cargo machete、cargo deny、just、nextest等工具可用Thorough 跑完后若安装了dua会输出 target 目录大小并注明暖机后的全工作区扫描目前约 70 GB第 87-89 行。选择命令后必须在开始遍历之前声明所选命令及任何排除项。如果找不到有意义的检查或所需工具不可用要如实报告这一缺口不能把未执行的检查标记为通过。五、第三步准备Prepare按以下顺序完成准备工作运行git status --porcelainv1 --branch要求 index 与 worktree完全干净包括没有 untracked 文件。不得 stash、丢弃或吸收预先存在的工作成果。要求环境里装有tix以及所选 QA 命令真正需要的工具。用mktemp -d ${TMPDIR:-/tmp}/tix-qa-sweep.XXXXXX创建私有临时目录。把tix show的原样输出写入temp-dir/show.txt并把 QA 命令、工作目录、环境变量与排除项记录到temp-dir/qa-plan.md。使用 gitoxide 的 runner 时把ci-check-local.sh复制到temp-dir/ci-check-local.sh并从仓库根目录运行这份副本——因为脚本内部会git rev-parse --show-toplevel后cd到仓库根etc/scripts/ci-check-local.sh 第 26-27 行复制副本可以确保旅行到更老的提交后脚本依然可用。对其他 runner先检查其相对路径假设保留其预期的工作目录与所需辅助脚本。记录起始检出版本及其稳定变更 ID。从show.txt中收集除 base 分隔行外的每一行可见提交包括已标✔️的行按最旧在前排序保持拓扑顺序对同一深度的相互独立提交按其自底向上的显示顺序排列。如果某个显示的变更 ID 前缀出现歧义或重复立即停止。六、第四步Sweep 主流程以最旧在前的顺序对记录的每个变更 ID 恰好访问一次。关键认知是祖先提交的修复可能改变后代的树并使后代的✔️标记失效因此是否跳过某个提交的 QA只能在该提交被旅行到达之后、基于新鲜数据来决定。缓存策略复用构建缓存遵守仓库或用户特定的存储限制。仅对 gitoxide 而言可预期一个暖机的target/约 70 GBthorough runner 会用dua报告大小不要从 APFS 的空闲空间报告去推断也不要自动删除缓存。若增长明显超出预期停止并报告实测大小。对每个记录的变更 ID执行以下 5 步旅行直接运行tix travel change-id完成下述旅行冲突处理并确认HEAD是预期变更。重新判定运行一次全新的tix show检查该变更行的前导富化字段。若其当前树已标✔️直接跳到下一个变更 ID。不得用初始show.txt中的标记或已变化的提交哈希来做此判定。打标所选检查在当前HEAD全部通过后要求 worktree 干净运行tix enrich tree checks-pass若 runner 已设置该标记此操作幂等。要求富化必须成功然后不做额外编辑继续下一个变更 ID。格式化修复若某个已配置的格式化检查失败运行对应的格式化命令例如cargo fmt --all检查并暂存格式化变更按tix策略记录它们即遵循 amendment/fixup 规则例如含✨的提交要插入 fixup。要求 worktree 干净并在结果HEAD上重跑所选 QA 配置。格式化变更总是想要的不需要进入诊断修复循环。其他失败进入下面的修复循环Repair Loop重跑所选配置直到通过。七、修复循环Repair Loop当某次失败不属于格式化问题时按以下循环处理重现不带输出抑制地重跑打印出的失败命令。检查失败本身、相关调用方、测试与邻近历史区分仓库缺陷与工具缺失 / 主机行为不支持 / 网络失败 / 偶发 flake。最小修复用能解决失败的最小改动修复仓库缺陷。保留该提交的意图不要把无关的后续变更倒拉回来。聚焦复验在 worktree 仍为脏状态时运行聚焦的失败检查。检查完整 diff只暂存预期路径不盲目吸收生成的残留物。记录修复按tix策略记录暂存的修复。如果这产生了 fixup则在新的HEAD上继续后续修复。整体复验要求 worktree 干净在结果HEAD上重跑所选 QA 配置。重复诊断 → 修复 → 聚焦检查 → 提交 → 配置复验的循环直到通过。关于 fixup 覆盖的特别规则当修复创建了 fixup 时要在继续下一个变更 ID 之前对这份 fixup 运行所选配置。只给通过的那棵树打✔️标记被评审的源提交保持原样并如实报告它在单独环境下仍然失败但已被通过的 fixup 覆盖。八、处理旅行冲突Travel Conflicts遵循 .agents/skills/tix/SKILL.md 中的重放冲突replay-conflict流程同时保留两个提交的意图。完成冲突解析后要求 worktree 干净然后重试最初请求的变更 ID。Tix 的冲突物化语义值得注意见 gix-tix/spec.md 第 27-41 行tix travel --materialize-conflicts的故意非零退出必须对应一个包含未合并条目unmerged index的状态解析时检查git diff --cc与索引的:1:、:2:、:3:三个阶段暂存解析结果后还需tix amend --index再重试旅行——仅暂存是不完整的。当解析需要 API、兼容性或产品层面的判断时停止而不是猜测。九、停止与收尾Stop and Complete停止条件遇到意外的 Tix 失败、无法解决的环境失败、可重复的 flake、歧义的变更 ID或正确修复方式不明确的失败时立即停止并报告当前变更 ID、命令、输出与 worktree 状态。不得用 reset 绕过失败操作、不得替换提交、不得改用 Git 切换分支、不得 push。收尾条件每个记录的变更都通过了所选配置、或已被通过的 fixup 覆盖之后用tix中的返回流程恢复起始检出版本若最初是 detached 状态通过保存的变更 ID 返回而不是过期的哈希。验证检出版本并确认git status --porcelainv1为空。汇报所选配置档位、已测试的变更 ID 列表、已 amend 的变更、被 fixup 覆盖的已评审提交附两个变更 ID、已解决的旅行冲突以及任何超出所选配置范围的 QA 任务。仅在成功完成后才删除临时目录若中途被打断保留恢复材料。十、把本文档流程放回仓库上下文技能文档本身.agents/skills/tix-qa-sweep/SKILL.md含配套 Agent 描述 .agents/skills/tix-qa-sweep/agents/openai.yaml。底层 Tix 策略与命令.agents/skills/tix/SKILL.md、行为规范 gix-tix/spec.mdtix show输出格式、变更 ID 宽度、enrichment 的 Git notes 存储机制见第 16-26、292-303 行、开发不变量 gix-tix/AGENTS.md。QA runner 与配方etc/scripts/ci-check-local.sh、仓库根 justfile。理解这些文件之间的调用关系是正确执行 sweep 的前提技能文档要求先读 tix 技能、再选档位、再挑命令、再准备、再遍历而ci-check-local.sh的 Thorough 档末尾已经包含tix enrich tree checks-pass与技能第 3 步的幂等打标天然衔接。整套流程的设计目标始终一致用稳定的变更 ID 寻址、以精确树为单位打标记、最小改动修复、绝不伪造检查结果。赞分享版本控制CLI【免费下载链接】gitoxideAn idiomatic, lean, fast safe pure Rust implementation of Git项目地址https://gitcode.com/GitHub_Trending/gi/gitoxide点击查看免费下载相关推荐Scala 2 仓库贡献指南从提交 PR 到通过测试与审查的完整实战手册Scala 2 仓库贡献指南从提交 PR 到通过测试与审查的完整实战手册 本指南以 Scala 2 官方仓库编译器 标准库 语言规范的 CONTR编程语言编译器标准库语言运行时Biome 仓库子系统代码审查指南从仓库地图到逐子系统检查项Biome 仓库子系统代码审查指南从仓库地图到逐子系统检查项 本文面向需要在 Biome 代码库crates 工作区中做只读代码审查的开发者与 AI 审查开发工具Lint格式化静态分析代码质量前端cuda-samples 之 tf32TensorCoreGemm基于 WMMA 与异步拷贝的 TF32 Tensor Core GEMM 深度解析cuda samples 之 tf32TensorCoreGemm基于 WMMA 与异步拷贝的 TF32 Tensor Core GEMM 深度解析 导读 本云原生容器编排上一篇NVIDIA Profile Inspector显卡配置优化工具释放硬件潜力的高级用户指南下一篇NVIDIA Profile Inspector深度优化指南释放显卡潜能的专业配置方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考