停用旧能力时提供迁移路径

以下示例与示意结果由本站编写，用于说明方法，不是模型实测结果。

使用场景

目录要停用旧评审能力review-old，替代为review-new。直接删旧入口会使已安装用户找不到支持路径，也让后续Agent误以为该能力缺失而重建。

具体做法

按实际注册契约定义active、deprecated、retired或对应状态。弃用记录身份、理由、替代、支持期限与迁移步骤；保留可发现别名/说明和意图移除记录。核旧链接、安装用户及新能力契约，停用后明确不再执行而非静默自动跳到不同权限；重新考虑条件另记。实际删除按授权范围。

反例

标deprecated立即删所有说明和旧ID，后续用户自己猜替代，Agent可重新建回。

改进写法

为教学review-old保留弃用说明、期限和review-new迁移。旧链接可找到原因与替代；retired明确不可调用而保留身份/重审条件。核新契约和用户配置再变更，不能把状态字段当所有宿主已支持。

为什么这样改

生命周期区分迁移窗口和停用，身份记录保护可发现性及历史意图。替代路径让用户继续任务而不依赖记住新名字。

如何验证

教学旧入口显示状态与可用替代链接，新能力参数变更有步骤；状态未支持应以现有机制实现而非假造API。删除意图可查询，后续自动补缺应识别故意移除。

适用边界

实际注册目录和宿主生命周期不同，日期为计划不是事实完成。替代未必行为等价，迁移须验证权限/产物；保留历史也不能保留秘密或不准确声明，修正需有日期说明。