AgentSkillsCN

claude-code-oneshot

在深度编码会话中运行 Claude Code——一次性执行，无需反复交互。适用于需要大量上下文信息、且验证过程相对简单的复杂任务。

SKILL.md
--- frontmatter
name: claude-code-oneshot
description: Run Claude Code for deep coding sessions - one-shot execution, no back-and-forth. Use for complex tasks with lots of context that are straightforward to verify.
metadata:
  openclaw:
    emoji: "⚡"
    requires:
      anyBins: ["claude"]

Claude Code One-Shot

For deep coding sessions that need lots of context and are straightforward to test. One-shot execution — no questions, no help, just results.

When to Use

  • •Complex refactoring or feature implementation
  • •Tasks with clear success criteria (tests pass, script runs, etc.)
  • •Delegating work that would bloat your context
  • •Parallel task execution across worktrees

Basic Usage

bash
# One-shot task (exits when done)
claude --print "Your detailed task here" --dangerously-skip-permissions

# In a specific directory
cd /path/to/project && claude --print "Build X" --dangerously-skip-permissions

Key Flags

FlagPurpose
--print "prompt"One-shot mode, exits when complete
--dangerously-skip-permissionsAuto-approve all file/command operations

Prompt Style

Be explicit. Tell it exactly what to do and NOT to do:

bash
claude --print "Create fizzbuzz.sh that prints FizzBuzz 1-30. Make it executable. ONE SHOT - no questions, just implement it." --dangerously-skip-permissions

Key phrases:

  • •"No questions, just do it"
  • •"ONE SHOT"
  • •"Do NOT ask for clarification"

Background Execution

For longer tasks, run in background with PTY:

bash
# Start in background
exec pty:true background:true workdir:~/project command:"claude --print 'Build a REST API for todos' --dangerously-skip-permissions"

# Monitor progress
process action:log sessionId:XXX

# Check completion
process action:poll sessionId:XXX

Parallel Tasks with Worktrees

For multiple independent tasks:

bash
# Create worktrees
git worktree add -b feat/auth /tmp/auth-work main
git worktree add -b feat/api /tmp/api-work main

# Run Claude Code in each (parallel)
cd /tmp/auth-work && claude --print "Implement OAuth2 login" --dangerously-skip-permissions &
cd /tmp/api-work && claude --print "Add REST endpoints for users" --dangerously-skip-permissions &

# Wait for both
wait

NixOS Note

Claude Code may generate #!/bin/bash shebangs. Fix with:

bash
sed -i '1s|#!/bin/bash|#!/usr/bin/env bash|' script.sh

Rules

  1. •Verify results — run the code, check the tests, confirm it works
  2. •Clear prompts — ambiguity leads to questions or wrong output
  3. •Isolated workspaces — don't run in your main project directory for risky tasks
  4. •Git init required — Claude Code needs a git repo to operate