跳到主要内容

技能系统

📖 适合谁:全员 —— 想把团队 SOP、最佳实践、踩过的坑封装成可复用操作手册,让 AI 跨任务调用的人

📖 阅读时长:4 分钟

📖 一句话:YingClaw 的可复用过程化知识模块 —— 把团队的固定流程、踩过的坑、最佳实践封装成「触发条件 + 操作步骤 + 常见陷阱 + 验证方法」的 4 步标准结构,任何会话都可自动激活或显式调用。技能与代码插件互补:插件补充 AI 能力(执行 Shell / 读写文件 / 调 API),技能传授 AI 流程(什么时候做、怎么做、踩什么坑、怎么验证)。对话中通过自然语言(「按 XX 技能做」)或显式调用 skill_create / skill_patch / skill_read 工具触发,全员可访问,存 workspace/skills/<技能名>/SKILL.md,可发布到技能市场与社区共享。

一、核心价值​

价值说明
可复用一次编写多次调用 — 团队 SOP 不再口头相传,封成技能自动执行
4 步标准结构触发条件 + 操作步骤 + 常见陷阱 + 验证方法 — 缺一不可,可重复、可验证
知识沉淀把"踩过的坑"和"做事的最佳顺序"沉淀为团队资产,新人入职就能用
可加密可分享敏感技能加密存储;通用技能发布到 技能市场 社区共享

二、主要能力​

1. 技能 4 部分标准结构​

部分作用示例
触发条件什么时候该用"用户说'自动登录 CSDN 发文章'时触发"
操作步骤具体怎么做(带命令/代码)"Step 1: 打开浏览器;Step 2: ...;Step 3: 提交"
常见陷阱容易踩的坑 + 怎么避"登录验证码可能失效,失败重试 3 次"
验证方法怎么确认成功"检查博客列表是否出现新文章"

4 部分缺一不可 — 缺"触发"用不上,缺"步骤"不可执行,缺"陷阱"踩坑率高,缺"验证"不知道做对没。

2. 技能创建​

  • 用 skill_create 工具,name 必须小写字母+数字+连字符(bid-generator)
  • 必填:name / description / content / 可选 tags
  • 自动生成 workspace/skills/<name>/SKILL.md + .agent_created 标记
  • 触发条件写在 description 字段(便于自动激活)
skill_create(
  name="csdn-auto-publish",
  description="CSDN 自动登录发布文章 — 触发条件:用户请求自动发 CSDN 博客",
  content="## 触发条件\n...\n## 操作步骤\n...\n## 常见陷阱\n...\n## 验证方法\n...",
  tags=["auto-publish", "blog", "csdn"]
)

3. 技能存储与组织​

  • 路径:workspace/skills/<技能名>/SKILL.md(+ 可选 scripts/ 资源)
  • 管理:skill_read 查看 / skill_patch 修改 / skill_delete 删除
  • 可加密:敏感技能用加密存储,skill_file_read 自动解密;不可手动修改加密技能,必须先解密

4. 技能调用(自动 + 显式)​

  • 自动激活:用户请求匹配技能描述时,YingClaw 自动加载
    • 例:"按 CSDN 自动发布技能发一篇文章" → 自动加载 csdn-auto-publish
  • 显式调用:对话中直接说"用 XX 技能做 Y"
    • 例:"用 intelliyou-docs-manager 技能推送 master"
  • 技能组合:复杂任务可同时激活多个技能,按依赖顺序串行执行

5. 技能市场(社区共享)​

  • 技能市场 是 YingClaw 的 社区技能商店
  • 通用技能(CSDN 自动发布、Excel 对比、CRM 操作)由社区贡献
  • 浏览 / 搜索 / 安装 / 评分一站式
  • 企业版支持 私有市场(公司内部技能共享,不对外)

6. 技能更新与迭代​

  • skill_patch 修改已有技能:步骤优化、补充新坑、修正错误
  • 触发"踩坑 → 更新"循环:实际任务遇到新问题,补到"常见陷阱"章节
  • 支持 append 模式 或全量替换,修改后立即生效

7. 技能 vs 插件(关键区别)​

维度代码插件(Plugin)技能(Skill)
形态代码模块(Python/Node)知识文档(SKILL.md)
作用扩展 AI 能做什么教授 AI 怎么做
典型Shell 工具、文件读写、API 调用CSDN 自动发布、CRM 操作 SOP
关系互补不互斥 — 技能可调用插件完成步骤,插件提供底层能力

