以下为本文档的中文说明
personal-squad(个人智能体小队)是Bradygaster开发的一款技能,允许用户创建跨项目随身携带的个人级AI智能体集合。与项目智能体(定义在项目.squad/目录中)不同,个人智能体存储在全局配置目录中,并且会在启动squad会话时被自动发现。该技能的核心创新在于引入了’幽灵协议’(Ghost Protocol)机制:个人智能体可以读取项目状态但无法写入,这意味着它们提供建议和指导,而项目智能体负责执行实际修改。这种设计确保了个人智能体的辅助角色不会干扰项目的自有状态管理。目录结构方面,个人小队位于~/.config/squad/personal-squad/(Linux/macOS)或%APPDATA%/squad/personal-squad/(Windows),包含agents子目录(每个智能体有charter.md和history.md文件)以及可选的config.json配置文件。提供的命令包括:squad personal init初始化目录、list列出个人智能体、add添加新智能体、remove移除智能体,以及squad cast查看当前会话的所有成员(项目+个人)。关键的环境变量包括SQUAD_NO_PERSONAL(禁用自动发现)和SQUAD_PERSONAL_DIR(覆盖默认目录路径)。幽灵协议的核心规则包括:个人智能体仅提供建议;不写入项目.squad/状态;日志中有透明的来源标记;冲突时项目智能体优先。配置文件中可以设置默认模型和幽灵协议开关。该技能非常适合需要跨项目保持一致开发习惯和知识积累的开发者。
Personal Squad — Skill Document
What is a Personal Squad?
A personal squad is a user-level collection of AI agents that travel with you across projects. Unlike project agents (defined in a project’s.squad/directory), personal agents live in your global config directory and are automatically discovered when you start a squad session.
Directory Structure
~/.config/squad/personal-squad/ # Linux/macOS %APPDATA%/squad/personal-squad/ # Windows ├── agents/ │ ├── {agent-name}/ │ │ ├── charter.md │ │ └── history.md │ └── ... └── config.json # Optional: personal squad configHow It Works
- Ambient Discovery:When Squad starts a session, it checks for a personal squad directory
- Merge:Personal agents are merged into the session cast alongside project agents
- Ghost Protocol:Personal agents can read project state but not write to it
- Kill Switch:Set
SQUAD_NO_PERSONAL=1to disable ambient discovery
Commands
squad personal init— Bootstrap a personal squad directorysquad personal list— List your personal agentssquad personal add {name} --role {role}— Add a personal agentsquad personal remove {name}— Remove a personal agentsquad cast— Show the current session cast (project + personal)
Ghost Protocol
Seetemplates/ghost-protocol.mdfor the full rules. Key points:
- Personal agents advise; project agents execute
- No writes to project
.squad/state - Transparent origin tagging in logs
- Project agents take precedence on conflicts
Configuration
Optionalconfig.jsonin the personal squad directory:
{"defaultModel":"auto","ghostProtocol":true,"agents":{}}Environment Variables
SQUAD_NO_PERSONAL— Set to any value to disable personal squad discoverySQUAD_PERSONAL_DIR— Override the default personal squad directory path