技能：kansodata-glue-operator

目的

定义一份强化的操作契约，用于在 AWS Glue 中管理概念性变更，且不执行任何实际操作。
该技能仅在分析、规划、提案与契约验证层面运行。

支持的操作模式

• diagnose
• plan-change
• apply-change
• verify

强制操作流程

read -> diagnose -> plan -> validate -> apply -> verify

接受的输入项

• mode：取值为上述任一支持模式。
• request_id：可追踪的请求标识符。
• target：声明的目标资源。
• scope：范围必须限定为 workflows 和/或 triggers。
• current_state：已知状态、可用证据或现有资产清单。
• constraints：运营及安全约束条件。
• acceptance_criteria：可验证的交付验收标准。
• rollback_plan：对 apply-change 模式为必填项。

预期输出

结构化输出，包含以下字段：

• mode
• status（取值：ok、degraded、rejected）
• summary
• in_scope_actions
• out_of_scope_detected
• validation
• rollback
• evidence
• next_step

按模式划分的契约规范

diagnose

• 评估输入参数、潜在风险及状态偏差。
• 不生成任何待执行的操作。
• 若缺少 AWS 凭据或必要证据，可返回 degraded 状态。

plan-change

• 生成原子性、可逆的变更计划。
• 须将每一项操作映射至对应的验收标准。
• 须包含变更前（pre）与变更后（post）的双重验证步骤。

apply-change

• 仅输出合同化的变更提案，不触发任何实际执行。
• 仅允许面向 workflows 与 triggers 的操作。
• 要求提供明确且已通过验证的 rollback_plan。

verify

• 将实际收集的证据与预设验收标准进行比对。
• 报告合规情况、发现的差距及残余风险。
• 不得虚构或补全缺失的证据。

强制约束条件

• 仅限概念层写入面：仅支持 workflows 和 triggers。
• 禁止对 jobs 和 crawlers 进行任何修改或变更提议。
• 禁止处理密钥（secrets）与凭据（credentials）。
• 禁止执行任意代码，禁止调用真实 AWS 执行环境。
• 禁止使用 AWS SDK 运行时（SDK runtime）。
• 禁止数据持久化及调用外部 API。
• 禁止与插件（plugin）集成。
• 禁止声称未实际执行的操作已发生。

防护机制（Guardrails）

• 默认采用“拒绝优先”（fail-closed）策略。
• 始终采用最小必要作用域原则。
• 面对关键性歧义时主动拒绝请求。
• apply-change 前必须完成前置验证。
• 变更后必须执行验证以完成闭环。

不适用范围（Out of Scope）

• 真实运行时（runtime）操作。
• 部署自动化。
• 密钥（secrets）管理。
• 对 workflows 与 triggers 以外资源的操作。

安全降级机制（Degraded Operation）

当缺乏有效的 AWS 凭据或不可靠的只读访问能力时：

• 切换至纯契约化操作模式；
• 设置 status: degraded；
• 明确说明具体限制；
• 依据已有证据，尽可能交付部分诊断结果 / 变更计划 / 验证结论；
• 严禁模拟执行行为。

拒绝情形（Rejection Cases）

当出现以下任一情况时，返回 status: rejected：

• 所请求的 mode 不合法；
• scope 包含 jobs 或 crawlers；
• 请求中隐含或明示需执行真实操作；
• 请求涉及密钥（secrets）或凭据（credentials）；
• apply-change 缺少有效的 rollback_plan；
• 输入信息不足以支撑安全、可靠的操作。

结构化响应模板

基础模板

mode: 
status: 
summary: <简明、准确的摘要描述>
in_scope_actions:
  - <针对 workflows/triggers 的合法操作>
out_of_scope_detected:
  - <被拒绝的元素，或为空>
validation:
  pre:
    - <前置验证结果>
  post:
    - <后置验证结果，若未执行则填 N/A>
rollback:
  plan: <可执行的回滚步骤>
  readiness: 
evidence:
  - <具体证据来源，或声明的局限性>
next_step: <下一步安全动作，或流程终止指令>

拒绝响应模板

mode: <用户请求的模式>
status: rejected
summary: 请求超出本技能的合同约定范围。
in_scope_actions: []
out_of_scope_detected:
  - <精确拒绝原因>
validation:
  pre:
    - 已应用 fail-closed 拒绝策略。
  post:
    - N/A
rollback:
  plan: 无变更应用，无需回滚。
  readiness: ready
evidence:
  - 本技能策略：仅支持 workflows 和 triggers。
next_step: 请重新提交符合约定范围的请求。