Skip to content

Skills 技能系统

版本: v5.0.1 | 138内置技能 | Agent Skills开放标准 | 统一工具注册表

Skills 系统提供 138 个内置技能,使用 Markdown 定义技能(SKILL.md),支持四层加载、Agent Skills 开放标准(13扩展字段)、门控检查和自定义命令。v1.2.1 研究社区技能生态补充6个高频技能(brainstorming/debugging-strategies/api-design/frontend-design/create-pr/doc-coauthoring),Handler 覆盖率 138/138 (100%)。

核心特性

  • 🛠️ 138 内置技能: 覆盖开发、测试、自动化、知识、安全、DevOps 等 18 个类别,100% Handler 覆盖
  • 📄 Markdown 技能定义: 使用 SKILL.md 格式声明提示词、工具集、参数和门控检查
  • 📦 四层加载机制: workspace > managed > marketplace > bundled 优先级覆盖
  • 🔌 统一工具注册表: 聚合 FunctionCaller (60+)、MCP (8 servers)、Skills (50) 三大工具系统
  • 🔒 门控检查: 平台、二进制依赖、环境变量和自定义检查,确保安全执行
  • 🧩 Agent Skills 标准: 13 个扩展字段,支持技能发现、组合和远程调用

系统架构

┌──────────────────────────────────────────┐
│              Skill System                │
│  ┌─────────┐  ┌───────────┐  ┌────────┐ │
│  │ Loader  │  │ Executor  │  │ Parser │ │
│  │ (4层)   │  │ (Handler) │  │ (YAML) │ │
│  └────┬────┘  └─────┬─────┘  └───┬────┘ │
│       │             │            │       │
│  ┌────▼─────────────▼────────────▼────┐  │
│  │       Skill Registry (138)         │  │
│  └────────────────┬───────────────────┘  │
│                   │                      │
│  ┌────────────────▼───────────────────┐  │
│  │     Unified Tool Registry          │  │
│  │  FunctionCaller + MCP + Skills     │  │
│  └────────────────┬───────────────────┘  │
└───────────────────┼──────────────────────┘

       ┌────────────┼────────────┐
       │            │            │
  ┌────▼────┐ ┌────▼────┐ ┌────▼────┐
  │ Gate    │ │ IPC     │ │ Agent   │
  │ Checks  │ │ (17ch)  │ │ Skills  │
  └─────────┘ └─────────┘ └─────────┘

系统概述

技能是什么

技能是预定义的 AI 能力模板,封装了特定任务的:

  • 提示词 - AI 的行为指导
  • 工具集 - 允许使用的工具 (通过 tools 字段声明)
  • 参数 - 可配置的选项 (通过 input-schema 定义)
  • 门控 - 执行条件检查
  • 指南 - 使用说明 (通过 instructions 字段)
  • 示例 - 使用示例 (通过 examples 字段)

基础技能 (30)

类别技能Handler说明
开发/code-review代码审查
开发/git-commit智能提交
开发/test-generator测试生成
开发/performance-optimizer性能优化
学习/explain-code代码解释
自动化/browser-automation浏览器自动化
自动化/computer-use桌面操作
自动化/workflow-automation工作流自动化
数据/web-scraping网页数据抓取
数据/data-analysis数据分析
知识/memory-management记忆管理
知识/smart-search智能搜索
远程/remote-control远程控制
安全/security-audit安全审计
DevOps/devops-automationDevOps自动化
开发/repo-map代码库结构映射
开发/refactor多文件代码重构
文档/doc-generator文档自动生成
测试/api-testerAPI/IPC测试
开发/onboard-project项目入门分析
开发/lint-and-fixLint自动修复
测试/test-and-fix测试自动修复
分析/dependency-analyzer依赖分析
数据库/db-migration数据库迁移
开发/project-scaffold项目脚手架
DevOps/env-doctor环境诊断
知识/context-loader智能上下文
安全/vulnerability-scanner漏洞扫描
DevOps/release-manager发布管理
开发/mcp-server-generatorMCP服务器生成

高级技能 v0.36.1 (10)

