iFlow CLI、Git 与 Claude Code 使用指南

工作流 (Workflow)

类似插件的完整工作流程。安装后使用反斜杠调用。

安装：

iflow workflow add "ppt-generator-v3"

使用：

iflow /ppt-generator

打包验证：

zip -r your-workflow-name.zip . -x your-workflow-name.zip
unzip -l your-workflow-name.zip

目录结构：

项目根目录/
├── .iflow/
│   ├── agents/       # 智能体配置文件夹
│   ├── commands/     # 自定义命令文件夹
│   ├── hooks/        # 自定义触发器
│   ├── IFLOW.md      # 详细的工作流文档
│   └── settings.json # mcp 相关配置
├── [项目文件夹]/     # 您的项目文件和代码
└── IFLOW.md          # 工作流配置和说明文件

智能体 (Agents)

类似 Agent 系统，使用 $ 后选择 agent 运行。

示例配置：

---
agent-type: card-drawer
name: card-drawer
description: 当需要实现游戏内随机抽卡机制时使用此智能体
when-to-use: 当需要实现游戏内随机抽卡机制时
allowed-tools: read_file
model: qwen3-32b
inherit-mcps: true
color: purple
---
你是游戏抽卡系统专家...

技能 (Skills)

Skill 是技能市场系统，允许从在线市场安装专业化技能包来扩展 CLI 功能。

优势：

• 市场化：技能库完整功能即插即用
• 灵活权限控制：~/.iflow/skills/ 全局可用，{project}/.iflow/skills 仅当前项目可用
• 版本追踪

目录结构：

~/.iflow/skills/
├── algorithmic-art/
│   ├── SKILL.md      # 技能主文件（必需）
│   ├── LICENSE.txt
│   └── templates/    # 资源目录
└── pdf/
    ├── SKILL.md
    └── scripts/      # 脚本目录

事件触发器 (Hooks)

用于定时或特定操作后触发消息通知、自动格式化、日志记录等。

配置示例：

{
  "hooks": {
    "SessionStart": [{"matcher": "startup", "hooks": [{"type": "command", "command": "python3 ~/.iflow/hooks/session_start.py"}]}],
    "UserPromptSubmit": [{"hooks": [{"type": "command", "command": "python3 ~/.iflow/hooks/content_filter.py", "timeout": 10}]}]
  }
}

敏感文件保护 Hook 示例：

#!/usr/bin/env python3
import json, sys
try:
    data = json.load(sys.stdin)
except json.JSONDecodeError as e:
    print(f"Error: {e}", file=sys.stderr)
    sys.exit(1)

tool_input = data.get('tool_input', {})
path = tool_input.get('file_path', '') or tool_input.get('command', '')
sensitive_files = ['.env', 'package-lock.json', '.git/']

matched = [p for p in sensitive_files if p in path]
if matched:
    error_message = f"⚠️ 安全保护：禁止操作敏感文件/目录\n检测到操作涉及敏感内容：{', '.join(matched)}"
    print(error_message, file=sys.stderr)
    sys.exit(2)
sys.exit(0)

Git 版本控制

基本操作

1. 克隆： git clone URL 或 git clone -b pre URL folder
2. 编辑： 修改工作副本
3. 检查： git add 文件/目录/.
4. 提交推送： git commit -m '注释', git push origin 新分支
5. 拉取最新： git pull origin main
6. 合并： git merge 新分支
7. 删除分支： git branch -d new_branch 或 git push origin --delete new_branch

分支管理

• 查看本地分支： git branch
• 查看远程分支： git branch -r
• 查看所有分支： git branch -a
• 创建并切换： git checkout -b feature-branch
• 切换分支： git checkout branchname
• 强制删除分支： git branch -D branchname

冲突解决

两个分支在同一个文件和同一个位置有不同修改时，会产生冲突。

处理步骤：

1. 切换到 master 分支：git checkout master
2. 尝试合并：git merge hot-fix
3. 若报错，手动编辑文件，保留需要的代码，删除冲突标记（<<<<<<<, =======, >>>>>>>）。
4. 标记解决：git add 文件
5. 提交：git commit -m "merge test"

Claude Code 配置

环境配置

温度 (temperature)： 0.7 为平衡，0.3 为精确。 最大输出 (maxTokens)： 限制输出长度。 API 端点 (baseURL)： API 地址。

配置文件示例：

{
  "models": {
    "deepseek-chat": {
      "provider": "openai-compatible",
      "apiKey": "${DEEPSEEK_API_KEY}",
      "baseURL": "https://api.deepseek.com/v1",
      "model": "deepseek-chat",
      "temperature": 0.7,
      "maxTokens": 4096
    }
  },
  "defaultModel": "deepseek-chat"
}

交互模式

• ASK 模式： 只看不动，只读分析
• Plan 模式： 只规划不执行
• Edit 模式： 直接执行

常用命令：

• /help: 查看所有命令
• /cost: 查看当前会话消耗
• /compact: 压缩上下文
• /reset: 重置会话
• /review: 代码审查

插件与技能

插件结构：

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── commands/
├── agents/
├── skills/
├── hooks/
└── .mcp.json

Skill 定义： 本质是 md 文件，包含元数据、指令、参考示例。

---
name: your-skill-name
description: What it does and when Claude should use it
---
## Instructions
Clear, concrete, actionable rules.

钩子 (Hooks)

用于自动化操作，如权限管控、日志记录、代码规范校验。

配置位置：

• 全局：~/.claude/settings.json
• 项目：.claude/settings.local.json

事件类型：

• PreToolUse: 工具调用前（拦截敏感文件）
• PostToolUse: 工具调用后（格式化代码）
• Notification: 发送通知时
• SessionStart/End: 会话开始/结束

JSON 输出控制： 退出代码 0 表示成功，2 表示阻止操作。 可通过 stdout 返回 JSON 实现精细化控制（如 continue, stopReason）。

实战案例

项目初始化

创建一个新的 React 项目，使用 Vite 作为构建工具。

步骤：

1. 使用 Vite 创建 React 项目
2. 集成 Tailwind CSS
3. 添加必要的依赖（如 html2canvas）
4. 创建清晰的文件夹结构

目录结构：

src/
├── components/
│   ├── NewsCard.jsx
│   ├── NewsCardEditor.jsx
│   └── ExportButton.jsx
├── utils/
│   └── exportImage.js
├── App.jsx
└── main.jsx

配置 Tailwind CSS： 修改 tailwind.config.js，添加自定义颜色、字体和阴影效果。 修改 src/index.css，导入 Tailwind 和字体。

组件开发：

• NewsCard: 新闻卡片组件，包含标题、摘要、作者等信息，使用 Tailwind 类名体现排版美学。
• NewsCardEditor: 左侧表单编辑，右侧实时预览，支持图片拖拽上传。
• ExportButton: 使用 html2canvas 导出卡片为 PNG，显示加载状态。

发布优化建议：

• 时间优化：工作日 12:00-13:00, 20:00-22:00；周末 10:00-12:00, 15:00-17:00。
• 内容优化：A/B 测试不同标题，监控首小时数据。
• 运营策略：发布后 30 分钟内回复评论，引导用户互动。