shared

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Shared References

共享参考文档

This directory contains shared reference documents used by multiple skills:

```
agent-mail-protocol.md
```
- Message protocol for distributed mode coordination
```
validation-contract.md
```
- Verification requirements for accepting spawned work

These are not directly invocable skills. They are loaded by other skills (crank, swarm, inbox, implement) when needed for distributed mode operation.

本目录包含多个技能使用的共享参考文档：

```
agent-mail-protocol.md
```
- 分布式模式协调的消息协议
```
validation-contract.md
```
- 接受衍生任务的验证要求

这些并非可直接调用的技能。它们会在分布式模式运行需要时，被其他技能（crank、swarm、inbox、implement）加载。

CLI Availability Pattern

CLI可用性模式

All skills that reference external CLIs MUST degrade gracefully when those CLIs are absent.

所有引用外部CLI的技能在这些CLI缺失时，必须能优雅降级。

Check Pattern

检查模式

bash

undefined

bash

undefined

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

undefined

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

undefined

Fallback Table

回退表

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/knowledge/` 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 Claude-only. Council pre-flight checks both CLI presence ( `which codex` ) and model availability (single test call). Account-type restrictions (e.g. gpt-5.3 on ChatGPT accounts) are caught before spawning agents.
`cass`	Session search unavailable	Skip transcript search. Note "install cass for session history"
Native teams ( `TeamCreate` )	API unavailable	Fall back to `Task(run_in_background=true)` fire-and-forget pattern. Council loses debate-via-message (reverts to R2 re-spawn). Swarm loses retry-via-message (reverts to re-spawn).

功能	缺失时	回退行为
`bd`	问题追踪不可用	使用TaskList进行追踪。提示“安装bd以实现持久化问题追踪”
`ao`	知识飞轮不可用	直接将学习内容写入 `.agents/knowledge/` 。跳过飞轮指标
`gt`	工作区管理不可用	在当前目录工作。跳过convoy/sling操作
`codex`	CLI缺失或模型不可用	回退到仅使用Claude。Council预检查会同时验证CLI存在性（ `which codex` ）和模型可用性（单次测试调用）。账户类型限制（如ChatGPT账户无法使用gpt-5.3）会在衍生Agent前被检测到。
`cass`	会话搜索不可用	跳过对话记录搜索。提示“安装cass以查看会话历史”
原生团队（ `TeamCreate` ）	API不可用	回退到 `Task(run_in_background=true)` 即发即弃模式。Council将失去通过消息辩论的功能（恢复为R2重新衍生）。Swarm将失去通过消息重试的功能（恢复为重新衍生）。

Rules

规则

Never crash — missing CLI = skip or fallback, not error
Always inform — tell the user what was skipped and how to enable it
Preserve core function — the skill's primary purpose must still work without optional CLIs
Progressive enhancement — CLIs add capabilities, their absence removes them cleanly

绝不崩溃 —— CLI缺失时应跳过或回退，而非报错
始终告知 —— 告知用户跳过了什么以及如何启用该功能
保留核心功能 —— 即使没有可选CLI，技能的主要用途仍需正常工作
渐进式增强 —— CLI用于添加功能，其缺失应能干净地移除这些功能