类别技能Handler说明
开发/architect-mode双阶段架构模式
测试/bugbot主动Bug检测
开发/commit-splitter智能提交拆分
开发/diff-previewer差异预览器
测试/fault-localizer故障定位器
分析/impact-analyzer变更影响分析
知识/research-agent技术研究代理
开发/rules-engine规则引擎
开发/screenshot-to-code截图转代码
开发/task-decomposer任务分解器

AI 会话增强 + 开发效率 v0.36.2 (10)

类别技能Handler说明
AI/prompt-enhancer提示词增强
知识/codebase-qa代码库语义问答
AI/auto-context智能上下文检测
AI/multi-model-router多模型路由
开发/code-translator跨语言转换
开发/dead-code-eliminator死代码检测
开发/changelog-generatorChangelog生成
开发/mock-data-generator模拟数据生成
分析/git-history-analyzerGit历史分析
开发/i18n-manager国际化管理

Office文档 + 音视频 v0.37.3 (10)

类别技能Handler说明
文档/pdf-toolkitPDF处理工具箱
文档/doc-converter万能格式转换
文档/excel-analyzerExcel深度分析
文档/pptx-creator演示文稿生成
文档/doc-comparator文档对比
媒体/audio-transcriber语音转文字
媒体/video-toolkit视频操作工具箱
媒体/subtitle-generator字幕生成
媒体/tts-synthesizer文本转语音
媒体/media-metadata媒体元数据

图像+数据+工具 v0.37.4 (10)

类别技能Handler说明
媒体/image-editor图片编辑处理
媒体/ocr-scannerOCR文字识别
AI/image-generatorAI图像生成
数据/chart-creator数据可视化图表
文档/word-generatorWord文档生成
数据/csv-processorCSV数据处理
开发/template-renderer模板渲染引擎
开发/code-runner安全代码执行
自动化/voice-commander语音命令管理
工具/file-compressor文件压缩解压

开发效率+系统工具 v0.37.5 (10)

类别技能Handler说明
开发/json-yaml-toolkitJSON/YAML处理
开发/regex-playground正则表达式工具
运维/log-analyzer日志分析
运维/system-monitor系统监控
开发/http-clientHTTP客户端
文档/markdown-enhancerMarkdown增强
开发/snippet-library代码片段库
知识/knowledge-graph知识图谱
工具/clipboard-manager剪贴板管理
运维/env-file-manager环境变量管理

系统+安全+设计+分析 v0.37.6 (10)

类别技能Handler说明
系统/backup-manager数据备份恢复
知识/query-enhancerRAG查询优化
知识/memory-insights知识库分析
数据/data-exporter多格式数据导出
安全/crypto-toolkit加密哈希编码
运维/network-diagnostics网络诊断工具
安全/password-generator密码Token生成
工具/text-transformer文本编解码转换
设计/color-picker颜色调色板工具
运维/performance-profiler性能分析基准

v1.2.0 外部标准 + 实用技能 (22)

类别技能Handler说明
搜索/tavily-searchTavily API联网搜索
搜索/find-skills技能注册表搜索发现
自动化/proactive-agent4种自主触发器
浏览器/agent-browser快照引用模式浏览器自动化
媒体/remotion-videoReact/Remotion视频创作
自动化/cron-schedulerCron+自然语言定时调度
协作/planning-with-filesManus 3文件规划工作流
协作/content-publisher5种内容类型发布
协作/skill-creator元技能:创建/测试/验证技能
测试/webapp-testing侦察-执行模式Web测试
知识/deep-research8阶段深度研究流水线
开发/git-worktree-managerGit Worktree管理
代码审查/pr-reviewergh CLI PR审查分析
DevOps/docker-compose-generator10种服务模板Docker Compose
DevOps/terraform-iacAWS/GCP/Azure HCL生成
文档/api-docs-generatorOpenAPI 3.0自动生成
知识/news-monitorHackerNews API趋势检测
知识/ultrathink7步扩展推理框架
知识/youtube-summarizerYouTube字幕摘要+章节分段
数据库/database-querySQL生成/优化/Schema内省
DevOps/k8s-deployerK8s清单+Helm Chart+安全检查
DevOps/cursor-rules-generator5种AI编码助手配置

