claude-omo-agentflow: Skill for Claude Code

掌天瓶部署与模式管理

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