用途:为 Palantir Foundry 的 Code Repository 分支建立质量门禁,覆盖自动检查、单元测试与拉取请求评审。外部 Git 托管可镜像证据,但不能替代 Foundry 对仓库输入、输出、依赖与平台构建执行的检查。
主要能力:提交到 Code Repository 分支会触发自动检查,Checks 标签页是主要结果界面;按仓库支持的构建布局配置后,Python 单元测试可参与仓库 CI;转换的输入与输出声明由 CI 评估,不能在构建时动态选择;拉取请求可要求合并前获得批准评审,评审者可查看转换变更对数据集的影响。
使用方式:先确认 Foundry enrollment、Code Repository、目标分支、所属数据集与发布负责人,并确认项目类型(Python transforms、TypeScript 或其他受支持类型);阅读 references/official-docs.md 并检查仓库现有 CI 与分支设置。在沙箱分支与非生产数据上验证检查与回滚路径。步骤包括:盘点分支保护、检查、单元测试接线、构建归属与必需评审人;编写隔离单个转换逻辑单元、不依赖实时外部服务的测试;运行 Foundry 分支检查并保留失败检查、构建报告与依赖证据;打开 Foundry 拉取请求,评审代码与数据集影响并取得独立批准;仅合并已评审的确切提交,再验证主分支检查与下游构建行为。工具使用上,用 Glob 定位仓库与配置,用 Grep 查找标识符与错误,用 Read 查看最小必要文件,Write 仅用于新的已批准本地草稿或测试,Edit 仅用于回滚已知的有限变更;文件工具不能替代已认证的 Foundry 操作或负责人批准。
适用场景:为 Python transforms 仓库添加轻量 pytest 套件并使其出现在 Checks 标签页;诊断预览成功但完整 CI 构建失败的转换,比较采样预览与生产数据、依赖集和声明输入。
限制与边界:分支策略变更需 Code Repository 负责人批准,数据集输入输出或生产构建变更需数据负责人批准;不得绕过失败的 Foundry 检查或批准评审要求。若检查仅在 Foundry 失败,比较预览与完整构建输入、依赖解析、归属与详细构建报告;分支落后时在沙箱分支升级或合并基线后重跑全部检查;必需数据集无归属时停止并解决归属,不得削弱检查;外部 CI 通过而 Foundry 失败时,以 Foundry 结果为准并阻止合并。输出为 CI 门禁图,含仓库、分支、检查、测试、数据集影响、评审人、确切提交、结果链接与回滚,并区分 Foundry 证据与外部 Git 镜像证据。