简单记:插件是手脚(执行),技能是大脑(编排)。

8. 技能加密与安全​

  • 敏感技能(公司 API / 内部凭据 / 专有流程)加密存储,文件名乱码
  • skill_file_read 自动解密,正常使用无感
  • 团队共享时只给"调用权限"不给"修改权限",防止误改

三、典型应用场景​

场景 1:内容运营自动化 —「按 CSDN 自动发布技能发一篇文章」​

"用 csdn-auto-publish 技能把这篇 markdown 发到 CSDN 博客"
→ 加载技能 → 步骤:打开浏览器 → 登录 → 富文本编辑器 → 粘贴 markdown → 提交
→ 验证:检查博客列表是否出现新文章

重复性内容运营(多平台发文、自动抓数据)封成技能,效率提升 5-10 倍。

场景 2:业务系统操作 —「用 CRM 需求管理技能录入新需求」​

"用 crm-requirement-mgmt 技能把新需求录到 CRM"
→ 步骤:打开 CRM → 需求管理 → 新建 → 填字段(标题/描述/优先级/责任人) → 保存
→ 陷阱:优先级是下拉框,必须选"中"(不要默认"低")
→ 验证:搜索标题,确认新需求出现

企业内部系统操作(CRM/工单/财务/HR)沉淀为技能,新人入职一键执行。

场景 3:数据分析 —「用 Excel 多平台对比技能做竞品分析」​

"用 excel-multi-platform-compare 技能对比京东/天猫/拼多多的手机价格"
→ 步骤:爬 3 平台数据 → 写 Excel → 多 sheet 对比 → 生成图表
→ 验证:Excel 3 sheet 数据完整 + 图表渲染正常

重复性数据任务(竞品分析、报表生成、数据清洗)用技能固化,一键产出专业结果。

场景 4:团队知识沉淀 —「把 SOP 写成技能」​

"我们团队的'客户投诉处理流程'是标准 SOP,写成技能让新人也能用"
→ skill_create(name="complaint-handling-sop", content="4 步结构...")
→ 所有团队成员会话自动可用,新人入职当天上手

团队 SOP 数字化 — 口口相传容易丢,封装成技能永不丢失且可执行。

场景 5:内部流程封装 —「用 intelliyou-docs-manager 推送 master」​

"用 intelliyou-docs-manager 技能把改好的文档推到 master"
→ 步骤:frontmatter 自检 → git add → commit → push → 查 CI
→ 陷阱:frontmatter 字段不能有反引号,会被 YAML 解析失败
→ 验证:GitLab pipeline status = success

复杂多步流程(推送代码、部署服务、生成报告)用技能固化,避免每次重新想步骤。

四、使用指南​

第 1 步:用现有技能 — 对话中说"用 XX 技能做 Y",YingClaw 自动加载并执行;任务描述匹配技能描述时也会自动激活。

第 2 步:创建自己的技能 — 用 skill_create(name, description, content, tags):name 小写连字符;description 写清"做什么 + 何时用";content 是 4 步结构;tags 便于市场搜索。

第 3 步:更新技能 — 用 skill_patch:踩到新坑补"常见陷阱";步骤优化改"操作步骤";验证改进改"验证方法"。

第 4 步:分享到市场 — 通用技能发布到 技能市场:完善 description + tags、加示例截图、写版本号 + 更新日志。

第 5 步:加密敏感技能 — 创建时设 encrypted=True,自动加密存储。

五、最佳实践​

  • 4 部分缺一不可 — 按 4 步结构写,可读性和可执行性都最强
  • 触发条件要明确 — description 写清"做什么 + 何时用",YingClaw 才能精准自动激活
  • 操作步骤要可执行 — 每步带具体命令/路径/工具调用,不要"打开浏览器然后..."这种模糊描述
  • 常见陷阱要真实 — 写自己真踩过的坑,不是假设的,技能才有价值
  • 验证方法要可量化 — 写"检查 X 是否出现 Y"这种可观察可测试的验证,不要"看效果"这种主观描述
  • 一次只做一件事 — 技能粒度要细("CSDN 自动登录发文"比"内容运营全套"好),便于组合复用
  • 加密敏感技能 — 涉及公司 API、凭据、专有流程的技能必须加密,别明文存
  • 不要把技能当插件写 — 技能是"怎么做"的知识(流程),不是"能做什么"的代码(能力);能写代码解决的不用技能