智能体协会 agent-guild v3.1.0 — Protocol 3.0

从「文档协议」变成「自举系统」

3.0 之前，协议能描述 agent 该做什么，但没有任何机制让它真的发生。这一版把它变成了会自己长起来的系统。

新增 CLI 能力（scripts/ag.py，纯 stdlib，Windows / macOS / Linux 通用）

命令	作用
ag init	首次使用时自举 ~/.agent-guild/。完全幂等，只补缺失项，绝不覆盖已有数据
ag adopt	自检本机 agent home，把散落的 skill / skills_data / mcp / tools / memory 收进协会并软链回去。默认 dry-run；--apply 会逐项验证链接，失败自动回滚，删除进系统废纸篓
ag bootstrap	一条命令读全共享上下文（身份、戒律、项目、焦点、收件箱），不用手工开五个文件
ag doctor	悬空链接、核心文件缺失、JSON 损坏、registry 漂移、协议大版本漂移

约束力：强制会话契约

SKILL.md 新增 Mandatory Session Contract（M0–M4）：自举协会 → 干活前读共享上下文 → 实质工作后沉淀记忆 → 新 skill/数据归置进协会 → 定期自检收编。

触发词按会话阶段拆分（session start / session end / maintenance），让 agent 在对的时机触发，而不是等用户点名。

约定层从「非规范、可随意忽略」升级为 default-on，只留一个明确豁免口：runtime 强制私有路径，在 registry 里记录原因即可。

跨平台与包容性

• Windows PowerShell 快速接入通道；链接策略 symlink → junction → hardlink 逐级降级
• 废纸篓支持 trash / trash-put / gio trash / 回收站，全都不可用时落到内部 .trash/——任何删除都可恢复
• Python 3.8+（from __future__ import annotations）
• host-wired skill 改为按内容检测，不再硬编码厂商名单；另加用户可编辑的 .adoptignore
• 文档去厂商化：示例覆盖 CLI agent、IDE 分支、桌面助手、沙箱/移动端；补全「无 shell / 无 Python」的纯文件路径

⚠️ 破坏性变更

• protocol_version 2.0 → 3.0，已注册的 agent 需要重跑 ONBOARDING.md（ag doctor 会明确报出来）
• CLI 更名 ac → ag，ac.py 直接删除，安装器会在升级时清理旧文件
• 中心目录新增 memory/（memory/<agent>/ + memory/shared/）

安装

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/dqsjqian/agent-guild/main/scripts/install.sh | bash

# Windows PowerShell
iwr -useb https://raw.githubusercontent.com/dqsjqian/agent-guild/main/scripts/install.ps1 | iex

装完把这句发给你的 AI：Read ~/.agent-guild/ONBOARDING.md