Why This Exists
AI coding sessions fail teams in boring ways: context is lost, TODO ownership is unclear, docs drift, and handoffs become chat archaeology. team-collab-skills turns the operating rules into reusable agent runtime artifacts:
- State quartet:
CURRENT.md, NEXT.md, RISKS.md, TODO.md
- Session rituals:
$checkpoint during long work, $handoff <topic> at the end
- TODO ownership: explicit
@owner claim mechanics to avoid parallel-agent races
- Docs governance: code changes go through PR/MR, shared docs go through docs MR, personal records stay under
开发记录/<用户名>/
- Multi-agent support: native Claude/Codex packaging plus thin adapters for mainstream IDE/CLI tools
The human playbook and npm CLI live in embodot/team-collab-playbook. This repository is the agent runtime source of truth.
Quick Start
Claude Code
claude plugin marketplace add dadwadw233/team-collab-skills
claude plugin install team-collab@team-collab-skills
Claude loads the protocol as team-collab:team-collab-protocol when a strong team-project signal is present, such as obsidian-docs/, project AGENTS.md, CURRENT/NEXT/RISKS/TODO references, or explicit handoff/checkpoint/docs-governance requests.
Codex CLI
codex plugin marketplace add https://github.com/dadwadw233/team-collab-skills.git
Codex entrypoints:
$checkpoint
$handoff <topic>
Codex may not support arbitrary custom top-level /handoff slash commands. If /handoff or /checkpoint reaches the model as plain text, the global/project AGENTS.md pointer should treat it as equivalent to the $... form.
Team CLI Installer
If your team uses the playbook package:
npm install -g @embodot/collab@latest
team-collab install-skills --agent all --force
team-collab doctor --project <project>
Adapter Matrix
| Tool | Native shape | Files shipped here | Install strategy |
|---|
| Claude Code | Plugin marketplace + skills | .claude-plugin/marketplace.json, .claude-plugin/plugin.json, skills/*/SKILL.md | claude plugin marketplace add dadwadw233/team-collab-skills |
| Codex CLI | Marketplace + plugin manifest | .agents/plugins/marketplace.json, .codex-plugin/plugin.json, skills/* | codex plugin marketplace add https://github.com/dadwadw233/team-collab-skills.git |
| Cursor | Project rules | adapters/cursor/.cursor/rules/team-collab.mdc | Copy into project when Cursor is used |
| VS Code / Copilot | Custom instructions | adapters/vscode/.github/copilot-instructions.md, .github/instructions/team-collab.instructions.md | Copy into project when Copilot is used |
| Cline | Workspace rules | adapters/cline/.clinerules/team-collab.md | Copy into project when Cline is used |
| OpenCode | AGENTS.md + opencode.json instructions | adapters/opencode/AGENTS.md, adapters/opencode/opencode.json | Prefer root AGENTS.md; use opencode.json for explicit references |
| Continue | Local rules | adapters/continue/.continue/rules/team-collab.md | Copy into .continue/rules/ |
| Gemini CLI | GEMINI.md + custom commands | adapters/gemini/GEMINI.md, .gemini/commands/*.toml | Copy into project for /handoff and /checkpoint commands |
| Manual | Markdown + shell helper | skills/protocol/SKILL.md, skills/protocol/scripts/handoff-manual.sh | Read and run manually if no skill-native agent is available |
Adapter files are intentionally thin pointers. Do not fork the protocol into every tool-specific rule file; keep skills/protocol/SKILL.md and skills/protocol/references/ as the source of truth.
Context Budget
