Menü
帮助用户创建有效的自定义技能，通过具体用例收集需求并生成 SKILL.md
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
多模态服务指南，包括图片生成、视频生成、语音合成、音乐生成的配置与使用
系统概述，介绍 Protocol Proxy 的定位、核心能力和典型使用场景
供应商管理指南，包括创建供应商、配置 API Key、密钥轮换
监控与日志指南，包括用量统计、请求日志、系统日志查看
智控助手使用指南，包括对话、技能管理、斜杠命令、快捷键
MCP 服务配置指南，包括添加、连接、排查 MCP 服务器
Basierend auf der SOC-Berufsklassifikation
| name | create-skill |
| description | 帮助用户创建有效的自定义技能，通过具体用例收集需求并生成 SKILL.md |
| trigger | 用户要求创建技能、新建 skill、帮我写一个技能、我想有个技能能帮我做 X、怎么创建技能 |
本技能帮助用户创建有效的自定义技能。
技能是模块化的指令包，通过提供专业化的操作流程、工具调用指令和领域知识，将通用 AI 转变为特定任务的专家。技能就像特定领域的"入职指南"——将程序性知识注入 AI，使其具备模型本身无法完全掌握的实操能力。
每个技能由必需的 SKILL.md 文件和可选的配套资源组成：
skill-name/
├── SKILL.md ← 必需
│ ├── YAML 元数据（必需）
│ │ ├── name:（必需）
│ │ ├── description:（必需）
│ │ └── trigger:（可选）
│ └── Markdown 指令内容（必需）
└── 配套资源（可选）
├── scripts/ — 可执行脚本（Python/Bash 等）
├── references/ — 按需加载的参考文档
└── assets/ — 输出中使用的文件（模板、图标等）
元数据质量：name 和 description 决定了 AI 何时使用该技能。描述要具体说明技能做什么、何时使用。使用第三人称（如"该技能用于..."）。
触发条件：trigger 用自然语言描述技能的适用场景，帮助 AI 判断用户请求是否匹配。多个条件用中文逗号分隔，覆盖用户可能的不同说法，但不要过于宽泛。
scripts/)需要确定性执行或反复重写的可执行代码。
scripts/export_csv.py 数据导出脚本references/)AI 在执行过程中按需读取的文档。
references/api_docs.md API 规格文档assets/)不需要读入上下文、只在输出中使用的文件。
assets/report_template.md 报告模板技能采用三级加载机制，按需占用上下文：
| 层级 | 内容 | 何时加载 | 大小 |
|---|---|---|---|
| 第一层 | 元数据（名称 + 描述 + 触发条件） | 始终在系统提示词中 | ~100 字 |
| 第二层 | SKILL.md 正文（指令内容） | 技能触发时 | <5000 字 |
| 第三层 | 配套资源（脚本、参考文档） | AI 按需读取 | 不限 |
脚本可以直接执行而无需读入上下文，因此第三层不受限制。
| 分类 | 存放位置 | 说明 |
|---|---|---|
| 系统 | skills/system/ | 内置技能，不可删除和编辑 |
| 预设 | skills/preset/ | 预装技能，可删除但不可编辑 |
| 用户 | ~/.protocol-proxy/skills/ | 用户自定义技能，可自由编辑和删除 |
通过智控助手面板创建的技能属于用户分类。
要创建一个技能，按顺序执行以下步骤，除非有明确理由跳过某步。
仅当技能的使用场景已经非常清晰时才跳过此步。即使在迭代已有技能时，此步仍有价值。
要创建有效的技能，需要清楚理解技能将如何被使用的具体用例。这些用例可以来自用户的直接描述，也可以由 AI 生成后由用户验证。
例如，创建一个"日志分析"技能时，相关问题包括：
为避免让用户应接不暇，不要一次问太多问题。先问最重要的，按需追问。
当对技能要支持的功能有了清晰认知时，结束此步。
要将具体用例转化为有效的技能，对每个用例进行分析：
示例：创建 pdf-editor 技能处理"帮我旋转这个 PDF"：
scripts/rotate_pdf.py 中存储旋转脚本会有帮助示例：创建 frontend-webapp-builder 技能处理"帮我建个 todo 应用"：
assets/hello-world/ 中存储样板项目会有帮助示例：创建 big-query 技能处理"今天有多少用户登录"：
references/schema.md 中记录表结构会有帮助通过分析每个用例，确定要包含的可复用资源清单：脚本、参考文档和模板。
此时开始实际创建技能。
如果是新建技能，在智控助手中通过技能面板创建：
创建后可在技能面板中点击技能名称进行编辑。通过面板创建的技能属于用户分类。
如果需要包含配套资源（scripts/references/assets），需要手动在 ~/.protocol-proxy/skills/<skill-name>/ 目录下创建对应子目录和文件。
编辑技能时，记住这个技能是为另一个 AI 实例使用的。重点包含对 AI 有益且非显而易见的信息。考虑哪些程序性知识、领域细节或可复用资源能帮助另一个 AI 实例更有效地执行任务。
从第一步规划的可复用资源开始：scripts/、references/ 和 assets/ 文件。注意这一步可能需要用户提供输入。例如，创建 brand-guidelines 技能时，用户可能需要提供品牌素材存到 assets/，或文档存到 references/。
同时，删除技能中不需要的示例文件和目录。
写作风格：整个技能使用祈使语气（动词开头的指令），不用第二人称。使用客观的指令式语言（如"要完成 X，执行 Y"而不是"你应该做 X"或"如果需要 X 的话"）。这保证了 AI 消费时的一致性和清晰度。
要完成 SKILL.md，回答以下问题：
在技能中可以指示 AI 调用以下工具。MCP 工具也可以在技能中引用，AI 会自动调用。
| 工具 | 用途 |
|---|---|
get_system_status | 获取系统状态概览 |
check_health | 系统健康检查 |
get_providers | 获取所有供应商 |
get_provider | 获取单个供应商详情 |
get_proxies | 获取所有代理 |
get_proxy | 获取单个代理详情 |
get_key_health | 获取密钥健康状态 |
get_usage_stats | 获取用量统计 |
get_recent_requests | 获取最近请求日志（支持按代理/状态/模型过滤） |
get_system_logs | 获取系统日志 |
get_settings | 获取系统设置 |
get_config_history | 获取配置版本历史 |
test_provider_keys | 测试供应商密钥连通性 |
get_provider_models | 获取供应商可用模型列表 |
| 工具 | 用途 | 权限 |
|---|---|---|
read_file | 读取文件内容 | 只读 |
list_directory | 列出目录内容 | 只读 |
search_files | 按 glob 模式搜索文件 | 只读 |
grep_search | 按正则搜索文件内容 | 只读 |
write_file | 写入文件 | 需审批 |
edit_file | 精确替换文件内容 | 需审批 |
execute_command | 执行系统命令 | 需审批 |
| 工具 | 用途 |
|---|---|
create_provider | 创建供应商 |
update_provider | 更新供应商配置 |
delete_provider | 删除供应商 |
| 工具 | 用途 |
|---|---|
create_proxy | 创建并启动代理 |
update_proxy | 更新代理配置 |
delete_proxy | 删除代理 |
start_proxy | 启动代理 |
stop_proxy | 停止代理 |
start_all_proxies | 启动所有代理 |
stop_all_proxies | 停止所有代理 |
| 工具 | 用途 |
|---|---|
get_mcp_servers | 列出 MCP 服务及状态 |
add_mcp_server | 添加 MCP 服务 |
update_mcp_server | 更新 MCP 服务 |
delete_mcp_server | 删除 MCP 服务 |
connect_mcp_server | 连接 MCP 服务 |
disconnect_mcp_server | 断开 MCP 服务 |
get_mcp_tools | 列出已连接 MCP 服务的工具 |
| 工具 | 用途 |
|---|---|
get_skills | 列出所有技能 |
create_skill | 创建新技能 |
update_skill | 更新技能 |
delete_skill | 删除技能 |
invoke_skill | 调用技能获取指令 |
| 工具 | 用途 |
|---|---|
get_memory | 查看所有记忆（含人设） |
save_memory | 保存记忆条目 |
read_memory | 读取二级记忆条目详情 |
edit_memory | 编辑或删除记忆条目 |
search_memory | 按关键词搜索记忆条目 |
update_soul | 更新智能体人设（SOUL.md） |
| 工具 | 用途 |
|---|---|
export_config | 导出系统配置 |
import_config | 导入配置（合并/覆盖） |
rollback_config | 回滚到历史配置版本 |
reconstruct_config | 通过回溯差异链重建指定配置版本 |
get_config_diff | 比较两个配置版本之间的差异 |
update_settings | 更新系统设置 |
trigger_key_health_check | 手动触发密钥健康检查 |
| 工具 | 用途 |
|---|---|
delegate_task | 委派子任务给子代理并行执行 |
list_agents | 列出所有可用的代理身份 |
list_tasks | 列出子任务（可按状态筛选） |
get_task | 获取子任务详情 |
stop_task | 终止运行中的子任务 |
message_task | 向已完成或失败的子任务追加消息 |
| 工具 | 用途 |
|---|---|
list_conversations | 列出所有历史会话 |
delete_conversation | 删除指定会话 |
clear_conversation | 清空会话消息历史 |
| 工具 | 用途 |
|---|---|
get_exec_policy | 获取当前执行策略概览 |
test_exec_policy | 测试命令在当前策略下的决策结果 |
技能创建完成后，需要验证其是否按预期工作：
/技能名，检查 AI 是否按指令执行、输出是否符合模板/），测试触发条件是否精准匹配如果验证失败，回到第四步修改 SKILL.md，然后再次验证。
用户测试技能后可能会要求改进。通常这发生在刚使用完技能之后，此时对技能的表现有最新鲜的感受。
迭代流程：