Covers
jinjunnn/alpha-work#13 AC1、AC3、AC4、AC5:Claude Code 插件作为薄适配器使用同一 submit/status/cancel 契约,稳定传递幂等键、真实取消结果和有界重试。
Boundary
插件 commands/skills 的 Alpha cloud-job client、版本化 contract dependency、credential purpose 选择、错误/终态映射、deterministic consumer tests 和文档。
Out of scope
- 不在插件复制平台授权、调度、公平、计费或任务状态机。
- 不接受 user/web token、无 purpose token、旧 job payload 或隐式 fallback。
- 不把平台 secret、服务 credential 或原始 artifact 字节写入插件包、日志或 transcript。
Design notes and risks
- 插件重试必须复用同一幂等键,避免 CLI/agent 自动重试重复执行。
- cancel/status 只映射平台事实,不能在客户端伪造终态。
- contract unknown future version 必须 fail closed,而不是静默降级。
Exit condition
Merged PR + repository deterministic checks green + documentation impact handled。插件生产命令到版本化 client 的 wiring test 通过;运行时矩阵归父项 VERIFY。
Parent
Refs jinjunnn/alpha-work#13(native sub-issue;PR 不得 Fixes 父需求)
Covers
jinjunnn/alpha-work#13AC1、AC3、AC4、AC5:Claude Code 插件作为薄适配器使用同一 submit/status/cancel 契约,稳定传递幂等键、真实取消结果和有界重试。Boundary
插件 commands/skills 的 Alpha cloud-job client、版本化 contract dependency、credential purpose 选择、错误/终态映射、deterministic consumer tests 和文档。
Out of scope
Design notes and risks
Exit condition
Merged PR + repository deterministic checks green + documentation impact handled。插件生产命令到版本化 client 的 wiring test 通过;运行时矩阵归父项 VERIFY。
Parent
Refs jinjunnn/alpha-work#13(native sub-issue;PR 不得 Fixes 父需求)