编写自定义技能包
工作原理
自定义技能由两类文件构成,全部兼容 Claude Skills 标准:
| 文件 | 必填 | 作用 |
|---|---|---|
SKILL.md | ✅ | 技能定义文件——YAML frontmatter 写名称/描述/参数,正文写 Prompt 主体 |
| 任意附属资源 | 可选 | 模板文件、参考资料、子文件等。打包到 .zip 里 |
上传方式有两种:
.md文件:单文件技能。直接把一份 SKILL.md 拖进上传弹窗。.zip压缩包:复杂技能。.zip根目录必须包含SKILL.md。
上传后系统会自动解析 SKILL.md,提取技能名称、描述、参数等,然后创建草稿。整个解析过程会显示进度("正在解析 xxx..."),解析完成后跳转到技能详情页。
模块组合
SKILL.md 结构
yaml
---
name: contract-redline
display_name: 合同审查(红线清单)
description: 基于法务部 SOP 自动审查合同条款,输出高风险条款清单和修改建议
version: 1.0
inputs:
- name: contract
type: file
description: 待审查的合同文件(PDF / Word / Markdown)
required: true
outputs:
- name: redlines
type: markdown
description: 红线条款清单 + 修改建议
---
# 合同审查 SOP
你是一位资深法务顾问,请按以下顺序审查合同:
## 1. 高风险条款检查(8 项)
- 单方解约条款
- 责任无限连带
- ...
## 2. 付款节奏审查
- ...
## 3. 输出格式
按以下结构输出红线清单:
| 条款编号 | 风险等级 | 原文 | 修改建议 |上传与维护
上传
技能中心 → 顶部「上传技能」→ 拖入 .md 或 .zip → 等待解析 → 进入草稿
重新解析
技能详情页有「重新解析 SKILL.md」按钮——你改了 SKILL.md 之后,重新解析以更新名称/描述/参数
提交审批 / 发布
草稿状态的技能要走管理员审批(如果配置了审批流),审批通过后才能被全员使用
关联岗位
在技能详情页可以关联给指定的岗位——即便不发布全员,也能在某个岗位的对话里调用
兼容 Claude Skills 生态
WinNexo 的技能格式完全兼容 Claude Skills 标准——你已有的 Claude Skills 仓库(GitHub 上有大量开源技能),可以直接 zip 打包后上传,无需任何转换。这意味着:
- 社区生态可直接复用
- 在 Claude Code / Cursor 里写好的 SKILL.md 可平移到 WinNexo
- 同一份 SKILL.md,能跑 Claude,也能跑 WinNexo
