SuperAPI AI 工具集

principle-boundary-discipline

编程与开发

查看项目

更新于 10-15 23:47

技能介绍

用途:这是一条开发原则(principle),用于在实现阶段保持所有权与状态边界清晰,而不是等改动混在一起后再修复。

激活条件:仅当当前任务证据同时指出两点时才适用——存在已声明的边界(如已批准路径、仓库归属方、包职责、信任边界、运行时或私有状态位置),以及拟议或必要的改动会跨越、复制或模糊该边界。边界必须来自已批准任务、仓库指引、既有所有权契约或可观察的仓库结构;不得仅凭目录名推断边界,也不应对每个多文件改动都启用,或借此扩大任务范围。

决策规则:让每个关注点留在其声明的归属方;当结果跨越多个归属方时,使用显式接口或拆分并移交工作,而不是复制、迁移或静默共享所有权。编辑前先命名工件或状态、其当前声明的归属方与拟议目标位置;若改动留在授权归属方内即可满足任务,就保持在内;若必须改动另一归属方,则将该增量分离并要求其自身授权;若分离会妨碍已批准结果,则带着确切的边界冲突停止,而不是发明共享所有权。

限制与反例:改动涉及同一已批准任务下的多个文件或模块时不应激活;适配器可通过声明接口跨越进程或包边界,但跨越接口不等于可复制另一侧实现;共享概念不需要共享存储或重复源所有权,优先使用设计已授权的标识符、模式或显式移交;已批准的所有权迁移可按其迁移与回滚计划移动工件,但不得保留未批准的第二活跃归属方;不得自行制造新的包、协议、仓库或所有权方案,缺失必要的边界决策属于规划阻塞。

可观察的决策变化:当该原则实质改变决策时,输出需指明边界证据,并执行以下之一——将越界工件排除在改动外、使用声明接口同时保留双方归属、把工作拆分为分别授权的增量,或因已批准结果需要未决的所有权变更而停止。报告格式为:Applied principle-boundary-discipline: <边界证据> changed <拟议动作> to <受限动作或停止>;若未改变决策则不应报告。

适用场景:多归属方协作、跨仓库或跨包改动、信任与状态边界处理、需要拆分授权增量的任务。限制:不适用于同一归属方内的普通多文件改动,不能用于扩张任务,也不能替代缺失的边界决策。