用途:在决定每次提交或 PR 应包含什么内容时加载该技能,把一个功能拆成可审阅的工作;在开 PR 前准备提交;把大改动转为链式或堆叠 PR;控制审阅者的认知负荷;应用 SDD 任务时避免产生超过 400 行改动量的 PR;以及用工作单元提交关闭 ODD 任务。
主要规则:按工作单元提交,一次提交对应一个可交付的行为、修复、迁移或文档单元;不要按文件类型提交,即避免“先 models、再 services、再 tests”这类单独无法成立的切分;测试与所验证的行为放在同一提交;文档与用户可见改动放在一起;让审阅者能从 diff 和提交信息理解每个提交为何存在;每个提交在改动变大时都应能成为链式 PR 的候选。
SDD 工作量防护:若 SDD 任务预测改动超过 400 行,应在实现前把提交归组为链式 PR 切片。预算不是代码高尔夫:不得靠删除注释、空行、文档、测试或压缩代码来缩小 diff 以满足审阅预算(默认 400 行,或会话中的 review_budget_lines),应按工作单元切片或报告超出量。切片是有边界的:做一次诚实的切片后若没有连贯的工作单元划分能符合预算,就停止并报告最小诚实数量,并给出 size:exception 建议。
提交前检查清单:本次提交只有一个明确目的;只应用该提交后仓库仍然成立;相关时包含该单元的测试或文档;回滚时不会连带撤销无关工作;提交信息说明结果而非文件清单。
与 PR 的关系:先构建最小的独立工作单元,包含该单元的验证,用 Conventional Commit 信息提交;当 PR 接近 400 行改动时,把提交或提交组提升为链式 PR。
与 SDD 的关系:当 sdd-tasks 产出 Review Workload Forecast 时,低风险把工作单元提交保留在一个 PR 内;中风险按工作单元提交并在建 PR 前监控改动行数;高风险遵循 SDD 的 delivery_strategy:ask-on-risk 时询问,auto-chain 时自动切片,over-budget single-pr 时要求 size:exception,exception-ok 时记录接受的 size:exception。每个 SDD 工作单元应映射到清晰的起始状态、完成状态、同一单元内的验证,以及不删除无关工作的回滚。
与 ODD 的关系:每个 ODD 任务至少以一个工作单元提交关闭;原生审阅候选就是该提交,或在审阅延后时是其所属的 PR 切片,并对照上一个审阅边界评估;工作单元提交累计作者行数沿用与 SDD 相同的交付策略词汇;功能文档记录提交标识,交付策略适用时记录切片边界。
可选检查命令(保持原样):
Review the story before committing
git diff --stat git diff --cached --stat
Check recent commit style
git log --oneline -5
限制:资料未提供安装方式、平台支持、收费或价格信息。