Cheat Code Tool Free

SKILL.md

---
name: "cheat-code-tool-free"
description: "为AI代理提供训练数据之外的外部知识检索能力,扩展问题解决边界"
license: Proprietary
allowed-tools: read exec
compatibility: "Requires LLM with tool-use capability"
metadata:
  displayName: "能力扩展工具免费版"
  version: "1.0.0"
  summary: "为AI代理提供训练数据之外的外部知识检索能力,扩展问题解决边界"
  tags:
    - "开发工具"
    - "知识检索"
    - "能力扩展"
    - "AI辅助"
  source: "SkillHub"
  converted_at: "2026-07-22T17:58:36"
---

# 能力扩展工具免费版

## 概述

能力扩展工具免费版为个人用户的 AI Agent 提供访问训练数据之外的结构化知识能力。通过配置访问令牌,Agent 可以向知识服务发送请求,获取最新的技术文档、API 规范、领域知识等结构化数据,从而突破训练数据的时效性限制。

免费版聚焦单次查询场景,配置简单,适合个人开发者扩展 Agent 的知识边界。

## 核心能力

### 1. 外部知识检索

Agent 向知识服务发送查询请求,获取结构化数据:

```text
用户提问 → Agent 识别知识缺口 → 发送查询请求 → 获取结构化数据 → 整合到回答中
```

**输入**: 用户提供外部知识检索所需的指令和必要参数。
**处理**: 按照skill规范执行外部知识检索操作,遵循单一意图原则。
**输出**: 返回外部知识检索的执行结果,包含操作状态和输出数据。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

### 2. 无状态架构

| 特性 | 说明 |
|:-----|:-----|
| 无状态 | 每次查询独立,不保留上下文 |
| 即用即弃 | 上下文处理完成后立即丢弃 |
| 不存储 | 查询结果不持久化保存 |
| 不训练 | 数据不用于模型训练 |

**输入**: 用户提供无状态架构所需的指令和必要参数。
**处理**: 按照skill规范执行无状态架构操作,遵循单一意图原则。
**输出**: 返回无状态架构的执行结果,包含操作状态和输出数据。

### 3. 加密传输

所有请求在传输过程中加密,确保数据安全:

```text
Agent → [加密通道] → 知识服务 → [加密通道] → Agent
```

**输入**: 用户提供加密传输所需的指令和必要参数。
**处理**: 按照skill规范执行加密传输操作,遵循单一意图原则。
**输出**: 返回加密传输的执行结果,包含操作状态和输出数据。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

### 4. 令牌授权

通过环境变量配置访问令牌,授权 Agent 访问外部知识库:

```bash
# 配置访问令牌
export KNOWLEDGE_TOKEN="your-access-token"
```

**输入**: 用户提供令牌授权所需的指令和必要参数。
**处理**: 按照skill规范执行令牌授权操作,遵循单一意图原则。
**输出**: 返回令牌授权的执行结果,包含操作状态和输出数据。
**能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：代理提供训练数据、之外的外部知识检、索能力、扩展问题解决边界、面向个人用户的能、力扩展工具、能够访问训练数据、之外的结构化知识、核心能力、外部知识库查询与、结构化数据获取、单次查询、实时返回结果、上下文处理即丢弃、数据不存储不训练等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

## 使用场景

### 场景一: 查询最新技术文档

Agent 需要回答关于最新框架版本的问题,但训练数据中没有覆盖。

```bash
# 触发外部知识查询
请查询 React 19 的并发渲染特性,我的训练数据可能不包含最新版本信息
```

查询流程:

```text
1. Agent 识别知识缺口: React 19 是训练截止后的版本
2. 发送查询请求: "React 19 concurrent rendering features"
3. 获取结构化数据: 特性列表、API 变更、迁移指南
4. 整合到回答中: 基于返回数据给出准确回答
```

### 场景二: 获取领域专业知识

处理特定领域问题时,获取专业领域知识辅助决策。

```bash
# 查询领域知识
请查询关于 OAuth 2.1 与 OAuth 2.0 的主要差异
我需要准确的标准规范信息
```

### 场景三: 扩展知识边界

当 Agent 回答"我不确定"时,主动查询外部知识补充。

```bash
# 补充知识
你刚才说不确定 WebSocket 心跳机制的最新最佳实践
请查询最新的 WebSocket 心跳实现规范
```

## 不适用场景

以下场景能力扩展工具免费版不适合处理：

- 需要100%确定性的关键决策
- 医疗诊断
- 法律判决

## 触发条件

需要AI模型调用、智能对话、Agent编排、LLM应用时使用。不适用于非本工具能力范围的需求。

## 快速开始

### 第一步: 获取访问令牌

注册知识服务账户,获取访问令牌。

### 第二步: 配置环境变量

```bash
# 在 shell 配置文件中添加
export KNOWLEDGE_TOKEN="your-access-token"

# 验证配置
echo $KNOWLEDGE_TOKEN
```

