首页 › 龙虾技能列表 › fast-claude-code — 技能工具

⚡ fast-claude-code — 技能工具

v1.0.5

Claude Code 任务完成回调 Runtime。支持 Single / Interactive / Team 三种模式， ⚠️ 任务在后台 tmux 会话中运行，完成后通过 System Event 自动通知，无需轮询。 Use when: 需要运行 Claude Code 任务并在完成时获得通知。 NOT...

1· 257·0 当前·0 累计
by @deadlining (DeadLining)·MIT-0
下载技能包
License
MIT-0
最后更新
2026/4/14
安全扫描
VirusTotal
可疑
查看报告
OpenClaw
可疑
medium confidence
The skill mostly does what it says (run Claude Code in tmux and notify on completion) but contains several surprising behaviors and small inconsistencies—most importantly it installs hooks into your project, auto-bypasses Claude permission prompts, and can send project output/file lists to external callbacks—so review before use.
评估建议
What to check before installing/using: - Review callback targets: examine what callback backend you'll use (openclaw, webhook, ntfy). webhook mode will POST JSON to any URL you supply or CC_WEBHOOK_URL—do not point this to untrusted endpoints. Prefer the platform's internal gateway (openclaw) if you want to avoid sending data to external servers. - Understand file writes and reads: team mode installs .claude/hooks/on-stop.sh and edits .claude/settings.json in your project. The on-stop hook enu...
详细分析 ▾
ℹ 用途与能力
Name/description align with the implementation: scripts start Claude in tmux, monitor for a completion marker, and trigger callbacks. Required binaries (bash, claude, tmux) match the stated purpose. Minor inconsistency: SKILL.md metadata lists jq as optional but team.sh exits if jq is not present (team mode effectively requires jq).
⚠ 指令范围
The runtime instructions and scripts do more than just 'start Claude and notify': team mode writes .claude/hooks/on-stop.sh into the project, updates .claude/settings.json, captures tmux output, enumerates (and reports) up to 20 files from the project tree, and then triggers callbacks. Interactive modes force a persistent protocol that tells Claude to always emit CC_CALLBACK_DONE after every response. The scripts also attempt to auto-accept dangerous permission prompts by sending keystrokes into the tmux session. These behaviors expand the skill's access (file system, modifying repo metadata/hooks, automated permission bypass) beyond a minimal 'run-and-notify' surface and are worthy of caution.
✓ 安装机制
No external download/install mechanism is used (instruction-only with bundled scripts). That reduces supply-chain risk. The skill does write files into the user's project directory at runtime (hooks and settings in .claude), which is expected for the feature but remains a write-to-disk action the user should be aware of.
⚠ 凭证需求
The skill does not declare required env vars, but it expects/uses several external endpoints and values: a required --session-key argument (OpenClaw gateway session key) and optional CC_WEBHOOK_URL / NTFY server for callbacks. Callbacks (openclaw/webhook/ntfy) cause data to be sent off-host; webhook.sh will POST JSON to whatever WEBHOOK_URL is provided (via arg or CC_WEBHOOK_URL). The on-stop hook aggregates and sends a project file listing (and could be extended to include content) to the configured callback—this is proportionate for a 'callback' tool but introduces exfiltration risk if the callback endpoint is untrusted. Also the code encourages setting CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 and uses --dangerously-skip-permissions (auto mode), which escalates what Claude is allowed to do. Finally, the jq dependency is treated inconsistently (optional in metadata, required by team.sh).
ℹ 持久化与权限
The skill does not request always:true and does not modify other skills or global agent settings. However, it writes and later removes hooks and settings within the project's .claude directory and creates persistent tmux sessions. It also attempts to auto-accept permission prompts, which increases the blast radius if used in 'auto' mode. The ability to create hooks that run on Claude stop and to enumerate project files is a persistent capability within the project scope—expected for the feature but privilege-worthy to acknowledge.
安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

运行时依赖

🖥️ OSmacOS · Linux

版本

latestv1.0.52026/3/15

- No changes detected in this version; documentation and functionality remain the same as previous release. - All usage instructions, parameters, and mode guidelines are unchanged. - There are no updates to features or requirements in v1.0.5.

● 可疑

安装命令 点击复制

官方npx clawhub@latest install fast-claude-code
镜像加速npx clawhub@latest install fast-claude-code --registry https://cn.clawhub-mirror.com

技能文档

Claude Code 任务完成自动通知 Runtime。任务在后台 tmux 会话中运行，完成后通过 System Event 自动回调。

⚠️ IMPORTANT: Entry Point

必须使用 bin/fast-claude-code.sh 作为入口！

  • ✅ 正确：bin/fast-claude-code.sh team --project "/path" --template "xxx" --task "xxx"
  • ❌ 错误：直接调用 bin/send-task.sh 或 modes/team.sh
  • ❌ 错误：直接使用 tmux 命令

