iac-aliyun-cost

name	iac-aliyun-cost
description	使用专用 ROS 模板询价工具预估 ROS 模板的月度部署费用，支持按需修复和校验模板问题
when_to_use	当需要对阿里云 ROS 模板进行费用预估时
user_invocable	false
conclusion_schema	{"type":"object","required":["monthly_estimate","currency","resources","template_fixed","deployment_parameters","hard_constraint_checks","preview_validation"],"additionalProperties":false,"properties":{"monthly_estimate":{"type":"string","description":"月度费用估算；询价同时返回 OriginalAmount 与 TradeAmount 时，必须同时包含列表价和合同优惠后价格（如 ¥96.80/月（列表价，合同优惠后约¥13.76/月））；询价失败时填 \"询价失败\""},"currency":{"type":"string","enum":"[Truncated]"},"resources":{"type":"array","items":"[Truncated]"},"template_fixed":{"type":"boolean"},"deployment_parameters":{"type":"object","description":"当前已选、已验证或已用于询价并传递给 deploying 的模板参数字典；可由后续选择或部署阶段补充覆盖"},"hard_constraint_checks":{"type":"array","description":"对 candidate.hard_constraints 当前快照中每条约束的结构化验证；complete_step 由代码检查覆盖、比较、参数和证据，通过后才允许结束步骤","items":"[Truncated]"},"preview_validation":{"type":"object","required":"[Truncated]","additionalProperties":false,"description":"ros_preview_template 的结构化成功证明；deploying 仅在模板路径匹配且没有部署参数缺口时跳过例行校验并直接调用 ros_deploy 创建","properties":"[Truncated]","allOf":"[Truncated]"},"missing_deployment_parameters":{"type":"array","description":"PreviewStack 或完整部署仍未补齐的参数及原因；后续选择阶段可补充，deploying 也可继续补齐","items":"[Truncated]"},"parameter_set_summary":{"type":"string"},"fix_summary":{"type":"string"},"error":{"type":"string"},"api_raw_summary":{"type":"string"}}}

ROS 模板成本预估

使用专用 ROS 模板询价工具预估部署费用。

前一步已完成模板校验；本步骤避免在成本预估前重复校验模板。首次询价前必须先尝试按参数推荐流程形成 Preview-Validated Pricing Parameter Set，不得直接跳过 PreviewStack。PreviewStack 不是成本估算的硬门禁；完整部署参数暂时无法自动形成时，仍可用当前已选参数调用 ros_estimate_template_cost，并把缺口留给后续步骤补充。只有在修复或改写模板后，才调用 ros_validate_template 校验改动。

执行流程

1. 解析候选与模板 — 从上下文提取 candidate.name、candidate.resource_intents、candidate.hard_constraints 和模板文件路径/地域；不依赖完整 intent 或 candidate
2. 提取参数 — 从模板 Parameters 中提取所有参数及其默认值
3. 推荐并预览验证询价参数 — 按「询价参数推荐与传递」完成参数推荐与预览验证，不得跳过约束求解直接编造库存值
4. 调用询价工具 — 优先使用 Preview-Validated Pricing Parameter Set；若 PreviewStack 因完整部署参数缺口无法通过，可用当前已选或可用于询价的参数调用 ros_estimate_template_cost
5. 按需修复问题 — 仅当询价失败且错误指向模板问题，或你必须修复/改写模板时，修改模板并写回原文件路径
6. 修改后校验并重新询价 — 调用 ros_validate_template 校验改动；通过后调用 ros_estimate_template_cost 重新询价；失败则修复重试（最多 7 轮）
7. 结构化传递参数 — 在 complete_step.conclusion.deployment_parameters 输出当前已选或已用于询价的参数字典；在 preview_validation 输出预览成功证明；在 missing_deployment_parameters 输出仍未补齐的完整部署参数缺口
8. 输出结果 — 汇总费用并调用 complete_step

按需校验模板

需要修复或改写模板的典型情况：

• 资源属性拼写错误或类型不匹配
• 缺少必要属性（如 VSwitch 缺少 CidrBlock）
• 内置函数使用不当（如 !Ref 引用了不存在的资源）
• Parameters 定义不完整

校验方法：

ros_validate_template(
    template_url="/absolute/path/to/current-template.yml",
    region_id="cn-hangzhou",  # 已有具体地域时传；否则省略使用工具默认地域
)

修改后校验失败时：

1. 分析错误信息，定位问题资源/属性
2. 查阅 references/ 下的参考文件了解正确的属性和参数规范；如仍不确定 → 调用 aliyun_api(product="ros", action="GetResourceType", params={"ResourceType": "<类型>"}) 查询 Schema
3. 修复模板并写回原文件路径（后续部署步骤从此路径读取，不写回会导致后续步骤使用错误模板）
4. 重新校验（最多 7 轮）

模板路径支持本地文件：template_url 可传当前工作目录内的本地路径（如 ./template.yml）。避免将大模板内容直接作为参数传递。

询价参数推荐与传递

缺少 Default 或上下文值时，按 references/template-parameter-recommendation.md 的参数推荐规则求解，并通过 形成 。不要使用 执行 ；本步骤只验证参数与模板可预览，不执行部署确认或 。