npx skills add https://github.com/boshu2/agentops --skill shared本目录包含多个技能共用的共享参考文档：
validation-contract.md - 接受衍生工作的验证要求references/claude-code-latest-features.md - Claude Code 功能契约（斜杠命令、智能体隔离、钩子、设置）references/backend-claude-teams.md - Claude 原生团队的具体示例（TeamCreate + SendMessage）references/backend-codex-subagents.md - Codex CLI 和 Codex 子智能体的具体示例references/backend-background-tasks.md - 后备方案：Task(run_in_background=true)广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
references/backend-inline.md - 降级的单智能体模式（无衍生）references/claude-cli-verified-commands.md - 已验证的 Claude CLI 命令格式和注意事项references/codex-cli-verified-commands.md - 已验证的 Codex CLI 命令格式和注意事项references/cli-command-failures-2026-02-26.md - 来自实际运行的带日期标记的失败日志和缓解措施这些不是可直接调用的技能。它们会在需要时被其他技能（council、crank、swarm、research、implement）加载。
所有引用外部 CLI 的技能在 CLI 缺失时必须能够优雅降级。
# 在使用任何外部 CLI 之前，检查其可用性
if command -v bd &>/dev/null; then
# 使用 bd 的完整功能
else
echo "注意：bd CLI 未安装。使用纯文本跟踪。"
# 后备方案：使用 TaskList、纯 Markdown 或跳过
fi
| 功能 | 缺失时 | 后备行为 |
|---|---|---|
bd | 问题跟踪不可用 | 使用 TaskList 进行跟踪。提示"安装 bd 以获取持久化问题跟踪" |
ao | 知识飞轮不可用 | 直接将学习内容写入 .agents/learnings/。跳过飞轮指标 |
gt | 工作空间管理不可用 | 在当前目录工作。跳过 convoy/sling 操作 |
codex | CLI 缺失或模型不可用 | 回退到运行时原生智能体。Council 在预检时检查 CLI 存在性（which codex）和 --mixed 模式的模型可用性。 |
cass | 会话搜索不可用 | 跳过转录搜索。提示"安装 cass 以获取会话历史" |
Council、swarm 和 crank 需要一个提供这些能力的运行时。如果某个能力缺失，相应的功能将降级。
| 能力 | 功能 | 缺失时 |
|---|---|---|
| 衍生子智能体 | 根据提示创建并行智能体 | 无法运行多智能体。回退到 --quick（内联单智能体）。 |
| 智能体间消息传递 | 向特定智能体发送消息 | 无辩论 R2。工作者运行即发即弃模式。 |
| 广播 | 一次性向所有智能体发送消息 | 回退到逐智能体消息传递。 |
| 优雅关闭 | 请求智能体终止 | 智能体在完成后自行终止。 |
| 共享任务列表 | 智能体查看共享工作状态 | 领导者手动跟踪。 |
每个运行时都将其能力映射到自己的 API。技能描述的是做什么，而不是调用哪个工具。
检测到您的后端后（见下文后端检测），加载匹配的参考文档以获取具体的工具调用示例：
| 后端 | 参考文档 |
|---|---|
| Claude 功能契约 | skills/shared/references/claude-code-latest-features.md |
| Claude 原生团队 | skills/shared/references/backend-claude-teams.md |
| Codex 子智能体 / CLI | skills/shared/references/backend-codex-subagents.md |
| 后台任务（后备） | skills/shared/references/backend-background-tasks.md |
| 内联（无衍生） | skills/shared/references/backend-inline.md |
在运行时使用能力检测，而非硬编码的工具名称。同一技能必须在任何提供多智能体原语的智能体框架中都能工作。如果未检测到多智能体能力，则降级到单智能体内联模式（--quick）。
选择策略（运行时原生优先）：
TeamCreate/SendMessage 可用，则使用 Claude 原生团队 作为主要后端。spawn_agent 可用，则使用 Codex 子智能体 作为主要后端。| 操作 | Codex 子智能体 | Claude 原生团队 | OpenCode 子智能体 | 内联后备 |
|---|---|---|---|---|
| 衍生 | spawn_agent(message=...) | TeamCreate + Task(team_name=...) | task(subagent_type="general", prompt=...) | 内联执行 |
| 衍生（只读） | spawn_agent(message=...) | Task(subagent_type="Explore") | task(subagent_type="explore", prompt=...) | 内联执行 |
| 等待 | wait(ids=[...]) | 通过 SendMessage 完成 | 任务直接返回结果 | 不适用 |
| 重试/跟进 | send_input(id=..., message=...) | SendMessage(type="message", ...) | task(task_id="<prior>", prompt=...) | 不适用 |
| 清理 | close_agent(id=...) | shutdown_request + TeamDelete() | 无（子会话自动终止） | 不适用 |
| 智能体间消息传递 | send_input | SendMessage | 不可用 | 不适用 |
| 辩论（R2） | 支持 | 支持 | 不支持（无消息传递） | 不适用 |
OpenCode 限制：
--debate） —— 需要评委间消息传递--quick（内联）模式在所有后端上工作方式相同优先选择原生团队而非后台任务。 原生团队提供消息传递、重定向和优雅关闭。后台任务即发即弃，无法引导——只有速度表和紧急制动。
| 能力 | Codex 子智能体 | Claude 原生团队 | 后台任务 |
|---|---|---|---|
| 观察输出 | wait() 结果 | SendMessage 送达 | TaskOutput（尾部） |
| 中途发送消息 | send_input | SendMessage | 不支持 |
| 暂停 / 恢复 | 不支持 | 空闲 → 通过 SendMessage 唤醒 | 不支持 |
| 优雅停止 | close_agent | shutdown_request | TaskStop（有损） |
| 重定向到不同任务 | send_input | SendMessage | 不支持 |
| 中途调整范围 | send_input | SendMessage | 不支持 |
| 文件冲突预防 | 手动 git worktree 路由 | 原生 isolation: worktree + 仅领导者提交 | 无 |
| 进程隔离 | 支持（子进程） | 共享工作树 | 共享工作树 |
何时使用每种后端：
| 场景 | 后端 |
|---|---|
| 需要协调的快速并行任务 | Claude 原生团队 |
| Codex 特定执行 | Codex 子智能体 |
| 无团队 API 可用（最后手段） | 后台任务 |
链式调用其他技能的技能（例如，/rpi 调用 /research，/vibe 调用 /council）必须处理运行时差异：
| 运行时 | 工具 | 行为 | 模式 |
|---|---|---|---|
| Claude Code | Skill(skill="X", args="...") | 可执行 —— 技能作为子调用运行 | Skill(skill="council", args="--quick validate recent") |
| Codex | 不适用 | 技能不可用 —— 内联逻辑或跳过 | 调用前检查 Skill 工具是否存在 |
| OpenCode | skill 工具（只读） | 仅加载 —— 将 <skill_content> 块加载到上下文中 | 调用 skill(skill="council")，然后内联遵循加载的指令 |
OpenCode 技能链式调用规则：
skill 工具将目标技能的内容加载到上下文中/council）—— 这会触发命令查找，而不是技能加载跨运行时工具映射：
| Claude Code | OpenCode | 说明 |
|---|---|---|
Task(subagent_type="...") | task(subagent_type="...") | 语义相同，大小写不同 |
Skill(skill="X") | skill 工具（只读） | 加载内容，然后内联遵循 |
AskUserQuestion | question | 目的相同，名称不同 |
TaskCreate, TaskUpdate, TaskList, TaskGet | todo | 任务跟踪（Claude 使用 4 个工具，OpenCode 使用 1 个） |
Read, Write, Edit, Bash, Glob, Grep | 相同名称 | 跨运行时相同 |
每周安装量
198
代码库
GitHub 星标数
204
首次出现
2026年2月4日
安全审计
安装于
claude-code196
codex196
opencode195
gemini-cli194
github-copilot194
kimi-cli193
This directory contains shared reference documents used by multiple skills:
validation-contract.md - Verification requirements for accepting spawned workreferences/claude-code-latest-features.md - Claude Code feature contract (slash commands, agent isolation, hooks, settings)references/backend-claude-teams.md - Concrete examples for Claude native teams (TeamCreate + SendMessage)references/backend-codex-subagents.md - Concrete examples for Codex CLI and Codex sub-agentsreferences/backend-background-tasks.md - Fallback: Task(run_in_background=true)references/backend-inline.md - Degraded single-agent mode (no spawn)references/claude-cli-verified-commands.md - Verified Claude CLI command shapes and caveatsreferences/codex-cli-verified-commands.md - Verified Codex CLI command shapes and caveatsreferences/cli-command-failures-2026-02-26.md - Dated failure log and mitigations from live runsThese are not directly invocable skills. They are loaded by other skills (council, crank, swarm, research, implement) when needed.
All skills that reference external CLIs MUST degrade gracefully when those CLIs are absent.
# Before using any external CLI, check availability
if command -v bd &>/dev/null; then
# Full behavior with bd
else
echo "Note: bd CLI not installed. Using plain text tracking."
# Fallback: use TaskList, plain markdown, or skip
fi
| Capability | When Missing | Fallback Behavior |
|---|---|---|
bd | Issue tracking unavailable | Use TaskList for tracking. Note "install bd for persistent issue tracking" |
ao | Knowledge flywheel unavailable | Write learnings to .agents/learnings/ directly. Skip flywheel metrics |
gt | Workspace management unavailable | Work in current directory. Skip convoy/sling operations |
codex | CLI missing or model unavailable | Fall back to runtime-native agents. Council pre-flight checks CLI presence () and model availability for mode. |
Council, swarm, and crank require a runtime that provides these capabilities. If a capability is missing, the corresponding feature degrades.
| Capability | What it does | If missing |
|---|---|---|
| Spawn subagent | Create a parallel agent with a prompt | Cannot run multi-agent. Fall back to --quick (inline single-agent). |
| Agent-to-agent messaging | Send a message to a specific agent | No debate R2. Workers run fire-and-forget. |
| Broadcast | Message all agents at once | Per-agent messaging fallback. |
| Graceful shutdown | Request an agent to terminate | Agents terminate on their own when done. |
| Shared task list | Agents see shared work state | Lead tracks manually. |
Every runtime maps these capabilities to its own API. Skills describe WHAT to do, not WHICH tool to call.
After detecting your backend (see Backend Detection below), load the matching reference for concrete tool call examples:
| Backend | Reference |
|---|---|
| Claude feature contract | skills/shared/references/claude-code-latest-features.md |
| Claude Native Teams | skills/shared/references/backend-claude-teams.md |
| Codex Sub-Agents / CLI | skills/shared/references/backend-codex-subagents.md |
| Background Tasks (fallback) | skills/shared/references/backend-background-tasks.md |
| Inline (no spawn) | skills/shared/references/backend-inline.md |
Use capability detection at runtime, not hardcoded tool names. The same skill must work across any agent harness that provides multi-agent primitives. If no multi-agent capability is detected, degrade to single-agent inline mode (--quick).
Selection policy (runtime-native first):
TeamCreate/SendMessage are available, use Claude Native Teams as the primary backend.spawn_agent is available, use Codex sub-agents as the primary backend.| Operation | Codex Sub-Agents | Claude Native Teams | OpenCode Subagents | Inline Fallback |
|---|---|---|---|---|
| Spawn | spawn_agent(message=...) | TeamCreate + Task(team_name=...) | task(subagent_type="general", prompt=...) | Execute inline |
| Spawn (read-only) | spawn_agent(message=...) | Task(subagent_type="Explore") |
OpenCode limitations:
--debate) — requires messaging between judges--quick (inline) mode works identically across all backendsPrefer native teams over background tasks. Native teams provide messaging, redirect, and graceful shutdown. Background tasks are fire-and-forget with no steering — only a speedometer and emergency brake.
| Capability | Codex Sub-Agents | Claude Native Teams | Background Tasks |
|---|---|---|---|
| Observe output | wait() result | SendMessage delivery | TaskOutput (tail) |
| Send message mid-flight | send_input | SendMessage | NO |
| Pause / resume | NO | Idle → wake via SendMessage |
When to use each:
| Scenario | Backend |
|---|---|
| Quick parallel tasks, coordination needed | Claude Native Teams |
| Codex-specific execution | Codex Sub-Agents |
| No team APIs available (last resort) | Background Tasks |
Skills that chain to other skills (e.g., /rpi calls /research, /vibe calls /council) MUST handle runtime differences:
| Runtime | Tool | Behavior | Pattern |
|---|---|---|---|
| Claude Code | Skill(skill="X", args="...") | Executable — skill runs as a sub-invocation | Skill(skill="council", args="--quick validate recent") |
| Codex | N/A | Skills not available — inline the logic or skip | Check if Skill tool exists before calling |
| OpenCode | skill tool (read-only) | Load-only — returns <skill_content> blocks into context |
OpenCode skill chaining rules:
skill tool to load the target skill's content into context/council) in OpenCode — it triggers a command lookup, not skill loadingCross-runtime tool mapping:
| Claude Code | OpenCode | Notes |
|---|---|---|
Task(subagent_type="...") | task(subagent_type="...") | Same semantics, different casing |
Skill(skill="X") | skill tool (read-only) | Load content, then follow inline |
AskUserQuestion | question | Same purpose, different name |
TaskCreate, , , |
Weekly Installs
198
Repository
GitHub Stars
204
First Seen
Feb 4, 2026
Security Audits
Gen Agent Trust HubWarnSocketPassSnykPass
Installed on
claude-code196
codex196
opencode195
gemini-cli194
github-copilot194
kimi-cli193
AI Elements：基于shadcn/ui的AI原生应用组件库，快速构建对话界面
56,200 周安装
阿里云云防火墙管理技能：使用OpenAPI和SDK自动化安全配置
242 周安装
Salesforce AI 可视化技能：Nano Banana Pro 生成 ERD、架构图与 UI 线框图
242 周安装
发票图像OCR读取技能 - 自动提取结构化数据，支持PDF/图片双重验证
242 周安装
WPS文字智能助手使用指南 - 24个工具解决Word文档排版、格式、目录问题
242 周安装
sdd:brainstorm - 创意协作对话工具，将创意转化为完整设计与规范
242 周安装
阿里云Data Lake Formation管理工具 - 使用OpenAPI和SDK管理数据湖资源
242 周安装
which codex--mixedcass | Session search unavailable | Skip transcript search. Note "install cass for session history" |
task(subagent_type="explore", prompt=...) |
| Execute inline |
| Wait | wait(ids=[...]) | Completion via SendMessage | Task returns result directly | N/A |
| Retry/follow-up | send_input(id=..., message=...) | SendMessage(type="message", ...) | task(task_id="<prior>", prompt=...) | N/A |
| Cleanup | close_agent(id=...) | shutdown_request + TeamDelete() | None (sub-sessions auto-terminate) | N/A |
| Inter-agent messaging | send_input | SendMessage | Not available | N/A |
| Debate (R2) | Supported | Supported | Not supported (no messaging) | N/A |
| NO |
| Graceful stop | close_agent | shutdown_request | TaskStop (lossy) |
| Redirect to different task | send_input | SendMessage | NO |
| Adjust scope mid-flight | send_input | SendMessage | NO |
| File conflict prevention | Manual git worktree routing | Native isolation: worktree + lead-only commits | None |
| Process isolation | YES (sub-process) | Shared worktree | Shared worktree |
Call skill(skill="council"), then follow the loaded instructions inline |
TaskUpdateTaskListTaskGettodo |
| Task tracking (Claude uses 4 tools, OpenCode uses 1) |
Read, Write, Edit, Bash, Glob, Grep | Same names | Identical across runtimes |