### 第三步: 在 Agent 中使用

```bash
# 直接在对话中触发
请使用外部知识查询: GraphQL 订阅与 WebSocket 的区别

# 或在任务中自动触发
请帮我实现 SSE 推送,如果训练数据不够新,请查询最新规范
```

### 第四步: 查看结果

Agent 会整合外部知识与自身能力,给出更准确的回答:

```text
查询完成: 已获取 GraphQL 订阅相关规范

回答:
GraphQL 订阅基于 WebSocket 协议,与普通 WebSocket 的区别在于:
1. 使用 GraphQL 查询语言定义数据结构
2. 服务端按订阅条件推送更新
3. [来源: 外部知识查询]
```

### 场景四: 补充过时信息

当发现自身知识可能过时时,主动查询补充。

```bash
# 发现知识可能过时
你之前提到的 Docker 部署方式可能已经过时
请查询最新的 Docker 容器部署最佳实践

# 查询后更新回答
查询完成: 已获取最新 Docker 部署规范

更新回答:
最新推荐的 Docker 部署方式:
1. 使用多阶段构建减小镜像体积
2. 使用 .dockerignore 排除不必要文件
3. 使用非 root 用户运行容器
4. [来源: 外部知识查询, 获取时间: 2026-07]
```

## 示例

### 基础配置

```bash
# 必需配置
export KNOWLEDGE_TOKEN="your-access-token"

# 可选配置
export KNOWLEDGE_ENDPOINT="https://knowledge-service.example.com/api"
export KNOWLEDGE_TIMEOUT="30"
export KNOWLEDGE_MAX_RESULTS="5"
```

### 配置项说明

| 配置项 | 默认值 | 说明 |
|:-------|:-------|:-----|
| `KNOWLEDGE_TOKEN` | 无 | 访问令牌(必需) |
| `KNOWLEDGE_ENDPOINT` | 默认服务地址 | 知识服务端点 |
| `KNOWLEDGE_TIMEOUT` | 30 | 查询超时(秒) |
| `KNOWLEDGE_MAX_RESULTS` | 5 | 最大返回结果数 |

## 最佳实践

### 1. 识别知识缺口

Agent 应主动识别自身知识边界,在以下情况触发外部查询:

| 情况 | 示例 |
|:-----|:-----|
| 训练截止后的新版本 | "React 19 新特性" |
| 快速变化的领域 | "最新的安全漏洞" |
| 特定领域深度知识 | "PCI DSS 合规要求" |
| Agent 表示不确定时 | "我不确定最新规范" |

### 2. 查询后验证

获取外部知识后,Agent 应:

```text
1. 标注信息来源: [来源: 外部知识查询]
2. 与已有知识交叉验证
3. 明确哪些是查到的、哪些是推断的
4. 对不确定的部分保持透明
```

### 3. 高效查询

```bash
# 好的查询(具体明确)
请查询: Python 3.12 类型系统的新特性,特别是类型参数语法

# 不好的查询(过于宽泛)
请查询: Python 相关信息
```

## 常见问题

### 已知限制

免费版有每日查询次数限制,适合个人日常使用。高频查询场景请使用 PRO 版。

### Q2: 查询的数据会被存储吗?

不会。采用无状态架构,上下文处理完成后立即丢弃,不存储也不用于训练。

### Q3: 网络不通时怎么办?

网络不可用时,Agent 会回退到使用自身训练数据回答,并注明可能不是最新信息。

### Q4: 令牌过期了怎么办?

重新登录知识服务获取新令牌,更新环境变量即可。

### Q5: 支持哪些类型的知识查询?

支持技术文档、API 规范、领域知识、标准规范等结构化知识查询。
- 当前为免费版本,如需完整功能请升级到付费版获取全部能力
## 依赖说明

### 运行环境

- **Agent 平台**: 支持读取 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
- **操作系统**: Windows / macOS / Linux
- **网络**: 需要访问知识服务端点

### 依赖详情

| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:-------|:-----|:---------|:---------|
| LLM API | API | 必需 | 由 Agent 内置 LLM 提供 |
| 知识服务 | API | 必需 | 注册获取访问令牌 |
| curl(可选) | CLI 工具 | 否 | 系统自带 |

### API Key 配置

```bash
# 必需: 知识服务访问令牌
export KNOWLEDGE_TOKEN="your-access-token"

# 可选: 自定义服务端点
export KNOWLEDGE_ENDPOINT="https://knowledge-service.example.com/api"
```

### 可用性分类

- **分类**: MD+EXEC+API(Markdown 指令 + 命令行执行 + 外部 API 调用)
- **说明**: 通过自然语言指令驱动 Agent 查询外部知识服务
- **离线可用**: 否,查询需要网络连接知识服务

## 错误处理


| 错误场景 | 原因 | 处理方式 |
|---------|------|---------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |