
Skill
Skill的目录
text
my-skill/
├── SKILL.md # 技能主文件(必需)
├── scripts/ # 可执行脚本目录(可选)
│ ├── main.py # 主逻辑脚本
│ ├── helper.sh # 辅助shell脚本
│ └── requirements.txt # Python依赖(如适用)
├── references/ # 参考资料目录(可选)
│ ├── api_docs.md # API文档
│ ├── guides/ # 指南子目录
│ │ ├── quickstart.md
│ │ └── troubleshooting.md
│ └── data/ # 参考数据
│ ├── mapping.json
│ └── templates.yaml
├── assets/ # 静态资源目录(可选)
│ ├── images/ # 图片资源
│ │ ├── logo.png
│ │ └── diagrams/
│ ├── fonts/ # 字体文件
│ ├── templates/ # 模板文件
│ │ ├── report_template.docx
│ │ └── email_template.html
│ └── configs/ # 配置文件
│ └── default_config.json
├── tests/ # 测试目录(可选)
│ ├── test_skill.py
│ └── fixtures/ # 测试数据
│ └── sample_inputs.json
├── docs/ # 详细文档(可选)
│ ├── README.md # 使用说明
│ ├── CHANGELOG.md # 版本变更记录
│ └── architecture.md # 架构设计文档SKILL.md 文件结构详解
SKILL.md 是技能的核心,标准格式如下:
markdown
---
name: your-skill-name
description: 简要描述技能功能(1-2句话)
version: 1.0.0
author: your-name
triggers:
- 关键词1
- 关键词2
permissions:
- read_files
- execute_scripts
---
# 技能标题
## 用途
详细说明这个技能解决什么问题,在什么场景下使用。
## 指令
给 AI 的具体行为指令,定义:
- 角色定位
- 处理流程
- 输出格式要求
- 边界和限制
## 示例
### 输入示例 1
用户可能这样提问...
### 输出示例 1
AI 期望的回复...
## 可调用的脚本
列出 `scripts/` 目录中可用的脚本及其用途:
- `scripts/main.py`:主要处理逻辑
- `scripts/helper.sh`:辅助功能
## 参考资源
说明 `references/` 和 `assets/` 中的可用资源,以及何时使用它们。
## 注意事项
- 使用限制
- 环境依赖
- 已知问题Skill打包提示词
text
我们刚才的对话已经磨合出了完整的工作流程和输出标准。
请现在将这个过程整理成一个标准的Agent Skill,要求如下:
1.创建完整的Skil文件夹结构
2.SKILL.md写清楚:Skill职责、触发场景、执行步骤、输出标准
3.references放入我们确认过的所有格式要求和内容标准
4.可自动化的步骤写入scripts
5.assets放入需要复用的模板文件
输出一个我可以直接安装使用的Skil文件夹