v1.2.0 集成与生产力技能 (10)

类别技能Handler说明
自动化/api-gateway100+ API统一接口/链式调用
系统/free-model-managerOllama/HuggingFace免费模型管理
开发/github-managerIssues/PR/仓库/Workflows管理
工具/google-workspaceGmail/Calendar/Drive集成
工具/humanizer去除AI写作痕迹/语气调整
工具/notionNotion页面/数据库/内容管理
知识/obsidianObsidian笔记/搜索/标签/双链
系统/self-improving-agent错误追踪/模式分析/自我改进
知识/summarizerURL/PDF/YouTube/文本万能摘要
工具/weather全球天气/预报/告警

v1.2.1 社区生态补充技能 (6)

类别技能Handler说明
通用/brainstorming创意头脑风暴(自由思考/思维导图/SWOT/六顶帽/SCAMPER)
开发/debugging-strategies系统调试策略(诊断/二分法/追踪/假设/小黄鸭/根因/红旗/防御/会话)
开发/api-designAPI设计(RESTful设计/审查/OpenAPI/版本策略/错误码)
设计/frontend-design前端设计(组件/布局/响应式/无障碍/主题)
开发/create-prPR创建(创建/草稿/模板/Changelog)
文档/doc-coauthoring文档协作(初稿/扩展/审查/结构重组/术语表)

Cowork协作演化 v1.0.0 (5)

类别技能Handler说明
协作/debate-review多视角代码评审(性能/安全/可维护性)
协作/ab-compare多智能体方案A/B对比与基准测试
协作/orchestrate工作流编排(feature/bugfix/refactor/security-audit)
协作/verification-loop验证循环(Build→TypeCheck→Lint→Test→Security→DiffReview)
协作/stream-processor流式数据处理(log/csv/json逐行处理)

安全/系统/示例技能 (4)

类别技能Handler说明
安全/zkp-toolkit零知识证明工具(证明生成/验证/选择性披露/ZK-Rollup/基准测试)
系统/handler-test-skillHandler测试技能(内置开发调试/Handler契约验证用)
示例/my-custom-skill自定义技能示例(用户自定义技能参考模板)
开发/test-skill测试技能(单元测试示例/技能框架测试用途)

四层加载

加载优先级

workspace/     # 工作区技能(最高优先级)

managed/       # 用户管理的技能

marketplace/   # 插件市场安装的技能 (v0.34.0新增)

bundled/       # 内置技能(138个,100% Handler覆盖,最低优先级)

高层技能可以覆盖低层同名技能。

技能目录

.chainlesschain/skills/          # 工作区技能
~/.chainlesschain/skills/        # 用户技能
<marketplace>/skills/            # 插件市场技能
<app>/skills/builtin/            # 内置技能 (138个)

技能定义格式

Markdown 技能文件

markdown
---
name: code-review
description: 执行代码审查,提供改进建议
version: 1.0.0
author: ChainlessChain Team
---

# Code Review 代码审查

## 门控检查

- platform: ["darwin", "linux", "win32"]
- binary: git
- env: GITHUB_TOKEN (optional)

## 参数

- `file` (required): 要审查的文件路径
- `focus` (optional): 审查重点 (security|performance|style)
- `severity` (optional): 最低报告级别 (info|warning|error)

## 工具

- Read
- Glob
- Grep

## 提示词

你是一个专业的代码审查员。请审查提供的代码,关注以下方面:

1. **代码质量** - 可读性、可维护性、命名规范
2. **潜在问题** - bug、边界情况、错误处理
3. **性能** - 算法效率、资源使用
4. **安全** - 常见漏洞、敏感信息处理
5. **最佳实践** - 设计模式、代码组织

请提供具体的改进建议,包括代码示例。

内置技能

开发类技能

bash
/code-review src/auth/login.js          # 代码审查
/code-review src/ --focus=security      # 安全审查

/git-commit                              # 智能提交
/explain-code src/utils/crypto.js        # 代码解释
/test-generator src/services/user.js     # 生成测试
/performance-optimizer src/api/          # 性能优化

