核心机制与工程规范：工具调用原理、错误处理、描述规范与权限安全。
六、Skill 工具调用原理
遵循"思考-行动-观察"的 ReAct 循环：分析状态 → 调用工具 → 接收结果 → 判断是否继续。
Agent 每步需决定：是否需要调用 → 选择哪个工具 → 构造参数 → 评估结果。最困难的是参数构造——从自然语言提取结构化值，处理缺失和类型不匹配。
常见调用模式：
| 模式 | 描述 | 场景 |
|---|---|---|
| 单步调用 | 一次完成 | 读取文件 |
| 循环调用 | 重复调用，参数不同 | 批量读取 |
| 链式调用 | 前输出作为后输入 | 搜索→读取→编辑 |
| 分支调用 | 按条件选择工具 | 按文件类型处理 |
| 并行调用 | 同时调用无依赖工具 | 同时搜索多目录 |
七、Skill 的错误处理与容错
错误处理策略：工具调用失败→检查参数重试；权限不足→请求授权；资源不存在→终止；超时→增加超时重试；结果异常→调整策略。
重试策略：参数校验重试 → 替代方案重试 → 降级处理 → 用户介入。上限通常 2-3 次，网络请求可多试，文件写入失败通常不重试。
错误隔离：一个步骤失败不应导致整个流程崩溃，通过降级处理（跳过、默认值、简化版）让流程继续推进。
八、Skill 的描述规范
能力声明应动词开头、领域明确、范围清晰。触发场景从三个维度枚举：直接意图（明确表达目标）、间接意图（描述问题需推断）、上下文意图（对话历史指代）。
常见反模式：过于宽泛→增加限定；过于狭窄→补充同义词；缺少边界→列出不适用场景；模糊词汇→替换为具体描述。
九、Skill 的权限与安全
三层权限模型：Skill 级（声明工具列表）→ 工具级（文件/网络/命令限制）→ 运行时（用户确认、沙箱隔离、审计日志）。
敏感操作确认：低风险自动执行 → 中风险展示详情确认 → 高风险要求明确授权。
沙箱隔离：文件系统限定目录、网络域名白名单、禁止子进程、仅暴露必要环境变量、设定最大执行时长。
安全审计：操作日志记录、异常行为监控、权限定期审查、漏洞扫描。
下一篇：版本管理、性能优化、开发调试、实例解析与展望
