# @cleocode/skills 中文文档

规范地址：https://npmcn.com/package/%40cleocode/skills/

版本：2026\.11\.2
npm 元数据更新时间：2026-11-12T09:46:03.405Z
中文译文更新时间：2026-11-12T09:46:44.842Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cleocode/skills
原文对照：https://npmcn.com/package/%40cleocode/skills/?lang=original
项目主页：https://github.com/kryptobaseddev/cleo#readme
源码仓库：https://github.com/kryptobaseddev/cleo

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.1 MB，220 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.16\.0
- 运行依赖：0 个
- 首次发布：2026-03-19T05:28:26.204Z
- 最新版本发布：2026-11-12T09:46:02.881Z
- 近 30 天下载量：12906（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：415（近 12 个月 415 个）

## 中文简介

CLEO技能定义 - 与 CLEO 单列组合

## 安装

```sh
npm install @cleocode/skills
```

也可以使用：`pnpm add @cleocode/skills`、`yarn add @cleocode/skills`、`bun add @cleocode/skills`

## README

# @ cleocode/ 技能

> 部分 [平等机会委员会](https://github.com/kryptobaseddev/cleo#readme)。从 root README 开始;运行 `cleo <command> --help` 对于任何命令.

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

## 概览

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

## CLEO技术是什么?

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

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

## 安装

```bash
npm install @cleocode/skills
```

```bash
pnpm add @cleocode/skills
```

```bash
yarn add @cleocode/skills
```

## 包括技能

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

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

| 技能 | 目的 |
| --- | --- |
| **ct克卢** | CLEO任务管理协议——会话,任务和工作流程指导. |
| **ct-dev-work流量** | 开发工作流程 以任务驱动的开发 原子承诺,常规承诺 混乱.. |
| **ct 文档** | 具有CLEO风格的文件协调员指导遵守. |
| **ct 净值** | 对CLEO工作的精益变化纪律:能完全解决任务的最小变化,以及一个忙碌的回复. |
| **ct 领导** | 用于产卵和监管 平行的工人群在一波. |
| **ct 操作器** | 通过子代理授权管理复杂工作流程的管线-意识管弦技术. |
| **ct 任务执行器** | 通过遵循指令和出品完成指派的CLEO任务的一般执行任务执行 |

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

| 技能 | 目的 |
| --- | --- |
| **记录器** | 记录结构裁决记录 来自接受的共识裁决. |
| **ct-艺术-出版** | 建造并出版文物到登记(npm,PyPI,货物,docker,GitHub发行,通用焦油丸) fol |
| **ct- 码基- 马普** | 以不熟悉或大型的代码库为方向,使用CLEO的代码-智能图(cleo link)和项目地图(cl |
| **ct 协商一致投票** | 运行结构化的多代理投票,对决策任务进行置信分数,冲突检测,以及HITL esc.. |
| **捐款** | 指导多机构共识贡献的工作流程. |
| **ct 库** | 召集"理事会"——5名顾问,洗牌出闸同级评审,会长同级评审工作流程. |
| **ct- epic- architect** | 将大型倡议分解为原子性,可执行性的任务的图片规划和任务分解. |
| **ct 保管人** | 生成到v1的证明,SLSA级出处记录,SBOMS(CycloneDX或SPDX),和sigstore/cosi |
| **ct 释放器** | CLEO发布: `cleo release cut <version>` 标记绿色 CI 的最新主任务, 并发布. yml 将 ChangeGELOG 从更改器中写入并发布 . |
| **ct-研究-代理人** | 多源研究和调查结合了网络搜索,文件通过上下文7查询和代码库 |
| **ct 谱写器** | 使用RFC 2119语言编写技术规格,以便提出明确、明确的要求. |
| **ct 验证器** | 根据要求、计划或标准核查系统、文件或代码的合规性验证. |

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

| 技能 | 目的 |
| --- | --- |
| **ct级** | CLEO会话分级和A/B行为分析,并附有符号跟踪. |
| **ct 技能作者** | 创建、改进和验证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

```bash
# 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
```

### 从代码

```typescript
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);
```

### 从特工

产卵剂时自动注入技能:

```typescript
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 前题 :

````markdown
---
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:先进使用

```bash
# Advanced command example
```

## 参考资料

-   [相关文档](https://npmcn.com/package/%40cleocode/skills/path/to/docs.md)
-   [图案指南](https://npmcn.com/package/%40cleocode/skills/path/to/patterns.md)

````

## Creating Custom Skills

### 1. Create Skill Directory

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

### 2\. 创建 SKILL.md

```markdown
---
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\. 技术注册

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

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

## 技能验证

分配前验证技能 :

```bash
# 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);
}
```

## 技能类别

技能按类别分类:

### 发展技能

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

### 研究技能

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

### 指挥技能

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

### 质量技能

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

### 域技能

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

## 技能依赖

技能取决于其他技能:

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

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

## 技能链

技能可以连锁在一起:

```typescript
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' }
]);
```

## 技能简介

不同角色的组合技能:

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

使用配置文件 :

```bash
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 文件)
-   参考文件
-   配置模板
-   示例产出

## 许可证

麻省理工学院执照 - 看 [自由主义](https://npmcn.com/package/%40cleocode/LICENSE) 详细情况.

## 常见问题

### @cleocode/skills 是什么？

CLEO技能定义 - 与 CLEO 单列组合

### 如何安装 @cleocode/skills？

在项目目录运行 npm install @cleocode/skills，或使用 pnpm add / yarn add / bun add。

### @cleocode/skills 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @cleocode/skills 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @cleocode/skills 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.16\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cleocode/skills 可以商用吗？

@cleocode/skills 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @cleocode/skills 的下载量有多少？

根据 npm 官方下载统计，@cleocode/skills 在 2026/10/10 – 2026/11/08 这 30 天内被下载 12,906 次，日均约 430 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cleocode/skills 还在维护吗？

最新版本 2026\.11\.2 发布于 2026/11/12（今天）；至今共发布 415 个版本，其中过去 12 个月发布了 415 个；首次发布于 2026/03/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。