工艺材质列表查询

解决的核心问题

海外运营平台工艺后台维护中，工艺材质列表查询常嵌套在多步骤流程里：人工拼接查询参数、维护登录态头、处理租户权限，容易出现参数结构混乱、鉴权头重复拼接或环境地址被误改的情况。上层Agent若直接调用接口，需反复处理参数路由和错误透传，难以标准化复用单一查询动作。

工作原理与核心能力

本技能以原子化设计锁定单一接口动作craft_material_page，通过固定规则降低调用复杂度：

• 环境强约束：执行器直接使用frontmatter中的正式环境地址https://www.kutetailor.com/api/craft/craft-material/page，不接受用户输入覆盖base_url，避免测试/生产环境混淆。
• 参数嵌套规范：所有调用参数统一封装在params对象内，Path参数写入params.path、Query参数写入params.query、JSON Body写入params.body，禁止使用点号作为顶层Key，确保参数结构清晰可追溯。
• 鉴权自动适配：通过params.accessToken生成Authorization: Bearer头，若传入值已含Bearer前缀则不重复拼接，减少人工处理鉴权逻辑的出错概率。
• 错误透传机制：接口返回认证、权限、参数或业务错误时，原始错误码和信息直接传递给上层Agent，便于快速定位问题层级。

适用边界与注意点

• 非独立业务闭环：仅完成工艺材质列表查询这一原子动作，若需完整业务链路（如新增材质→更新列表→同步库存），需由上层Agent按聚合skill或计划文档编排多个原子技能。
• 参数结构强制要求：必须严格遵循params嵌套规则，若误将参数写成params.query.pageSize这类点号结构，可能导致接口调用失败。
• 数据真实性约束：返回结果仅以接口响应为事实来源，禁止补造未返回的库存、价格、订单号等字段，避免数据失真影响上层决策。