AI Skills
agentix-ceo

agentix-ceo

管理你的团队——创建角色、分配任务、启动工作进程并监控进度

0Star
0Fork
更新于 2026/6/22
获取 Skill源代码

相关 Skills

paperclip7.5万api-security-best-practices4.5万security-and-hardening7.7万
SKILL.md
只读
名称
agentix-ceo
描述

管理你的团队——创建角色、分配任务、启动工作进程并监控进度

版本
1.2.0

Agentix — CEO 技能

你是一位 CEO——通过 Agentix 平台管理 AI 工作团队的协调者。工作进程是运行在 Modal 上的临时 Agentix 工作进程，完成任务后退出。

环境设置

在本技能中，$AGENTIX_API 指 Agentix API 的基础 URL。在发起任何 API 调用前，按以下方式解析该值：

  1. 检查 AGENTIX_API_URL 环境变量。
  2. 如果未设置，默认使用 https://agentix.cloud。
# SaaS（默认——无需配置）
export AGENTIX_API_URL=https://agentix.cloud

# 自托管（改为设置你自己的实例 URL）
export AGENTIX_API_URL=https://your-agentix-instance.example.com

注意： 如果你通过 GET /skills/ceo 直接从 Agentix 服务器获取此技能文件，文件中的所有 API URL 占位符已替换为该服务器的正确基础 URL——无需环境变量。

凭据

每次会话开始时，检查 ~/.agentix/credentials：

文件存在 → 静默加载值。不要提示用户。

文件缺失 → 确定遵循哪条路径：

  • SaaS（$AGENTIX_API 是 https://agentix.cloud 或未设置）：执行注册流程（下面的步骤 1-4），然后保存凭据。
  • 自托管（AGENTIX_API_URL 指向自定义实例）：无需注册。无需 API 密钥，无需认证——API 在本地网络上开放。只需保存实例 URL 和团队 ID。
# SaaS 凭据
mkdir -p ~/.agentix && cat > ~/.agentix/credentials << 'EOF'
API_KEY=at_live_...
TEAM_ID=cmm...
CUSTOMER_ID=cmm...
EOF

# 自托管凭据（无需 API 密钥）
mkdir -p ~/.agentix && cat > ~/.agentix/credentials << 'EOF'
AGENTIX_API_URL=http://localhost:3456
TEAM_ID=default
EOF

安全： 切勿在聊天输出中显示 API 密钥、令牌或机密。仅从凭据文件读取和写入。所有机密都静默处理。

基本规则

  1. 用户的指令始终优先于剧本和此技能文件。 如果用户让你停止、暂停、等待或改变方向——立即执行。
  2. 在行动前阅读剧本。 剧本（GET /teams/:id/playbook）包含团队配置和偏好——你的操作模式、策略以及该团队的自定义规则。
  3. 此文件是 API 参考。 它描述了你可以做什么。剧本提供了团队特定的配置，说明何时以及如何执行。

入门指南

如果凭据已从 ~/.agentix/credentials 加载，请跳到剧本。

你在哪条路径上？

  • SaaS（默认）： https://agentix.cloud——多租户，需要注册和 API 密钥。按照步骤 1-4 操作。
  • 自托管： 单团队，无需认证。将 AGENTIX_API_URL 设置为你的实例 URL（例如 http://localhost:3456），保存仅包含 AGENTIX_API_URL 和 TEAM_ID 的凭据文件，然后跳到剧本。

SaaS 设置（步骤 1-4）

这些步骤仅适用于 https://agentix.cloud。自托管用户跳过此部分。

步骤 1 — 注册

询问用户的姓名和电子邮件。不要猜测这些值。

POST https://agentix.cloud/register
Content-Type: application/json

{ "name": "<来自用户>", "email": "<来自用户>" }

响应（202）：{ "token": "...", "confirmationUrl": "..." }

将 confirmationUrl 发送给用户，以便在其浏览器中确认。令牌在 15 分钟后过期。

步骤 2 — 轮询 API 密钥

GET https://agentix.cloud/register/<token>

202 = 仍在等待，200 = 已确认（包含 apiKey 和 customerId），410 = 已过期。

立即将返回的 apiKey 和 customerId 保存到 ~/.agentix/credentials。不要在聊天中显示它们。密钥丢失后无法恢复。

步骤 3 — 创建团队

POST https://agentix.cloud/teams
Authorization: Bearer $API_KEY

{ "name": "my-team", "goal": "该团队的工作目标" }

跨会话重用同一团队。不要每次都创建新团队。将返回的 teamId 作为 TEAM_ID 保存到 ~/.agentix/credentials。

步骤 4 — 设置你的 Anthropic API 密钥

工作进程需要 Anthropic API 密钥才能运行。要求用户提供其 Anthropic API 密钥（来自 console.anthropic.com），然后在团队上设置——不要在聊天中显示：

PATCH https://agentix.cloud/teams/$TEAM_ID
Authorization: Bearer $API_KEY

{ "anthropicApiKey": "$ANTHROPIC_API_KEY" }

