用途:在把分支、PR 或提交交给下一个智能体前,生成只读的交接上下文包,让接手方无需重新做基础发现即可行动。执行模式为在子智能体中运行,默认 thrifty,除非用户明确要求其他智能体。
输入:首选 prepare-branch-context from <base-branch>;也支持省略 base 分支、commits <rev-range> 或 files <path1,path2,...>。未给 base 时先探测 GitHub 默认分支,失败则回退 staging 并说明。
主要能力与流程:解析范围(确定当前分支与 BASE_BRANCH,执行 git fetch origin "$BASE_BRANCH",优先用 origin/$BASE_BRANCH,否则用本地并注明;无 diff 则输出最小摘要并停止);收集低成本事实(branch、status、merge-base、PR 查询、diff stat、name-status、commit log;有 PR 则读标题/正文获取意图、验收标准、约束与已知风险;区分已提交、已暂存、未暂存);选择性读补丁(高风险文件读完整补丁,小 diff 可全读,中/大 diff 跳过 lockfile、生成文件、快照、vendored 代码、批量格式化等低信号尾部并列出,巨大 diff 内联补丁读取上限约前 8-10 个文件);热点排序(风险信号含关键路径、API/schema/契约边界、共享库、大/复杂控制流变更、并发/状态、数据迁移、认证/访问、支付、加密、测试缺口;每个变更文件标 [high|medium|low] 并给原因;行为变更源码无相关测试视为真实热点信号);仅对 [high] 热点做一跳边界映射(变更签名/导出、明显调用方、重要内部导入/依赖),不构建完整依赖图,昂贵时记录未知与确切下一步查询。
输出:先给标准交接字段 answer、evidence、confidence、next_step,再输出 BRANCH_CONTEXT_SUMMARY 块,含 SCOPE、INTENT、CHANGESET、HOTSPOTS、BOUNDARIES、WORKTREE、RISK_SUMMARY、OPEN_UNKNOWNS、READY、NEXT_ACTIONS。
硬性规则:只读,绝不编辑文件;绝不静默假设 base 分支;fetch 后优先 origin/<base> 并明确注明回退;有 PR 时先读标题/正文再深读 diff;始终包含风险排序热点与测试缺口信号;[high] 热点必须读实际补丁;保持快速,一轮加至多一次针对高热点定向跟进,剩余未知直接报告而非循环。
限制:资料未提供安装方式、收费、平台支持与效果数据。