@ cleocode/ 技能

部分 平等机会委员会。从 root README 开始;运行 cleo <command> --help 对于任何命令.

CLEO技能定义——AI代理的捆绑能力.

概览

这个软件包包含预建的技能和能力,可以扩展具有专门功能的CLEO代理. 技能定义了代理人可以做什么,应该怎么做.

CLEO技术是什么?

技能是模块化的成套能力:

• 定义代理人可以执行的具体任务
• 提供详细的指令和工作流程
• 包括制约因素和最佳做法
• 扩展基准代理协议
• 在产卵时被管弦乐手注射

安装

npm install @cleocode/skills

pnpm add @cleocode/skills

yarn add @cleocode/skills

包括技能

等级和安装行为来自每个SKILL. 医生的 metadata (所有人的决定) D11157 (英语). packages/skills/skills/manifest.json 由它们产生 node scripts/skills/generate-manifest.mjs门29 -31 保存清单, 可安装性和所有文件 cleo 命令诚实.

核心(安装在每条绳子上,始终相关)

根据需要(已安装;按说明或按阶段指导加载)

内部(仅开发CLEO;从未安装到管子上)

T12649 合并或退休: ct-docs-write 和 ct-docs-review 的参考文献 ct-documentor; ct-memory和ct-stickynote是ct-cleo的参考文献; ct-技能创造者和ct-技能验证者成为ct-技能作者;ct-docs- lookup (使用上下文7 MCP)和 Ct-master-tac 已退役;信号接通移动 到信号Dock仓库.

技能结构

每种技能都遵循标准化结构:

skills/
├── <skill-name>/
│   ├── SKILL.md              # Main skill definition (required)
│   ├── README.md             # User documentation (optional)
│   ├── INSTALL.md            # Installation guide (optional)
│   ├── agents/               # Specialized agent definitions
│   │   ├── analyzer.md
│   │   └── executor.md
│   ├── references/           # Reference documentation
│   │   ├── patterns.md
│   │   └── examples.md
│   └── assets/               # Assets and templates
│       └── template.md

使用技能

从CLI

# Load a skill
cleo skills load ct-research-agent

# Use skill with a task
cleo skills apply ct-research-agent --task T1234

# List available skills
cleo skills list

# Show skill details
cleo skills show ct-research-agent

从代码

import { skills } from '@cleocode/core';

// Load a skill
const skill = await skills.load('ct-research-agent');

// Apply skill to a task
await skills.apply({
  skill: 'ct-research-agent',
  taskId: 'T1234',
  context: { topic: 'API design patterns' }
});

// Get skill information
const info = await skills.get('ct-codebase-mapper');
console.log(info.description);
console.log(info.capabilities);

从特工

产卵剂时自动注入技能:

import { orchestration } from '@cleocode/core';

// Skill is injected based on task context
await orchestration.spawn({
  agent: 'cleo-subagent',
  taskId: 'T1234',
  skill: 'ct-implementation' // Injected at spawn
});

技能定义格式

技能定义在 SKILL.md 文件, 有 YAML 前题 :

---
id: ct-example-skill
name: Example Skill
description: |
  Multi-line description of what this skill does
  and when to use it.
version: 1.0.0
author: CLEO Team
tags:
  - development
  - example
dependencies:
  - ct-cleo
allowed_tools:
  - Read
  - Write
  - Bash
  - Glob
  - Grep
  - WebFetch
  - WebSearch
---

# Example Skill

## Overview

Detailed explanation of the skill's purpose and usage.

## Capabilities

- **Capability 1**: Description
- **Capability 2**: Description

## Workflow

1. **Step 1**: Description
2. **Step 2**: Description
3. **Step 3**: Description

## Constraints

| ID | Rule | Enforcement |
|----|------|-------------|
| EX-001 | **MUST** follow constraint | Required |
| EX-002 | **SHOULD** consider guideline | Recommended |

## Examples

### Example 1: Basic Usage

```bash
# Command example

例2:先进使用

# Advanced command example

参考资料

• 相关文档
• 图案指南

## Creating Custom Skills

### 1. Create Skill Directory

```bash
mkdir -p skills/my-custom-skill

2. 创建 SKILL.md

---
id: my-custom-skill
name: My Custom Skill
description: |
  Description of what this skill does.
version: 1.0.0
author: Your Name
tags:
  - custom
  - specialized
allowed_tools:
  - Read
  - Write
  - Bash
---

# My Custom Skill

## Purpose

Explain what this skill does and when to use it.

## Workflow

1. Analyze the task
2. Execute the work
3. Validate the output

## Output Format

Describe expected output format.

3. 技术注册

import { skills } from '@cleocode/core';

skills.register({
  id: 'my-custom-skill',
  path: './skills/my-custom-skill',
  version: '1.0.0'
});

技能验证

分配前验证技能 :

# Validate a skill
cleo skills validate my-custom-skill

# Or programmatically
import { skills } from '@cleocode/core';

const result = await skills.validate('my-custom-skill');
if (result.valid) {
  console.log('Skill is valid ✓');
} else {
  console.log('Issues:', result.issues);
}

技能类别

技能按类别分类:

发展技能

• 编码基础绘图和分析
• 执行指南
• 测试战略

研究技能

• 信息收集
• 文件查询
• 多源合成

指挥技能

• 多机构协调
• 工作流程管理
• 建立共识

质量技能

• 代码审查
• 文件审查
• 合规检查

域技能

• 具体框架指南
• 平台整合
• 工具专长

技能依赖

技能取决于其他技能:

# In SKILL.md frontmatter
dependencies:
  - ct-cleo          # Base CLEO operations
  - ct-research-agent # Research capabilities
  - ct-validator     # Validation support

在应用技能时,依赖会自动被加载.

技能链

技能可以连锁在一起:

import { skills } from '@cleocode/core';

// Chain multiple skills
await skills.chain([
  { skill: 'ct-research-agent', taskId: 'T1234' },
  { skill: 'ct-spec-writer', taskId: 'T1235' },
  { skill: 'ct-epic-architect', taskId: 'T1236' }
]);

技能简介

不同角色的组合技能:

# profiles/backend-developer.yaml
name: Backend Developer
skills:
  - ct-codebase-mapper
  - ct-research-agent
  - ct-spec-writer
  - drizzle-orm
  - ct-dev-workflow

使用配置文件 :

cleo skills apply-profile backend-developer --task T1234

共享资源

通用模式和公用事业 skills/_shared/数字 :

• manifest-operations.md - 通过Cleo 显示的CLI与管道合作
• subagent-protocol-base.md - 底子剂协议
• skill-chaining-patterns.md - 建立最佳做法链
• testing-framework-config.md - 测试配置
• task-system-integration.md - 任务系统整合
• cleo-style-guide.md - CLEO文件风格

与代理人的融合

技能和代理人共同工作:

1. 整形仪 确定任务要求
2. 选择适当的技能 基于任务类型
3. 间谍代理商 技术注入
4. 代理跟踪 技能说明
5. 技能指南 在代理框架内执行

示例

Task: "Research authentication patterns"
  ↓
Orchestrator selects: ct-research-agent skill
  ↓
Spawns: cleo-subagent with ct-research-agent injected
  ↓
Agent follows LOOM protocol
  ↓
Skill guides research methodology
  ↓
Output: Research report written to file

依赖关系

此软件包没有运行时间依赖性 。 它包含:

• 技能定义( markdown 文件)
• 参考文件
• 配置模板
• 示例产出

许可证

麻省理工学院执照 - 看 自由主义 详细情况.