所有操作都通过 fast-claude-code.sh 分发，它会：

  • 启动正确的 tmux 会话
  • 安装完成检测机制
  • 等待回调通知

Use When

  • 需要运行 Claude Code 任务并获得完成通知
  • 需要多 Agent 协作完成复杂任务（Team 模式）
  • 需要长时间运行的 Claude Code 会话（Interactive 模式）

NOT For

  • 简单的文件读写（直接用 read/write 工具）
  • 单次简单命令执行

Quick Start

# Single 模式 - 一次性任务
bin/fast-claude-code.sh single --task "任务描述" --project "/path/to/project"
# Interactive 模式 - 多轮对话
# - 开启
bin/fast-claude-code.sh interactive --project "/path" --label "session-name" --task "任务描述"
# - 后续（使用 send-task，不要直接用 tmux）
bin/fast-claude-code.sh send-task --session "session-name" --task "任务描述"
# Team 模式 - 多 Agent 协作
bin/fast-claude-code.sh team --project "/path" --template "模板" --task "任务描述"

Modes

ModeUse ForRequired Params
single单文件重构、简单代码审查、一次性分析--task, --project
interactive长时运行任务、需要多轮对话、需要人工干预--project, --label
team复杂代码审查、架构决策、性能分析、多 Agent 协作--project, --template, --task

Mode Decision Guide

用户任务需要 Claude Code？
├─ 是 → 任务类型？
│   ├─ 一次性（单文件/简单操作）→ Single
│   ├─ 需要多轮对话/长时间 → Interactive
│   └─ 需要多 Agent 协作/复杂分析 → Team
└─ 否 → 不使用此 skill

Team Templates

TemplateUse ForKeywords
parallel-review代码审查、安全检查、性能测试审查、安全、性能、测试
competing-hypotheses问题诊断、调试、找原因调试、问题、原因、为什么
fullstack-feature全栈功能开发开发、实现、功能、全栈
architecture-decision架构决策、技术选型架构、选择、对比、决策
bottleneck-analysis性能瓶颈分析慢、性能、瓶颈、优化
inventory-classification批量分类、批量分析分析、分类、评估

Parameters

ParameterModeDescription
--taskSingle/Team任务描述
--projectAll项目路径（必须）
--labelInteractive会话标识符
--templateTeam模板名称
--permission-modeAllauto（默认）或 plan
--sessionsend-task会话名
--callbackAll回调类型（默认 openclaw）

Settings

Timeout（Team 模式）

复杂度超时场景
简单默认 1h单文件、单模块
中等默认 1h少量文件、标准任务
复杂7200（2h）多模块、跨功能
超复杂10800（3h）全项目、架构级
TEAM_TIMEOUT=7200 bin/fast-claude-code.sh team --project "/path" --template "xxx" --task "xxx"

环境变量

  • TEAM_TIMEOUT：Team 模式超时时间（秒）
  • CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1：Team 模式必须设置

Examples

# 重构单个文件
bin/fast-claude-code.sh single --task "重构 auth.js 的 JWT 逻辑" --project "/my/project"
# 安全审查（多视角）
bin/fast-claude-code.sh team --project "/my/project" --template "parallel-review" --task "审查安全性"
# 架构决策
bin/fast-claude-code.sh team --project "/my/project" --template "architecture-decision" --task "选择 PostgreSQL 还是 MongoDB"
# 复杂功能开发（设置超时）
TEAM_TIMEOUT=7200 bin/fast-claude-code.sh team --project "/my/project" --template "fullstack-feature" --task "实现用户认证系统"
# Interactive 发送后续任务
bin/fast-claude-code.sh send-task --session "session-name" --task "后续任务"
# Interactive 结束会话
bin/fast-claude-code.sh send-task --session "session-name" --task "exit session"

How It Works

Single 模式

  • 在 tmux 中启动 Claude Code
  • 执行单次任务
  • 任务完成后通过 callback 通知

Interactive 模式

  • 创建持久 tmux 会话
  • 可通过 send-task 发送后续任务
  • 每次任务完成都触发 callback

Team 模式

  • 安装 Stop hook 监听完成事件
  • 在 tmux 中启动 Team 模式
  • 主 agent spawn 子 agents 协作
  • 检测 CC_CALLBACK_DONE marker 确认真正完成
  • 回调通知并清理资源

Notes

  • 任务在后台 tmux 会话中运行，完成后自动回调
  • Team 模式需要 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
  • Interactive 模式下可用 send-task 发送后续任务
  • ⚠️ 建议不要在一个项目下并行执行多个 Team 任务

Callback

任务完成后自动回调，格式： 

请总结以下 Claude Code 任务的执行结果，并回复用户：
=== 任务信息 ===
模式: model-name
状态: done
任务标识: session-id
=== 用户请求 ===

=== 执行结果 ===

数据来源：ClawHub ↗ · 中文优化：龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务