Struct SystemPromptGenerator 

pub struct SystemPromptGenerator { /* private fields */ }

Available on crate feature cli-integration only.

System prompt generator with output style support.

System Prompt Structure

The generated system prompt follows this structure:

1. CLI Identity (required for CLI OAuth authentication)

   • “You are Claude Code, Anthropic’s official CLI for Claude.”
   • This MUST be included when using CLI OAuth and cannot be replaced

2. Base System Prompt (always included after identity)

   • Tone and style, professional objectivity, task management

3. Tool Usage Policy (always included)

   • Tool-specific guidelines

4. Coding Instructions (if keep_coding_instructions: true)

   • Software engineering instructions
   • Git commit/PR protocols

5. Custom Prompt (if output style has custom content)

   • Style-specific instructions

6. Environment Block (always included)

   • Working directory, platform, model info

Implementations

impl SystemPromptGenerator

pub fn new() -> Self

Create a new generator with default style. CLI identity is NOT required by default.

pub fn with_cli_identity() -> Self

Create a generator that requires CLI identity. Use this when using Claude CLI OAuth authentication.

pub fn require_cli_identity(self, required: bool) -> Self

Set whether CLI identity is required. CLI identity MUST be included when using Claude CLI OAuth.

pub fn with_style(self, style: OutputStyle) -> Self

Set the output style directly.

pub fn with_working_dir(self, dir: impl Into<PathBuf>) -> Self

Set the working directory for environment block.

pub fn with_model(self, model_id: impl Into<String>) -> Self

Set the model information.

pub fn with_model_name(self, name: impl Into<String>) -> Self

Set the model name explicitly.

pub async fn with_style_name(self, name: &str) -> Result<Self>

Load and set an output style by name.

Searches in priority order:

1. Project styles (.claude/output-styles/) - highest priority
2. User styles (~/.claude/output-styles/)
3. Built-in styles - lowest priority

pub fn generate(&self) -> String

Generate the system prompt.

Prompt Assembly Logic

• CLI Identity: Only if require_cli_identity: true (CLI OAuth)
• Base System Prompt: Always included
• Tool Usage Policy: Always included
• Coding Instructions: Only if keep_coding_instructions: true
• Custom Prompt: Only if style has non-empty prompt
• Environment Block: Always included

pub fn generate_with_context(&self, additional_context: &str) -> String

Generate the system prompt with additional dynamic context.

This is used when rules or other dynamic content needs to be appended.

pub fn style(&self) -> &OutputStyle

Get the current output style.

pub fn has_coding_instructions(&self) -> bool

Check if coding instructions are included.

Trait Implementations

impl Clone for SystemPromptGenerator

fn clone(&self) -> SystemPromptGenerator

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SystemPromptGenerator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SystemPromptGenerator

fn default() -> Self

Returns the “default value” for a type.