一、面试题目请讲解AI Agent Skill 开发规范包含命名规范、文档规范、测试规范、日志规范、监控规范、告警规范、安全规范。二、知识储备1. 命名规范清晰、统一、可维护Skill 命名业务_场景_动作小写下划线见名知意例aftersale_refund_order、hotel_change_dateSkill ID唯一、固定、不重复入参/出参小写下划线禁止拼音、缩写例user_id、order_id、tenant_id版本语义化v1.0.0大改升主版本小改升次版本2. 文档规范开箱即用、可协作必须包含功能说明做什么业务入参列表字段、类型、是否必填、示例出参格式成功/失败结构依赖工具依赖哪些 Tool业务规则可执行条件、禁忌、风险点异常说明常见错误码与文案支持Markdown 可视化流程图3. 测试规范上线前必过单元测试参数正常/异常/空值/边界集成测试Skill 调用、上下文透传、依赖校验异常测试超时、重试、熔断、格式错误、幻觉幂等测试重复调用不重复执行权限测试越权访问必须拦截回归测试版本更新不影响旧流程4. 日志规范可追溯、可排查必须打印skill_id、request_id、user_id、tenant_id入参、出参、执行状态工具调用、异常信息、耗时日志级别INFO 正常、ERROR 异常禁止打印敏感信息密码、手机号、密钥5. 监控规范全链路可观测核心监控指标调用量 QPS成功率 / 异常率执行耗时 P95/P99超时次数、重试次数熔断次数幻觉拦截次数按skill_id tenant_id维度监控6. 告警规范快速响应触发告警异常率 5%P95 延迟 3s连续超时、熔断开启幻觉拦截突增告警方式企业微信、电话、短信分级一般、严重、紧急7. 安全规范企业级强制必做参数校验租户用户权限校验幂等防重超时控制熔断降级禁止越权操作敏感信息日志打印无限制重试高危操作无审核三、代码示例规范模板# 命名规范 def aftersale_refund_order(context): # 日志规范 logger.info( skill_idaftersale_refund_order, request_idcontext.request_id, paramscontext.params ) # 参数校验 if not context.params.get(order_id): raise MissingParamError(order_id is required) # 权限校验 auth.check(context.user_id, context.tenant_id) # 执行业务 result tools.refund(context.params[order_id]) # 监控埋点 monitor.incr(skill_success, tags{skill_id: aftersale_refund_order}) return result四、破局之道面试升华Skill 开发规范的核心目标是可维护、可观测、可追溯、安全稳定。通过统一命名、完善文档、全量测试、标准日志、全方位监控、分级告警、强制安全让 Skill 从“能用”变成“企业级可上线”是 Agent 规模化落地的基础保障。30 秒口述精简版Skill 开发规范包括见名知意的命名、完整的文档、全场景测试、全链路日志、多维度监控、分级告警、安全强制校验目标是让技能稳定、安全、可维护、可观测。