SuperAPI AI 工具集

git-coworker-check

部署与运维

查看项目

更新于 10-15 23:49

技能介绍

用途:在共享的 Git 克隆中检测是否有其他代理或进程正在同一仓库工作,并在执行可能摧毁其未提交更改的破坏性操作前告警。适用时机包括:在可能已被占用的克隆中启动会话、准备运行 git stash / git reset --hard / git checkout -- . 、git status 出现自己未改动的文件、开始批量编辑或循环提交前、以及发生冲突后需要恢复时。若会话可控并可用 git worktree add ../<task> 隔离,则建议改用工件树。

主要能力:提供三种模式,默认 --check 只运行检测并报告结论,不写任何内容;--claim 写入会话标记与基线快照,通常在会话开始时运行;--release 移除本会话的标记与基线,通常在退出时运行。检测依据六类独立信号:标记文件、进程扫描、taskwarrior 声明、工作树泄漏、bare 翻转、以及基线漂移。任一 MARKER_COUNT、PROC_COUNT 或 TW_CLAIM_COUNT 大于零即判定 coworker_detected;WORKTREE_LEAK_COUNT 非零判定 worktree_leak_suspected;BARE_FLIP_COUNT 非零判定 bare_flip_suspected 并优先处理。

使用方式:claim 与 release 分别调用 bash ${CLAUDE_SKILL_DIR}/scripts/claim-session.sh --project-dir "$(pwd)" 与 bash ${CLAUDE_SKILL_DIR}/scripts/release-session.sh --project-dir "$(pwd)"。检测调用 bash ${CLAUDE_SKILL_DIR}/scripts/detect-coworkers.sh --project-dir "$(pwd)" --self-agent claude-${CLAUDE_SESSION_ID:0:8},可附加 --baseline-status 与 --baseline-stash。taskwarrior 信号为尽力而为,缺少 task 或 jq 时报告 TW_SCAN_METHOD=unavailable。结论含 clear、drift_detected、worktree_leak_suspected、bare_flip_suspected、coworker_detected。

限制与注意:仅当资料足够时展开,本资料未说明支持的操作系统、安装方式、版本与收费情况,暂未提供。出现 drift_detected 或 coworker_detected 时不应执行 git stash、git reset --hard、git checkout -- . 或 git clean,只应暂存明确路径并询问用户或改用 worktree。bare 翻转需先运行 git config core.bare false、unset GIT_DIR GIT_WORK_TREE,并可用 git reflog -20、git fsck --unreachable、git worktree list、git branch -a 尝试恢复。未跟踪文件被并发切换删除后不可从 reflog 恢复,故建议尽早提交。