pfaria32-capability-awareness

智能体能力自省：评估当前工具、技能与限制，避免过度承诺。

## 概述（中文）

智能体能力自省：评估当前工具、技能与限制，避免过度承诺。

## 技能正文

# Capability Awareness System

让 OpenClaw 智能体了解自定义技能和能力。采用技能优先方法，按需加载文档。不使用时零开销。技能市场发现的基础。

**何时使用：** 技能发现、能力文档、智能体对可用工具的自我感知

**需要了解的：**

**仓库：** https://github.com/pfaria32/openclaw-capability-awareness

## 问题

默认的 OpenClaw 智能体不知道你已安装的自定义技能。它们需要：
1. 发现存在哪些能力
2. 知道何时使用每个技能
3. 按需访问技能文档

## 解决方案

**技能优先方法：**
- 智能体在提示中看到技能描述
- 当主题相关时读取完整的 SKILL.md
- 技能不使用时零开销
- 简单、经过验证、低风险

## 实现选项

### 选项 1：技能优先（推荐用于 v1）
在智能体提示中添加能力卡片：
```
Available Skills:
- token-economy: Model routing and cost optimization
- health-tracking: Apple Health and Strava integration
- memory-system: RAG-based semantic search
```

智能体在需要时读取完整的 SKILL.md。

### 选项 2：完全注入（高级）
- 路由器门控的技能加载
- 动态提示注入
- 上下文感知的能力暴露
- 零基线成本（仅在相关时加载）

## 安装

```bash
cd /home/node/.openclaw/workspace
git clone https://github.com/pfaria32/openclaw-capability-awareness.git projects/capability-awareness-system
```

## 用法

### 当前实现（技能优先）
技能记录在 `workspace/skills/*/SKILL.md` 中。智能体通过 AGENTS.md 工作流自动加载这些内容：

```markdown
## Skills (mandatory)
Before replying: scan <available_skills> <description> entries.
- If exactly one skill clearly applies: read its SKILL.md at <location> with `read`, then follow it.
```

这已经在运作！只需将新技能添加到 workspace/skills 目录即可。

### 未来实现（完全注入）
仓库中提供：
- 路由器设计与 schema
- 基于嵌入的技能匹配
- 动态提示注入策略
- 成本/token 分析

## 状态

✅ **技能优先方法** — 已部署并运作
📋 **完全注入设计** — 已记录，尚未实现

## 归属

为支持新兴的 OpenClaw 技能生态系统而构建。简单胜过聪明。

## 文档

实现选项、设计决策和升级路径已在仓库中记录。