Merge remote changes, keeping local version improvements

This commit is contained in:
fujie
2026-03-13 14:58:22 +08:00
12 changed files with 1851 additions and 0 deletions

33
COOPERATION.md Normal file
View File

@@ -0,0 +1,33 @@
# 🤖 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.*