agentleFS
wangjialiang678wangjialiang678/claude-omo-agentflow/.claude/skills/switch-agentflow/SKILL.md

switch-agentflow

Skill2 starsChanged 9 months agoMITView on GitHub

掌天瓶部署与模式管理。当用户说以下内容时自动触发: - "启用掌天瓶"、"开启掌天瓶"、"agentflow on" - "关闭掌天瓶"、"停用掌天瓶"、"agentflow off" - "掌天瓶状态"、"agentflow status" - "部署掌天瓶"、"deploy agentflow" 关键词:启用掌天瓶、关闭掌天瓶、agentflow on、agentflow off、部署掌天瓶

  • Installs packages

The file

Files
SKILL.md

掌天瓶部署与模式管理

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/xxxcp $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.backup

5.3 读取现有配置

用 Read 工具读取目标 settings.json 的完整内容。

如果文件不存在,视为空对象 {}。

5.4 AI 合并逻辑

AI 解析 JSON 后,按以下规则合并:

  1. 保留所有已有字段不动:mcpServers、permissions、env、以及任何其他自定义字段。绝对不要删除或修改它们。
  2. 处理 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 条目不动
    • 如果没有 → 在该事件的数组末尾追加新条目
  3. 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 || true

Step 7: 验证部署

运行验收测试(参考 INSTALL.md 第九节)。向用户报告部署摘要:

部署完成!

范围:[项目级 / 全局级 / 两者]
组件:7 代理 | 3 hooks | 4 流水线 | 2 skills
状态:off(说"启用掌天瓶"开启)

[全局级额外信息]
hooks 路径:/Users/michael/.claude/hooks/(machine-specific)
settings.json 已合并,原有配置已保留
备份:$HOME/.claude/settings.json.backup

卸载

用户说"卸载掌天瓶"时:

  1. 用 AskUserQuestion 确认范围(项目/全局/两者)
  2. 删除对应范围的 agentflow 相关文件
  3. 从 settings.json 中移除 agentflow hooks(同样用 AI 智能操作,保留其他配置)
  4. 告知用户 CLAUDE.md 中的掌天瓶段落需手动决定是否移除

注意事项

  • settings.json 中的 settings.local.json 是用户私有配置,永远不要触碰
  • 全局部署的 hooks 路径是 machine-specific 的,在部署报告中明确标注
  • 项目级和全局级的 mode.txt 相互独立,不会冲突
  • 如果项目有自己的 settings.json hooks,它们会与全局 hooks 同时生效——这是 Claude Code 的正常行为

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.