停止。在调用任何端点之前，请完整阅读本 SKILL.MD。
智能体收件箱（Agent Inbox）
基于文件的智能体间消息传递，支持无头调度和任务监控集成。
核心工作流
- 发送：智能体 A 向项目 B 发送错误/请求，附带模型和验证命令
- 分类：AI 分类严重性，调整优先级/模型，路由到项目
- 调度：使用指定模型生成无头智能体来修复问题
- 追踪：任务监控显示实时进度（0% → 25% → 50% → 75% → 100%）
- 验证：测试命令在自动确认前运行——失败则循环回智能体
- 线程：支持多消息对话的回复/交换线程
设置
# 注册项目（一次性操作）
.pi/skills/agent-inbox/agent-inbox register memory /home/user/workspace/memory
.pi/skills/agent-inbox/agent-inbox register scillm /home/user/workspace/litellm
# 列出/检查
.pi/skills/agent-inbox/agent-inbox projects
.pi/skills/agent-inbox/agent-inbox whoami
命令
| 命令 | 描述 |
|---|---|
register <name> <path> | 注册一个项目 |
unregister <name> | 移除一个项目 |
projects [--json] | 列出已注册项目 |
whoami | 显示当前工作目录检测到的项目 |
send --to PROJECT --type TYPE "msg" | 发送消息（类型：bug、request、info、question） |
check [--project P] [--all] [--quiet] | 检查收件箱 |
list [--project P] [--status S] [--json] | 列出消息 |
read MSG_ID [--json] | 读取消息 |
ack MSG_ID [--note "..."] | 确认/完成 |
reply MSG_ID "msg" | 回复（自动创建线程） |
thread THREAD_ID | 查看完整交换线程 |
update-status MSG_ID STATUS [--note] | 手动更新状态 |
triage classify --message "..." [--no-llm] | 手动分类分类 |
triage route --message "..." | 根据文件路径自动路由 |
triage log --msg-id ID | 查看分类决策日志 |
triage webhook-add --url URL --events E | 注册 webhook |
发送选项
| 选项 | 描述 | 默认值 |
|---|---|---|
--model MODEL | AI 模型：sonnet、opus-4.5、codex-5.2、codex-5.2-high | sonnet |
--timeout MINUTES | 智能体最大工作时间 | 30 |
--test COMMAND | 自动确认前的验证命令 | 无 |
--no-dispatch | 禁用自动生成 | False |
--context-file FILE | 附加文件作为上下文（可重复） | 无 |
--priority PRIORITY | low、normal、high、critical | normal |
--no-triage | 跳过 AI 分类 | False |
--dry-run | 显示消息 JSON 但不发送 | False |
模型选择
| 模型 | 用例 |
|---|---|
sonnet | 简单修复、拼写错误 |
opus-4.5 | 复杂分析、架构设计 |
codex-5.2 | 标准错误修复 |
codex-5.2-high | 深度推理、竞态条件 |
AI 分类
消息根据严重性自动分类：
- critical：崩溃、数据丢失、安全、生产宕机 →
opus-4.5 - high：错误、异常、失败、损坏、回归 →
opus-4.5 - medium：错误、问题、不正确、意外 →
sonnet - low：拼写错误、外观、增强、次要 →
sonnet
自动路由从消息中提取文件路径，并与已注册项目匹配。
状态递进
pending → dispatched (25%) → in_progress (50%) → needs_verification (75%) → done (100%)
记忆预挂钩
调度器在生成无头智能体之前查询 /memory，以查找类似的错误和先前的解决方案。
主动检查
智能体应在会话开始时、切换项目时、执行重要工作前以及用户提到另一个智能体或项目时检查收件箱。
存储
~/.agent-inbox/
├── pending/ # 未处理消息
├── done/ # 已确认消息
├── logs/ # 调度日志
├── task_states/ # 任务监控状态文件
├── triage_logs/ # AI 分类决策日志
├── webhooks.json # 已注册 webhook
└── projects.json # 项目注册表
示例
# 发送带有验证的错误（生成无头 Opus 智能体，如果测试通过则自动确认）
python inbox.py send --to scillm --type bug --model opus-4.5 \
--test "pytest tests/test_providers.py -x" \
"提供者初始化中的竞态条件"
# 附加上下文文件
python inbox.py send --to scillm --type bug --model opus-4.5 \
--context-file src/server.py --context-file /tmp/traceback.txt \
"服务器启动时崩溃"
# 检查和处理收件箱
python inbox.py check --all
python inbox.py read scillm_abc123
python inbox.py ack scillm_abc123 --note "在提交 abc123 中修复"
# 线程交换
python inbox.py reply scillm_abc123 "你能提供堆栈跟踪吗？"
python inbox.py thread scillm_abc123
调度器守护进程
python dispatcher.py start # 后台运行
python dispatcher.py start --foreground # 调试模式
python dispatcher.py status
python dispatcher.py stop
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
AGENT_INBOX_DIR | 收件箱目录 | ~/.agent-inbox |
TASK_MONITOR_API_URL | 任务监控 URL | http://localhost:8765 |
CLAUDE_PROJECT | 当前项目名称 | 自动检测 |
与 Claude Code 钩子集成
{
"hooks": {
"on_session_start": [
".pi/skills/agent-inbox/agent-inbox check --project $(basename $PWD) || true"
]
}
}