AI 简明手册Skill：让 Agent 少走弯路
定义
Skill 是按任务加载的操作手册，说明何时启用、可用哪些工具、按什么步骤执行以及怎样验收。它把重复经验从一次性提示词中抽出来，便于复用、评审和版本管理。
说明
Skill 常以 Markdown 等可读文件保存。支持这种约定的 Agent 在任务匹配时读取相应手册，而不是把所有流程长期塞进全局 System Prompt。文件名、目录和触发机制由具体产品决定。
适合沉淀为 Skill 的任务通常高频、步骤相对稳定，且有清楚的成功标准，例如发布、故障排查或生成固定格式的报告。一次性探索或边界不断变化的任务不必急着固化。
一份可维护的 Skill 应写清触发条件、前置检查、允许与禁止的工具、执行步骤、失败处理和验收方式。只写理想流程而不写退出条件，Agent 仍可能在失败时反复尝试。
System Prompt 管长期身份和全局约束，工具定义说明能做什么，Skill 说明某类任务怎样做。三者职责不同，不能用 Skill 替代操作系统权限或服务端鉴权。
流程、依赖或工具变化后要同步更新 Skill，并用真实任务回归。它的价值来自可验证的行为一致性，而不是文件数量。
边界与误区
Skill 和普通提示词有什么区别： 普通提示词通常只是单次请求中的指令；Skill 是独立维护的操作手册，按任务触发自动加载，并明确规定了步骤、工具和边界，可以在多个会话中复用。
如何判断一个任务值得写成 Skill： 高频、步骤相对固定、出错成本高或希望统一执行规范的任务最适合沉淀为 Skill。一次性操作或高度不稳定的任务通常不需要专门维护手册。
Skill 文件里需要写代码吗： 核心通常是可读的任务说明，不要求写代码；某些产品允许附带脚本、模板或资源，是否需要取决于任务和运行时。