agent-platform-api
RCS Platform API 完整参考。Agent 通过 curl + jq 调用 REST API 操作平台资源:环境、会话、工作流、配置、任务、知识库、组织等。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
القائمة
RCS Platform API 完整参考。Agent 通过 curl + jq 调用 REST API 操作平台资源:环境、会话、工作流、配置、任务、知识库、组织等。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when starting an issue, bugfix, feature, or refactor that should be driven by multiple coordinated subagents: explore → plan → code → review, with the main agent acting as controller and subagents exchanging handoff files.
通过 zentao 命令行工具查询和操作禅道(ZenTao)数据,覆盖项目集、产品、项目、执行、需求、Bug、任务、测试用例、测试单、产品计划、版本、发布、反馈、工单、应用、用户、附件等模块的增删改查及状态流转。当用户提到禅道、zentao、查询项目进展、获取 Bug 列表、创建任务、更新需求状态等项目管理操作时使用本技能。
当需要把本地 HTML 或图片文件展示给前端时使用。优先引用工作目录下 user/ 目录中的文件;如果目标文件不在 user/ 目录下,先复制到 user/ 再展示。路径由前端自动改写为 /fs/ 路由代理,Agent 只需输出 user/ 相对路径即可。最终只输出可直接渲染的相对路径片段:HTML 输出 iframe,图片输出 Markdown 图片;路径不能是绝对路径,也不能以 / 开头,且不要附加额外说明文字。
执行 FenixAgent 项目专用代码审查。手动触发,默认审查已暂存改动,或按用户提供的文件路径、提交范围、分支 diff 范围进行审查,并生成审查报告。
帮助用户创建、编辑和优化 Agent Skill 指令文件。当用户提到"创建 skill"、"写技能"、"编辑 skill"、"优化技能"、"新建技能"或需要生成 SKILL.md 文件时使用。
| name | agent-platform-api |
| description | RCS Platform API 完整参考。Agent 通过 curl + jq 调用 REST API 操作平台资源:环境、会话、工作流、配置、任务、知识库、组织等。 |
| allowed-tools | Bash |
以下环境变量由系统自动注入:
$USER_META_BASE_URL — API 服务器地址(仅限 agent 内部调用 RCS API 使用)
$USER_META_BASE_URL是服务器内部地址,与用户通过浏览器访问的外部地址不同。 该变量只用于curl调用 RCS 后端 API(如curl $USER_META_BASE_URL/web/...),禁止直接拼接后展示给用户。建站等需要告知用户访问地址的场景,统一通过<agent-sites>卡片标签或引导用户操作 UI tab 来提供入口,不要手工拼接和暴露 URL。
$USER_META_API_KEY — Bearer token,所有请求必须携带$USER_META_USER_ID — 当前请求用户 ID,用于标注资源归属或调用 user-scoped API$USER_META_ORG_ID — 当前组织 ID,多租户隔离/调用 organization-scoped API 时使用所有请求必须携带 Authorization 头:
AUTH="-H 'Authorization: Bearer $USER_META_API_KEY' -H 'Content-Type: application/json'"
关于组织隔离:绝大多数
/web/*路由后端会从 API Key 元数据自动取$USER_META_ORG_ID作为隔离范围,无需在 URL query 或 body 中显式传organizationId。$USER_META_ORG_ID/$USER_META_USER_ID仅在少数需要明确指定目标组织/用户的接口(如/web/organizations的 action 类操作)中作为 body 字段传入。
成功:{ "success": true, "data": ... }
失败:{ "success": false, "error": { "type": "ERROR_CODE", "message": "..." } }
| 模块 | 文档 | 说明 |
|---|---|---|
| 环境 | references/environment.md | 环境创建/列表/进入/实例管理 |
| 会话 | references/session.md | 会话列表/历史/控制/中断 |
| 工作流 | references/workflow.md | 工作流定义/执行引擎/触发器/看板/作业 |
| 配置 | references/config.md | Provider/Model/Agent/Skill/MCP 配置 |
| 任务 | references/task.md | 定时任务 CRUD/触发/日志 |
| 知识库 | references/knowledge.md | 知识库 CRUD/文件上传/URL 导入 |
| 组织 | references/org.md | 组织管理/成员/API Key |
| Agent Sites | references/agent-sites.md | 建站部署/App 管理/PocketBase 后端配置/前端上传 |
使用某个模块的 API 前,先 cat references/<module>.md 读取完整文档和 curl 示例。
| jq '.data' # 提取 data 字段
| jq '.data[] | { id, name }' # 列表提取 id 和 name
| jq -r '.data.draftYaml' # 原文输出工作流草稿
| jq '{ success }' # 只看成功状态