用途:该技能用于在用户希望创建新技能或更新已有技能、以扩展智能体能力时提供指导。技能是模块化、自包含的包,为特定领域或任务提供专业化知识、工作流与工具,相当于让通用智能体具备程序性知识。
主要能力与结构:每个技能由必需的 SKILL.md 与可选的捆绑资源组成。SKILL.md 含 YAML frontmatter(name、description 必填)和 Markdown 正文;资源目录包括 scripts/(可执行代码,要求确定性或反复重写的任务)、references/(按需加载的文档,如数据库模式、API 文档、公司政策)、assets/(输出中使用的模板、图标、字体等,不加载进上下文)。
核心原则:内容简明,仅补充智能体尚不具备的信息;按任务脆弱性设定自由度,高自由度用文本指令,中等用伪代码或带参数脚本,低自由度用固定脚本。采用渐进式披露:元数据始终在上下文,SKILL.md 正文在触发时加载,资源按需加载。SKILL.md 建议控制在 500 行以内,超出则拆分并在正文中说明何时读取各文件;引用保持一层深度,长文件加目录。避免创建 README、安装指南、更新日志等无关文档。技能采用动词开头命名(如 execute-plan、create-report)。默认创建项目本地技能,仅在用户明确要求时创建全局技能。
使用方式:流程为理解具体用例、规划可复用内容、初始化技能、编辑技能、根据实际使用迭代。初始化示例命令:
mkdir -p {{local_skills_path}}/edit-pdf/{scripts,references,assets} cat > {{local_skills_path}}/edit-pdf/SKILL.md << 'EOF'
name: edit-pdf description: TODO - Describe what this skill does and when to use it
Edit PDF
TODO - Add skill instructions here EOF
新增脚本需实际运行测试,删除不需要的示例文件。
适用场景:需要重复执行的多步骤流程、特定文件格式或 API 的操作说明、公司专有知识与业务逻辑、复杂任务的脚本与模板等。
限制:资料未提供具体收费、价格、平台支持、效果数据或安装命令之外的信息,相关内容暂未提供。