自动化类技能 (可执行Handler)

bash
/browser-automation                      # 浏览器自动化
  # 导航、点击、输入、表单填充、截图、数据提取

/computer-use                            # 桌面操作
  # 桌面截图、坐标点击、键盘输入、视觉AI

/workflow-automation                     # 工作流自动化
  # 条件分支、循环、并行执行、子工作流

知识与数据类技能 (可执行Handler)

bash
/memory-management                       # 记忆管理
  # 保存笔记、搜索知识、查看日志、提取洞察

/smart-search                            # 智能混合搜索
  # 向量60% + BM25 40% 混合搜索

/web-scraping                            # 网页数据抓取
  # 表格、链接、文本提取

/remote-control                          # 远程设备控制
  # 命令、文件传输、剪贴板同步

安全与运维类技能

bash
/security-audit src/                     # 安全审计 (OWASP)
/devops-automation                       # CI/CD自动化
/data-analysis data.csv                  # 数据分析

统一工具注册表 (v0.36.0新增)

概述

统一工具注册表 (UnifiedToolRegistry) 聚合三大工具系统:

工具系统工具数说明
FunctionCaller60+内置工具 (文件/代码/Git/Office等)
MCP8 servers社区MCP服务器
Skills50内置技能Handler注册的工具

自动技能映射

  • SkillMdParser: 解析SKILL.md中的tools字段,关联工具到技能
  • ToolSkillMapper: 未覆盖工具自动分组到10个默认类别
  • MCPSkillGenerator: MCP服务器连接时自动生成技能

工具浏览器

访问 #/tools/explorer 可以按技能分组浏览所有工具。

IPC接口

处理器功能
tools:get-all-with-skills获取所有工具+技能元数据
tools:get-skill-manifest获取所有技能清单
tools:get-by-skill按技能获取工具
tools:search-unified搜索工具
tools:get-tool-context获取工具上下文
tools:refresh-unified刷新注册表

演示模板 (v0.36.0新增)

10个演示模板展示技能组合能力:

类别模板使用技能难度
自动化Web表单自动填充browser-automation, workflow-automation入门
自动化批量截图browser-automation, workflow-automation入门
自动化数据提取流水线web-scraping, workflow-automation中级
AI工作流AI研究助手smart-search, memory-management, web-scraping中级
AI工作流日报生成器memory-management, smart-search入门
AI工作流代码审查流水线code-review, workflow-automation中级
知识个人知识库memory-management, smart-search入门
知识会议记录管理memory-management入门
远程多设备同步remote-control, workflow-automation中级
远程远程桌面监控remote-control, computer-use高级

访问 #/demo-templates 浏览和运行演示模板。


门控检查

平台检查

yaml
# 仅在 macOS 和 Linux 可用
- platform: ["darwin", "linux"]

二进制依赖

yaml
# 需要安装 git
- binary: git

# 需要安装 node 和 npm
- binary: [node, npm]

环境变量

yaml
# 必需的环境变量
- env: OPENAI_API_KEY

# 可选的环境变量
- env: GITHUB_TOKEN (optional)

自定义检查

yaml
# 自定义检查脚本
- check: scripts/check-prerequisites.js

使用技能

命令行调用

bash
# 基本调用
/skill-name

# 带参数
/skill-name file.js --option=value

# 多参数
/code-review src/index.js --focus=security --severity=error

API 调用

javascript
// 执行技能
const result = await skillSystem.execute("code-review", {
  file: "src/auth/login.js",
  focus: "security",
});

// 获取技能信息
const skill = await skillSystem.get("code-review");
console.log(skill.description);
console.log(skill.parameters);

创建自定义技能

1. 创建技能文件

bash
# 在工作区创建
mkdir -p .chainlesschain/skills
touch .chainlesschain/skills/my-skill.md

2. 编写技能定义

markdown
---
name: my-skill
description: 我的自定义技能
version: 1.0.0
---

# My Custom Skill

## 门控检查

- platform: ["darwin", "linux", "win32"]

## 参数

