# cloud-agent-plugin

**Repository Path**: whateverXk/cloud-agent-plugin

## Basic Information

- **Project Name**: cloud-agent-plugin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-10
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Workaholic Cloud Agent Plugin

面向 Codex 的 Workaholic Cloud Agent 开源插件。它把 Cloud Agent Open API 的接入规则、Agent 创建、Tool 创建和 Agent JSON Template Format 0.1 封装成可安装 Skills，减少不同模型重复理解整份 OpenAPI 的成本。

## 安装

```bash
codex plugin marketplace add https://gitee.com/whateverXk/cloud-agent-plugin.git --ref master
codex plugin add workaholic-cloud-agent@workaholic-cloud-agent
```

安装后请开启一个新会话，并按需调用 14 个专职 Skill：

- `$workaholic-api-integration`：规划、实现或排查通用 API 集成。
- `$workaholic-create-agent`：设计和创建单 Agent 或 Team Agent。
- `$workaholic-create-tool`：把 HTTP API 创建为 Agent Tool。
- `$workaholic-agent-template`：生成或检查可移植 Agent JSON 模板。
- `$workaholic-api-auth`：配置认证、API Key、JWT 和 Scope。
- `$workaholic-manage-skills`：创建、校验、测试和管理平台 Skill。
- `$workaholic-knowledge-base`：创建知识库、摄取文档、调优切块与检索。
- `$workaholic-run-agent`：可靠执行或测试 Agent。
- `$workaholic-manage-executions`：检查、审批、取消、重放和导出执行。
- `$workaholic-conversations`：管理多轮会话生命周期。
- `$workaholic-files-artifacts`：管理输入文件和执行产物。
- `$workaholic-team-agent`：设计 Team Agent、成员角色和委派边界。
- `$workaholic-output-schema`：设计和验证结构化输出。
- `$workaholic-debug-integration`：根据契约、错误码和诊断定位集成故障。

## 更新

```bash
codex plugin marketplace upgrade workaholic-cloud-agent
codex plugin add workaholic-cloud-agent@workaholic-cloud-agent
```

## 契约同步

根目录的 `openapi.json` 是插件绑定的 API 契约快照。更新它后运行：

```bash
node plugins/workaholic-cloud-agent/scripts/sync-openapi.mjs
```

脚本会为每个 Skill 生成按主题筛选的 OpenAPI reference。提交前应运行插件和 Skill 校验。

## 安全边界

插件不包含 API Key、Token、Cloud Agent 实例地址或其他凭据。安装插件不会自动授予 Cloud Agent 权限；调用 API 时仍需使用者提供自己的实例地址及合法认证。

## License

MIT