switch-agentflow
Skill2 starsChanged 9 months agoMITView on GitHub
掌天瓶部署与模式管理。当用户说以下内容时自动触发: - "启用掌天瓶"、"开启掌天瓶"、"agentflow on" - "关闭掌天瓶"、"停用掌天瓶"、"agentflow off" - "掌天瓶状态"、"agentflow status" - "部署掌天瓶"、"deploy agentflow" 关键词:启用掌天瓶、关闭掌天瓶、agentflow on、agentflow off、部署掌天瓶
- Installs packages
In this repository3 other files it gives its agents.
- .claude/agentflow/agents.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- agentflowSkill
The file
Files
掌天瓶部署与模式管理
Step 0: 检测部署状态
用 Bash 检查两个位置(一条命令):
echo "project:$(test -f .claude/agentflow/state/mode.txt && cat .claude/agentflow/state/mode.txt || echo 'NOT_DEPLOYED')" && echo "global:$(test -f "$HOME/.claude/agentflow/state/mode.txt" && cat "$HOME/.claude/agentflow/state/mode.txt" || echo 'NOT_DEPLOYED')"根据结果分流:
| 项目级 | 全局级 | → 行为 |
| 已部署 | 已部署 | 双范围模式 → 切换/状态时询问操作哪个范围 |
| 已部署 | 未部署 | 仅项目 → 直接操作项目 mode.txt |
| 未部署 | 已部署 | 仅全局 → 直接操作全局 mode.txt |
| 未部署 | 未部署 | 未部署 → 进入部署流程(Step 1) |
模式切换(已部署时)
单范围
- 启用:写入
on到对应mode.txt - 关闭:写入
off到对应mode.txt - 状态:读取并报告
双范围
用 AskUserQuestion 询问:
掌天瓶在项目和全局都已部署。要操作哪个?
A. 当前项目
B. 全局(影响所有项目)
C. 两个都切换状态查询
无论哪种情况,status 命令应显示所有已部署范围的状态:
掌天瓶状态:
- 项目级:on(.claude/agentflow/state/mode.txt)
- 全局级:off(~/.claude/agentflow/state/mode.txt)部署流程(未部署时)
Step 1: 询问部署范围
用 AskUserQuestion 询问:
掌天瓶尚未部署。请选择部署范围:
A. 当前项目(推荐)
- 仅对本项目生效
- hooks 使用相对路径,可移植
B. 全局
- 对所有项目生效
- hooks 使用绝对路径(machine-specific)
C. 两者都部署
- 各自独立的 mode.txt 控制记录用户选择,后续步骤根据范围调整目标路径。
Step 2: 环境检查
用 Bash 执行:
# 1. jq 是否安装(必需)
command -v jq >/dev/null 2>&1 && echo "jq: OK" || echo "jq: MISSING — brew install jq"
# 2. 目标目录写权限
test -w "${TARGET_DIR}" && echo "write: OK" || echo "write: NO_PERMISSION"其中 TARGET_DIR:
- 项目级 = 当前工作目录
- 全局级 =
$HOME
如果 jq 缺失,告知用户安装方法并等待确认后继续。 如果权限不足,报告并停止。
Step 3: 确认源码路径
自动检测:检查当前项目是否就是 agentflow 源码仓库:
# 检查标志文件
test -f AI-DEPLOY.md && test -f .claude/agentflow/agents.md && echo "IS_SOURCE_REPO" || echo "NOT_SOURCE_REPO"- 如果是源码仓库:
- 项目级部署:无需复制,文件已在位,只需初始化状态文件和配置 settings.json
- 全局级部署:从当前项目复制到
$HOME/.claude/
- 如果不是源码仓库:
- 用 AskUserQuestion 询问源码路径
- 如果用户没有,引导克隆:
git clone https://github.com/wangjialiang678/claude-omo-agentflow.git
Step 4: 复制文件
读取源码仓库中的 AI-DEPLOY.md,按其 Step 3-5 的文件清单执行复制。
关键区别:
| 项目级 | 全局级 | |
| 目标根目录 | 当前工作目录 | $HOME |
| .claude/ 位置 | <project>/.claude/ | $HOME/.claude/ |
| 复制方式 | cp $SOURCE/.claude/xxx .claude/xxx | cp $SOURCE/.claude/xxx $HOME/.claude/xxx |
注意:
- 复制前检查目标文件是否已存在。如果存在,告知用户并询问是否覆盖
- 全局部署时,不要覆盖
$HOME/.claude/下已有的非 agentflow 文件(如commands/、settings.local.json等) - 只复制 agentflow 相关的目录和文件
Step 5: 配置 settings.json(AI 智能合并)
这是最关键的步骤。必须由 AI 亲自执行,不要用 jq 一行命令合并。
5.1 确定目标文件和 hook 路径
| 范围 | settings.json 路径 | hook command 前缀 |
| 项目级 | .claude/settings.json | .claude/hooks/ |
| 全局级 | $HOME/.claude/settings.json | <绝对路径>/.claude/hooks/ |
全局级的绝对路径,用 Bash 获取:
echo "$HOME/.claude/hooks"将输出(如 /Users/michael/.claude/hooks)作为 hook command 的路径前缀。
5.2 备份
如果目标 settings.json 已存在,先备份:
cp <target>/settings.json <target>/settings.json.backup5.3 读取现有配置
用 Read 工具读取目标 settings.json 的完整内容。
如果文件不存在,视为空对象 {}。
5.4 AI 合并逻辑
AI 解析 JSON 后,按以下规则合并:
- 保留所有已有字段不动:
mcpServers、permissions、env、以及任何其他自定义字段。绝对不要删除或修改它们。 处理 hooks 字段:
对于三个事件(
Stop、SubagentStop、PreCompact),逐一处理:a. 如果 settings.json 中没有
hooks字段 → 添加完整的 hooks 对象b. 如果有
hooks字段但没有对应事件键(如没有Stop)→ 添加该事件c. 如果有对应事件键 → 检查其 hooks 数组中是否已包含 agentflow hook:
- 识别方法:
command字段同时满足:包含hooks/且包含stop.sh(或subagent-stop.sh、pre-compact.sh) - 如果已有 → 更新该条目的 command 路径(适配当前范围的路径格式),保留其他非 agentflow 条目不动
- 如果没有 → 在该事件的数组末尾追加新条目
- 识别方法:
Hook 条目模板(以 Stop 为例):
项目级:
{"hooks": [{"type": "command", "command": ".claude/hooks/stop.sh", "timeout": 10}]}全局级(假设 $HOME = /Users/michael):
{"hooks": [{"type": "command", "command": "/Users/michael/.claude/hooks/stop.sh", "timeout": 10}]}
5.5 写入
用 Write 工具写入合并后的完整 JSON(美化格式,2 空格缩进)。
5.6 验证
写入后,用 Bash 验证 JSON 合法性:
jq '.' <target>/settings.json >/dev/null 2>&1 && echo "JSON_VALID" || echo "JSON_INVALID"如果无效,从 backup 恢复并报告错误。
Step 6: 初始化状态文件
TARGET=".claude" # 或 "$HOME/.claude"(全局)
echo '{"active":false}' > "$TARGET/agentflow/state/workflow-state.json"
echo '{"pool_id":"empty","tasks":[]}' > "$TARGET/agentflow/tasks/task-pool.json"
echo "off" > "$TARGET/agentflow/state/mode.txt"
# 设置执行权限
chmod +x "$TARGET/hooks/"*.sh
chmod +x "$TARGET/hooks/lib/"*.sh
chmod +x "$TARGET/agentflow/scripts/"*.sh
chmod +x "$TARGET/agentflow/scripts/lib/"*.sh 2>/dev/null || trueStep 7: 验证部署
运行验收测试(参考 INSTALL.md 第九节)。向用户报告部署摘要:
部署完成!
范围:[项目级 / 全局级 / 两者]
组件:7 代理 | 3 hooks | 4 流水线 | 2 skills
状态:off(说"启用掌天瓶"开启)
[全局级额外信息]
hooks 路径:/Users/michael/.claude/hooks/(machine-specific)
settings.json 已合并,原有配置已保留
备份:$HOME/.claude/settings.json.backup卸载
用户说"卸载掌天瓶"时:
- 用 AskUserQuestion 确认范围(项目/全局/两者)
- 删除对应范围的 agentflow 相关文件
- 从 settings.json 中移除 agentflow hooks(同样用 AI 智能操作,保留其他配置)
- 告知用户 CLAUDE.md 中的掌天瓶段落需手动决定是否移除
注意事项
- settings.json 中的
settings.local.json是用户私有配置,永远不要触碰 - 全局部署的 hooks 路径是 machine-specific 的,在部署报告中明确标注
- 项目级和全局级的 mode.txt 相互独立,不会冲突
- 如果项目有自己的 settings.json hooks,它们会与全局 hooks 同时生效——这是 Claude Code 的正常行为
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

