用途:interop(/dh:interop)是 Superpowers 计划文件的互操作适配器。它把一份 Superpowers 计划文件送入 /work-backlog-item 流水线,生成 SAM 任务计划,再把反向引用写回原计划文件。它不重新实现任何流水线逻辑,完全委托给 /work-backlog-item。
主要能力:校验计划文件路径;按精确模式匹配从原文提取 Title、Goal、Spec、Backlog item、Chunks 字段(不做推断);确保存在 backlog 条目(无则通过 MCP 工具创建并写回引用);调用 /work-backlog-item 生成 SAM 任务计划;捕获计划地址;写回 SAM tasks: 反向引用;为每个 ## Chunk N: 标题写入 <!-- SAM: T{N} in {plan-address} --> 注释。
使用方式:调用格式为 /dh:interop <path-to-plan-file>,例如 /dh:interop docs/superpowers/plans/2026-03-11-oauth-token-refresh.md。使用 <sam_cli/> 或 <dh_scripts/> 前需先加载 dh:dh-cli-usage。缺少 Title 或 Goal 会中止;缺少 Spec 或 Chunks 仅记录警告。创建 backlog 条目时使用 mcp__plugin_dh_backlog__backlog_add,参数 title、description、plan;资料指出 CLI 的 backlog add 没有 --plan 标志,该参数暂无确认的 CLI 等价物,需用 MCP 工具。若输出未给出计划地址,可用 <sam_cli/> plan list 查找。
适用场景:需要把 Superpowers 计划接入 backlog 与 SAM 任务规划流程,并在原计划中保留任务与分块对应关系时。
限制:重复运行需保持幂等,不产生重复或数据丢失;分块数超过 SAM 任务数时,超出部分不写注释;计划地址由 MCP 工具解析,不自行构造文件系统路径;修改文件使用 Edit 工具,不重写整个文件。