ClawTeam 仓库开发技能

这个 Skill 能做什么，适合哪些场景？

这是面向 ClawTeam 仓库本身 Contributors 的开发技能，不是普通用户的使用指南。它提供一套引导脚本，把本地 clawteam 命令固定到 ~/.clawteam-venv，并能把仓库技能软链到其他项目的 .agents/.claude 目录。它还给出分层验证策略：先跑 ruff 和针对性 pytest，再升级到 CLI 冒烟测试与 harness 测试。适合在改动 ClawTeam 源码后快速确认多智能体流程仍然端到端可用。

• 运行 scripts/bootstrap_clawteam_dev.sh，创建 ~/.clawteam-venv 固定 uv 环境、安装本仓库（含 dev 依赖）、写入 ~/.local/bin/clawteam 并向 ~/.bashrc 添加 shell 函数
• 运行 scripts/link_local_clawteam_skills.sh /path/to/project，在目标项目内创建 ./.agents/skills/clawteam 与 ./.claude/skills/clawteam 两个软链
• 用 ruff check clawteam/ tests/ 与针对性 pytest 文件做最小验证，改动跨模块时再扩大 pytest 范围
• 通过 spawn-team、task create、spawn、board show、task wait 的组合命令在 tmux 或 subprocess 模式下做真实多智能体冒烟测试
• 用 clawteam harness conduct 命令验证 harness 行为，并用 clawteam team cleanup 清理残留的 tmux 会话与 worktree

如何安装这个 Skill？

本技能位于 ClawTeam 仓库内 .agents/skills/clawteam-dev/，随仓库一起使用，没有独立安装流程。首次使用时在仓库根目录运行引导脚本：

git clone https://github.com/HKUDS/ClawTeam.git
cd ClawTeam
bash scripts/bootstrap_clawteam_dev.sh
source ~/.bashrc
clawteam --version

如何使用这个 Skill？

在 ClawTeam 仓库目录内使用。改完代码先跑最小验证：

ruff check clawteam/ tests/
pytest tests/<target_file>.py -q

改动跨模块时再扩大范围：

pytest tests/test_cli_commands.py -q
pytest tests/test_spawn_backends.py -q
pytest tests/test_harness.py tests/test_event_bus.py -q

需要真实多智能体冒烟测试时：

clawteam team spawn-team dev-smoke -d "Local ClawTeam smoke test" -n leader
clawteam task create dev-smoke "Smoke test worker" -o worker1 -p high
clawteam spawn --team dev-smoke --agent-name worker1 --task "Report your status to leader and mark the task completed when done."
clawteam board show dev-smoke
clawteam task wait dev-smoke --timeout 300 --poll-interval 5
clawteam team cleanup dev-smoke

验证 harness 行为时：

clawteam harness conduct dev-harness --goal "Create a small implementation plan and execute it with one worker" --cli codex --agents 1

这个 Skill 有哪些优点和局限？

这个 Skill 与同类方案有什么区别？

与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。

常见问题