AgentSkillsCN

adk-callbacks

精通ADK生命周期钩子与插件，用于观测与控制。可在Python中实现防护栅栏、缓存机制，以及状态的动态调整。

SKILL.md
--- frontmatter
name: adk-callbacks
description: Expert in ADK lifecycle hooks and plugins for observation and control. Use to implement guardrails, caching, and state modification in Python.

ADK Interception & Lifecycle (Python Edition)

Philosophy

Callbacks (Local) and Plugins (Global) allow for surgical interception of agent execution.

Logic Flow

  1. •Scope Determination:
    • •Use Plugins for cross-cutting features (global logging, security policies).
    • •Use Callbacks for agent-specific logic (task-dependent validation, hand-off).
  2. •Context Selection:
    • •Load references/hooks.md for hook signatures, context objects, and return types.
  3. •Implementation:
    • •Implement before_* for validation/short-circuiting.
    • •Implement after_* for post-processing/cleanup.

Output Standards

  • •Explicit return types to signal intent (None vs. types.Content/LlmResponse).
  • •Non-blocking async implementation.
  • •Correct error handling via on_*_error hooks.