用途:本技能面向需要产出、执行或迭代具体 Signadot Plan 的场景。Plan 是不可变、编译后的 action 调用 DAG,每个 step 调用组织目录中的一个 action,输入来自 plan params、字面值或上游 step 输出。若用户只是询问“plan 是什么”“如何工作”或需要教程概览,不应使用本技能,应指向 Signadot 文档。
主要能力:发现 plan schema、action 目录、action ID、禁用 action 与 action body 契约;编写 YAML 规格(refs 与值、drill-in、条件、extraInputs、extraOutputs、secrets);处理 routingContext、路由键注入、自定义路由头、query-param 回退与 spec.cluster;创建/运行 plan、查看执行 JSON、日志、输出产物与退出码;按需打标签。
使用方式:先明确目标与副作用,再获取 schema 并扫描已启用 action,按契约而非名称选择 action,确认路由与集群形态后起草 YAML。创建前自检 refs 仅用路径表达式、参数已声明、drill-in 源有 schema、条件读取已解析参数、secrets 不写入字面值、发流量步骤有正确路由上下文。常用命令:signadot plan schema;signadot plan action list -o json;signadot plan action get <name> -o json;signadot plan create -f <spec.yaml> -o json;signadot plan run <plan-id> --param k=v -o json;signadot plan x logs <exec-id> <step-id>;signadot plan x get-output <exec-id> <name>;signadot plan tag apply <name> --plan <plan-id>。
适用场景:针对 dev/test sandbox 或明确非生产目标创建并运行 plan、调试失败 step、检查输出产物、为可复用 plan 打标签。
限制:schema 优先于本技能;action 为组织范围,仅可引用 status.enabled == true 的 action;plan 不可变,action 更新需新建 plan;step 顺序由依赖决定而非数组顺序;refs 是路径不是表达式;drill-in 需要 schema 且运行时值为 JSON;routingContext 与 spec.cluster 不同;执行至少一次,action 代码应幂等;对生产或共享目标运行前需先询问;不得在规格或摘要中包含 secret 值。