用途
本技能用于解决多贡献者参与“合成编码”项目时的集成问题。合成编码指主导开发者(lead synthesist)通过与 AI 持续、富含上下文的协作来构建和演进系统,其代码库具有深度架构一致性、隐式约定和快速演进的特点。当外部贡献者 fork 或分支时,他们拿到的是一个快照,而主导者可能已经演进架构、引入新模式或重构子系统。直接合并会带来回归、不一致、安全缺口和质量漂移。本技能定义了一套“采纳并适配”(adopt-and-adapt)的集成模式。
主要能力
- 定义主导合成者与贡献者的角色与职责。
- 提供贡献者从构建前、构建中到提交的完整工作流。
- 给出集成四步流程:评估、审查、集成(采纳并适配)、沟通。
- 说明 cherry-pick 后的回归验证方法,包括检查文件是否被先前合成合并修改、检查组件 props 和 imports、每次 cherry-pick 后运行完整测试套件。
- 处理基于旧分支的 cherry-pick 问题,如误导性 diff、方法数量验证、只挑选功能提交。
- 说明 cherry-pick 测试级联:行为变更可能破坏其他文件的测试。
- 提供贡献者归属方案,使用 GitHub 认可的 Co-authored-by trailer,并根据集成强度选择归属模型。
- 列出四类质量门:完整性、安全、架构、项目特定标准。
- 给出沟通与反馈原则,包括具体、解释原因、认可好工作、区分严重程度、先修复后沟通。
- 强调技术回复必须基于代码验证,并提供按回复类型的验证清单。
- 说明集成审查文档应包含的内容。
- 提供多 PR 集成时的依赖感知排序和跨 PR 测试失败处理。
- 给出选择性文件检出(selective file checkout)作为回退方案,并说明适用与不适用场景。
- 描述集成强度的演进阶段。
使用方式
该技能以文档形式提供指导,不包含可执行代码或安装命令。使用者需按照文档中的流程和规则,在主导合成者与贡献者之间执行集成。具体操作包括:贡献者阅读贡献者指南、同步最新 main、每个分支一个功能、提交完整功能(前后端加测试)、使用约定式提交格式;主导合成者评估分支、审查质量门、从当前 main 创建新分支、逐文件逐函数选择性引入、在集成中修复问题、运行完整测试、squash merge 到 canonical main、同步镜像、与贡献者沟通。文档中给出的 git 命令示例(如 git log --oneline --diff-filter=M -- <file>、git diff --name-only main...contributor/branch、git checkout contributor/branch -- path/to/file)应原样使用。
适用场景
适用于由主导合成者通过 AI 协作构建、并有外部贡献者参与的项目。尤其适合代码库快速演进、标准尚未完全文档化、需要保持架构一致性和质量门槛的场景。也适用于需要处理旧分支 cherry-pick、多 PR 集成、贡献者归属和跨 PR 测试失败的情况。
限制
文档未提供具体的安装命令、代码实现或工具集成方式。部分内容(如“项目特定标准”)因项目而异,需由贡献者指南记录。文档末尾“Evolution of Integration Intensity”部分在“When appropria”处截断,后续内容暂未提供。