保存、绑定与失败恢复

先用GET确认原候选的saved/bound状态,再按是否希望绑定显式选择POST。GET即使saved=false也返回预留skill_id,只有saved标志说明保存状态。

情况

判断与后续

GET saved=false/bound=false

尚未查到匹配的保存记录;持有ID不等于技能存在。

GET saved=true/bound=false

已保存,但本次可绑定目标范围内未见绑定;核对绑定意图与资格。

GET saved=true/bound=true

当前目标中找到技能绑定;不要重复创建候选。

POST bind_current=false返回bound=false

本次不做绑定,不解除已有绑定;GET仍可能bound=true。

POST bind_current=true成功

技能保存/复用后完成绑定;结果只返回技能/工作区/目标与bound,不返回新版本号。

409且details.reason为SKILL_CREATOR_BINDING_FAILED

保存已完成,绑定失败;保留details.saved_skill_id,按同一任务/call/digest回查,再按原意重试绑定。

超时或其他结果未知

回查同一候选身份,不换call_id重新创建,也不能把错误当全程回滚。

保存阶段在任务锁定的租户事务中核对候选,按workspace/task/call确定技能ID。已有记录还需archive摘要和CreatedBy一致才复用,否则冲突;不能将此写成对任意用户、任意内容的通用幂等保证。

绑定在保存事务之后进行,先核对目标更新访问。普通目标添加技能引用;包管理目标会保留当前显式资源/自定义元数据并通过新版本包加载,使用期望默认版本防止并发覆盖。该动作可能涉及版本发布,不承诺只追加一条引用;

GET不是修复动作,也不会为只读/系统来源推导其他目标绑定状态。

最后更新于