用途:面向实体级(函数、类、属性)理解代码变更,而非仅行级 diff。适用于语义差异分析、变更影响评估、评审风险分级、分支集成准备、语义冲突分析以及多智能体重叠协作。
主要能力:sem 提供结构事实,做实体级 diff、graph、impact、blame,确立“变了什么”;inspect 对实体分类并做风险评分(爆炸半径、依赖方、公共 API),给出评审顺序;weave 处理实体级合并语义,并可选提供声明式协作协调。
用法示例: 查看最近一次提交:sem diff --from HEAD~1 --to HEAD --format json,然后 inspect diff HEAD~1 --format json。 对比分支与 main:sem diff --from origin/main --to HEAD --format json,inspect diff origin/main..HEAD --format json。 重构影响:sem impact <entity>、sem graph。 合并准备:weave preview main。 scripts/ 中脚本为可选辅助,可直接调用 sem、inspect、weave。
限制与安全:琐碎变更直接阅读即可,不必使用;默认不得改动仓库合并配置,除非用户明确要求,不要运行 weave setup(它会修改合并驱动配置);仅在存在合并冲突、多个智能体或分支触及相同或相邻语义区域、准备分支集成或确需语义冲突上下文时运行 weave;否则应明确说明 weave 不需要。