ClawTeam 本地开发技能
面向 ClawTeam 仓库本身的开发技能：标准化本地环境、验证多智能体流程，让对 ClawTeam 的每次改动都能被快速、可靠地验证。
脚本行为在SKILL.md中有明示（写入~/.bashrc、~/.local/bin、创建固定venv），link脚本对非符号链接目标会报错退出，属较好的数据流披露；但bootstrap未经用户确认即修改~/.bashrc并静默覆盖既有符号链接，且未提供回滚/uninstall说明，扣分。
bootstrap脚本有uv缺失的清晰错误提示，幂等处理bashrc块；但link脚本链接到REPO_ROOT/skills/clawteam，与SKILL.md声称的路径(.agents/skills/clawteam)存在未验证的路径假设，静态无法确认关键路径可复现，测试套件未覆盖skill脚本本身，扣分。
受众与边界明确（'repository-development oriented, not a general end-user usage guide'），列出了前置条件（tmux、uv、CLI agent），触发语义清晰；但对失败场景/环境不适用的边界描述有限，无中文环境说明，扣分。
有版本号(0.2.0)、MIT许可证、结构清晰的分层文档；但SKILL.md版本0.2.0与pyproject 0.3.0不一致，无changelog与维护责任声明，路径假设存在隐藏前提，扣分。
作为仓库内开发引导skill目标合理，bootstrap+link+验证流程完整且可直接使用；但静态审查无法验证脚本实际产出，对claude/codex等外部CLI的依赖使收益难以核实，扣分。
仓库含CI工作流与tests/目录（adapters测试覆盖spawn层），但CI与测试不覆盖本skill的脚本路径，关键主张（bootstrap可用、链接路径正确）仅有作者声明，无第三方复现证据，扣分。
- bootstrap脚本会修改~/.bashrc并在~/.local/bin写入启动器，运行前请备份相关文件，目前无官方回滚步骤。
- link脚本链接到REPO_ROOT/skills/clawteam，请先确认该路径在当前checkout中存在，避免生成死链接。
- SKILL.md版本(0.2.0)与pyproject版本(0.3.0)不一致，使用前请核对实际安装版本。
- 静态审查未执行任何脚本；本评估不构成对脚本行为的实际验证。
- 冒烟测试依赖tmux与外部CLI agent（claude/codex），在中国大陆网络环境下相关服务的可达性需自行确认。
这个 Skill 能做什么，适合哪些场景？
clawteam-dev 是 ClawTeam 仓库内置的开发者技能，专门服务于对 ClawTeam 自身的修改、调试与验证。它提供两个引导脚本：一个把仓库安装到固定的 uv 虚拟环境并统一 clawteam 命令，另一个把本仓库的技能目录软链接到其他本地项目。技能还给出分层验证策略（ruff + 定向 pytest），以及用真实 CLI 智能体跑端到端冒烟测试的命令序列。注意：这是面向仓库开发者的技能，不是面向最终用户的使用指南。
运行 scripts/bootstrap_clawteam_dev.sh：创建 ~/.clawteam-venv 固定环境、以 dev 依赖安装当前仓库、写入 ~/.local/bin/clawteam 并向 ~/.bashrc 添加 clawteam() 函数。运行 scripts/link_local_clawteam_skills.sh /path/to/project：在目标项目创建 ./.agents/skills/clawteam 和 ./.claude/skills/clawteam 两个软链接。执行代码检查与测试：ruff check clawteam/ tests/、pytest 定向测试文件或跨模块测试组。运行本地冒烟测试：clawteam team spawn-team、task create、spawn、board show、task wait，以及 clawteam harness conduct 验证 harness 行为。用 clawteam team cleanup 清理测试团队。
- ClawTeam 贡献者在本地修改源码后，需要用最小代价验证改动没有破坏 spawn、board 或 task 流程
- 开发者需要复现一个 spawn / board / task / inbox / harness 相关的 bug 并在当前 checkout 上调试
- 维护者想在多个 Python 环境共存的机器上，让 clawteam 命令始终指向同一个固定环境
- 开发者希望让另一个本地项目直接复用本仓库的 ClawTeam 技能，通过软链接而非复制
- 需要用真实的 CLI 智能体（如 codex）在 tmux 或 subprocess 模式下对多智能体协作做端到端冒烟测试
这个 Skill 有哪些优点和局限？
- bootstrap 脚本一键固定 uv 环境，避免多 Python 环境下 clawteam 命令指向不一致的问题
- 提供明确的分层验证策略：先 ruff + 定向 pytest，再按需升级到端到端测试，节省时间
- 冒烟测试命令完整可复制，覆盖 spawn、task、board、harness 等真实路径
- 软链接脚本让其他本地项目直接复用仓库内最新技能，无需重复安装
- 适用范围窄：只服务于 ClawTeam 仓库本身，不教最终用户如何使用 ClawTeam
- 强依赖 tmux 和 clawteam 命令，且真实 worker 测试需要已安装并单独可运行的 CLI 智能体
- 未提供自动化测试套件本身的质量证据（覆盖率、CI 状态在来源中未提及）
- 崩溃残留的 tmux 会话或 worktree 需要手动检查和显式清理
如何安装这个 Skill？
本技能位于 ClawTeam 仓库的 .agents/skills/clawteam-dev/ 目录，随仓库一同分发。安装整个集合：pip install clawteam，或从源码安装：git clone https://github.com/HKUDS/ClawTeam.git && cd ClawTeam && pip install -e .。前提条件：clawteam 命令可用、安装 tmux；若要生成真实 worker，还需安装 claude 或 codex 等 CLI 智能体。技能文档未单独说明把该技能文件夹复制到其他客户端技能目录的步骤。
如何使用这个 Skill？
在 ClawTeam 仓库内运行 bash scripts/bootstrap_clawteam_dev.sh 初始化固定环境，然后 source ~/.bashrc 并用 clawteam --version 确认。改动代码后运行最小验证：ruff check clawteam/ tests/ 和 pytest tests/<目标文件>.py -q；改动跨模块时再跑更大的测试组（如 test_cli_commands.py、test_spawn_backends.py、test_harness.py）。需要真实工作流验证时，依次执行 team spawn-team、task create、spawn、board show、task wait 的冒烟序列；验证 harness 时使用 clawteam harness conduct dev-harness --goal ... --cli codex --agents 1。结束后用 clawteam team cleanup 清理。
这个 Skill 与同类方案有什么区别？
README 将 ClawTeam 与其他多智能体框架对比（后者需要人类编写编排代码、依赖 Redis/消息队列/Docker，而 ClawTeam 只需文件系统和 tmux、由智能体自身通过 CLI 命令自组织）；但针对本开发技能本身，来源未提及其他同类开发引导工具，故不做进一步对比。