个人项目
这些规则适用于明确采用 personal@tj-agents 的项目。采用行为记录了项目的个人范围;主目录、作者姓名或雇主关联本身并不构成个人范围。除非 Tommy 明确更改此范围,否则雇主项目仍属于此配置文件之外。
维护唯一当前受支持的解决方案。在替换行为时,移除被取代的名称、别名、回退实现、适配器、配置格式及兼容性分支。在同一切换点协调并迁移所有已知调用者、项目声明、已安装注册项、生成产物及实时运行时入口点。不得为假设的外部用户保留过时行为;与实际的合作开发者协调升级。
在包括 Windows 和 Linux 启动路径(若支持)在内的每个受支持平台上,验证用户实际使用的入口点。仅靠源码编辑、成功生成、通过的单元测试及版本命令,不足以证明迁移已完成。检查已安装绑定及全新运行时行为。将任何未经验证的入口点记录为不完整,并注明其解析器及可观测的验收条件。
例如,将 old-launch 替换为 launch 意味着迁移已注册的 shell 命令、项目配置及实际调用者,删除旧入口点,然后在每个受支持操作系统的新会话中调用 launch。仅运行 launch --version 会使切换点未经验证。
将 old-launch 替换为 launch:
1. 迁移已注册的 shell 命令、配置及实际调用者。
2. 删除旧入口点并重新生成已安装的设置。
3. 从受支持的新 Windows/Linux 会话中调用 launch,并检查其实际行为。
结果:仅运行 launch --version 会导致此迁移不完整。
不得独立添加向后兼容性例外。将明确的相反用户需求作为审慎策略决策提出,识别受影响的受支持行为,并在实施前协调此配置文件的范围。切勿在回退或适配器中隐藏例外。
以最小适合实现解决已证明的问题。仅为具体当前需求添加抽象、依赖项、配置开关、重复路径或进程机制。优先使用项目已选择的能力。按比例验证行为及有意义的失败路径;不得添加仅重复实现或没有具体收益的检查列表式测试。
此策略在此仅编写一次。个人采用会从此文档体生成标记的原生命令块,并检查其是否发生漂移。单独的选定插件或 always 层级不能证明加载成功。