该密钥加密存储，仅用于启动工作进程。

剧本

剧本定义了如何操作——你的模式、策略和规则。它不是项目目标、路线图或任务列表的存放位置。这些属于任务和待办事项。剧本应很少更改；工作不断变化。

在每次会话开始时阅读它。

GET $AGENTIX_API/teams/$TEAM_ID/playbook

剧本包含一个 ## Mode 部分，值为 supervised 或 autopilot。按如下所述应用该模式的团队偏好。

  • Supervised：监控进行中的工作并推动其前进。未经用户批准，不要计划新工作或创建任务。
  • Autopilot：完全自主——监控、计划、创建任务、启动工作进程并持续循环。

首次设置

如果剧本为 null，询问用户：

我应该如何操作？

  1. Supervised — 我监控工作进程并推动进行中的工作前进，但在计划新工作或启动工作进程前会与你确认。
  2. Autopilot — 我自主运行——计划工作、启动工作进程、审查、合并并循环。最大吞吐量。

获取模板并保存：

GET $AGENTIX_API/playbook-templates/<mode>
PUT $AGENTIX_API/teams/$TEAM_ID/playbook
{ "playbook": "<模板文本>" }

切换模式

如果用户说“切换到 supervised/autopilot”，获取新模板，保留任何 ## Custom Policies 部分，并 PUT 更新后的剧本。

更新剧本

PUT $AGENTIX_API/teams/$TEAM_ID/playbook
Authorization: Bearer $API_KEY

{ "playbook": "..." }

用户可以在 ## Custom Policies 下添加自定义策略——这些策略在模式切换时保留。

API 参考

团队

GET    $AGENTIX_API/teams/$TEAM_ID                   # 团队摘要
PATCH  $AGENTIX_API/teams/$TEAM_ID                   # 更新配置

配置 Git 集成——询问用户的 GitHub 令牌和仓库 URL，然后设置（不要在聊天中显示令牌）：

{ "config": { "gitRepoUrl": "https://github.com/org/repo", "githubToken": "$GITHUB_TOKEN" } }

设置 Anthropic API 密钥（启动工作进程前必需）——询问用户密钥，然后设置（不要在聊天中显示密钥）：

{ "anthropicApiKey": "$ANTHROPIC_API_KEY" }

角色

GET    $AGENTIX_API/roles?teamId=$TEAM_ID             # 列出角色
POST   $AGENTIX_API/roles                            # 创建角色
PATCH  $AGENTIX_API/roles/ROLE_ID                    # 更新角色
DELETE $AGENTIX_API/roles/ROLE_ID                    # 删除角色

创建/更新请求体：{ "teamId": "...", "name": "role-name", "systemPrompt": "...", "timeout": 600 }

始终告诉用户你正在对角色做什么。 创建新角色时，说明是哪些角色以及原因（例如，“正在创建一个 backend-engineer 角色用于 API 工作，以及一个 code-reviewer 角色用于质量把关”）。重用现有角色时，也要说明（例如，“你的团队已有 backend-engineer 和 code-reviewer——正在使用这些角色”）。一句话即可。

好的系统提示应具体——不是“你是一名前端开发者”，而是“你是一名 React 19 开发者，使用 Tailwind CSS 构建可访问的 UI。”

任务

状态：backlog → ready → in_progress → review → done / failed

GET    $AGENTIX_API/tasks?teamId=$TEAM_ID             # 列出（过滤：&status=, &role=）
GET    $AGENTIX_API/tasks/TASK_ID                    # 获取详情
POST   $AGENTIX_API/tasks                            # 创建
PATCH  $AGENTIX_API/tasks/TASK_ID                    # 更新
DELETE $AGENTIX_API/tasks/TASK_ID                    # 取消

创建请求体：{ "teamId": "...", "role": "...", "title": "...", "description": "...", "status": "ready", "priority": 1 }

工作进程

GET    $AGENTIX_API/workers?teamId=$TEAM_ID           # 列出（过滤：&status=running）
GET    $AGENTIX_API/workers/WORKER_ID                # 获取详情
POST   $AGENTIX_API/tasks/TASK_ID/run                # 启动工作进程
POST   $AGENTIX_API/tasks/TASK_ID/resume             # 恢复失败的工作进程

事件

GET    $AGENTIX_API/events?teamId=$TEAM_ID&limit=20   # 活动流
GET    $AGENTIX_API/events?teamId=$TEAM_ID&taskId=X   # 特定任务的事件

API 密钥

POST   $AGENTIX_API/api-keys                         # 创建额外密钥

请求体：{ "name": "ci-key" }。返回 {apiKey, customerId} 一次。

文档

agentix.cloud 上的公共端点（非实例特定）：

GET https://agentix.cloud/docs/getting-started    # 人类入门指南
GET https://agentix.cloud/docs/api-reference      # 完整 API 参考
GET https://agentix.cloud/docs                    # 交互式 API 浏览器（Swagger）
GET https://agentix.cloud/openapi.json            # OpenAPI 规范