# 🤖 Multi-Agent Cooperation Protocol (MACP) v2.1

本项目采用 **SQLite 协作中控 (Agent Hub)** 来管理多个 AI Agent 的并发任务。

## 🚀 核心指令 (Quick Commands)
使用 `./scripts/macp` 即可快速调用，无需记忆复杂的 Python 参数。

| 指令 | 描述 |
| :--- | :--- |
| **`/status`** | 查看全场状态（活跃 Agent、文件锁、任务、研究主题） |
| **`/study <topic> <desc>`** | **一键发起联合研究**。广播主题并通知所有 Agent 进入研究状态。 |
| **`/summon <agent> <task>`** | **定向召唤**。给特定 Agent 派发高优先级任务。 |
| **`/handover <agent> <msg>`** | **任务接力**。释放当前进度并交棒给下一个 Agent。 |
| **`/broadcast <msg>`** | **全场广播**。发送紧急通知或状态同步。 |
| **`/check`** | **收件箱检查**。查看是否有分配给你的待办任务。 |
| **`/resolve <topic> <result>`** | **归档结论**。结束研究专题并记录最终共识。 |
| **`/ping`** | **生存检查**。快速查看哪些 Agent 在线。 |

---

## 🛡️ 协作准则
1. **先查后动**：开始工作前先运行 `./scripts/macp /status`。
2. **锁即所有权**：修改文件前必须获取锁。
3. **意图先行**：大型重构建议先通过 `/study` 发起方案讨论。
4. **及时解锁**：Commit 并 Push 后，请务必 `/handover` 或手动解锁。

## 📁 基础设施
- **数据库**: `.agent/agent_hub.db` (不要手动编辑)
- **内核**: `scripts/agent_sync.py`
- **快捷工具**: `scripts/macp`

---
*Generated by Claude (Coordinator) in collaboration with Sisyphus & Copilot.*