- `input` (required): 输入参数

## 工具

- Read
- Write
- Bash

## 提示词

你是一个专业的助手。请根据用户输入执行以下任务...

3. 测试技能

bash
# 列出可用技能
/skills

# 执行技能
/my-skill input="test"

技能模板

文档生成技能

markdown
---
name: generate-docs
description: 为代码生成文档
---

# Generate Documentation

## 工具

- Read
- Glob
- Write

## 提示词

分析提供的代码文件,生成详细的文档:

1. 模块概述
2. 函数/类说明
3. 参数和返回值
4. 使用示例
5. 注意事项

使用 JSDoc/TSDoc 格式生成注释。

API 测试技能

markdown
---
name: test-api
description: 测试 API 端点
---

# Test API

## 门控检查

- binary: curl

## 参数

- `url` (required): API URL
- `method` (optional): HTTP 方法 (GET|POST|PUT|DELETE)

## 工具

- Bash
- WebFetch

## 提示词

测试提供的 API 端点:

1. 发送请求
2. 分析响应
3. 验证状态码
4. 检查响应格式
5. 报告问题

技能管理

列出技能

javascript
// 获取所有技能
const skills = await skillSystem.list();

// 按来源筛选
const bundled = await skillSystem.list({ source: "bundled" });
const workspace = await skillSystem.list({ source: "workspace" });

安装技能

javascript
// 从 URL 安装
await skillSystem.install({
  url: "https://example.com/skills/my-skill.md",
  location: "managed", // 或 'workspace'
});

// 从本地文件安装
await skillSystem.install({
  path: "/path/to/skill.md",
  location: "workspace",
});

卸载技能

javascript
// 卸载技能
await skillSystem.uninstall("my-skill");

更新技能

javascript
// 更新技能
await skillSystem.update("my-skill");

IPC 处理器

Skills 系统提供 17 个 IPC 处理器:

处理器功能
skills:list列出技能
skills:get获取技能详情
skills:execute执行技能
skills:install安装技能
skills:uninstall卸载技能
skills:update更新技能
skills:validate验证技能定义
skills:enable启用技能
skills:disable禁用技能
skills:getHistory获取执行历史
skills:search搜索技能
skills:reload重新加载
......

配置选项

javascript
{
  "skills": {
    // 技能目录
    "directories": {
      "workspace": ".chainlesschain/skills",
      "managed": "~/.chainlesschain/skills"
    },

    // 自动加载
    "autoLoad": true,

    // 门控检查
    "gateChecks": {
      "enabled": true,
      "strict": false  // 严格模式下失败则禁用技能
    },

    // 执行限制
    "execution": {
      "timeout": 60000,  // 60秒超时
      "maxConcurrent": 3
    }
  }
}

最佳实践

1. 清晰的技能描述

yaml
---
name: optimize-imports
description: 优化 JavaScript/TypeScript 文件的 import 语句,移除未使用的导入,排序并分组
---

2. 合理的工具限制

markdown
## 工具

<!-- 只授予必要的工具权限 -->

- Read
- Glob
<!-- 不需要 Write,只分析不修改 -->

3. 详细的参数说明

markdown
## 参数

- `file` (required): 要处理的文件路径
  - 支持 glob 模式
  - 示例: `src/**/*.ts`

- `style` (optional): 排序风格
  - `alphabetical`: 按字母排序(默认)
  - `grouped`: 按类型分组

下一步


138个内置技能 (100% Handler覆盖) + Agent Skills标准 + 统一工具注册表 🛠️

关键文件

文件职责行数
src/main/ai-engine/cowork/skill-system.js技能系统核心引擎~500
src/main/ai-engine/cowork/skill-loader.js四层技能加载器~320
src/main/ai-engine/cowork/skill-executor.js技能执行器 (Handler 分发)~380
src/main/ai-engine/cowork/skill-md-parser.jsSKILL.md YAML 解析器~250
src/main/ai-engine/cowork/unified-tool-registry.js统一工具注册表~420
src/main/ai-engine/cowork/skill-discoverer.js技能发现与搜索~280

相关文档

基于 MIT 许可发布