Community코딩 & 개발github.com

stevengaojn2010/agent-pulse

에이전트의 현재 부하와 인터럽트 가능 여부를 보고하는 경량 OpenClaw 스킬입니다.

agent-pulse란 무엇인가요?

Agent Pulse는 AI 에이전트의 현재 작업 부하와 방해 가능성을 간결하게 보고하는 경량 상태 확인 프로토콜 스킬입니다. 주로 OpenClaw 환경에서 사용되며, 에이전트가 얼마나 바쁜지, 새로운 작업을 수락할 수 있는지, 방해해도 되는지에 대한 일관된 정보를 제공합니다. 이 스킬은 자연어 트리거(예: "지금 바빠?", "새 작업 가능?")나 정확한 명령어(Agent Pulse, /pulse)에 반응하여 항상 동일한 고정 형식의 카드를 반환함으로써 예측 가능성을 보장합니다. Agent Pulse는 저비용 신호(예: 실행 중인 작업, 큐 메시지, 차단 상태)를 수집하고 내장된 Python 스크립트(scripts/pulse_eval.py)를 사용하여 이를 'idle', 'light', 'busy', 'blocked', 'unknown'과 같은 상태로 매핑합니다. 이는 결정론적 규칙을 모델 판단보다 우선시하고, 에이전트의 내부 상태를 추측하지 않으며, 펄스 쿼리 자체를 작업 증거로 간주하지 않도록 설계되었습니다. 사용자와 협업하는 AI 에이전트의 워크로드를 투명하게 관리하는 데 특히 유용하며, 펄스 카드 포맷을 기본 응답으로 유지하면서 필요한 경우에만 추가 설명을 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add stevengaojn2010/agent-pulse

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Agent Pulse

개요

이 스킬은 엄격한 상태 확인 프로토콜로 사용됩니다. 고정된 문구와 필드를 사용하여 현재 부하 및 인터럽트 가능성에 대한 간결한 펄스 카드를 반환합니다.

기본적으로 베이스라인 상태(자기 영향 상태가 아님)를 기준으로 합니다. 펄스 요청 자체로 인해 에이전트가 확인 직전보다 더 바빠 보여서는 안 됩니다.

표준 트리거

다음을 직접적인 펄스 요청으로 간주합니다:

  • Agent Pulse
  • /pulse
  • 你现在忙吗
  • 忙不忙
  • 现在方便吗
  • 现在负荷怎么样
  • 能接新任务吗
  • 能插个任务吗
  • 现在能接活吗

사용자가 명시적으로 Agent Pulse 또는 /pulse를 사용하는 경우, 항상 고정된 펄스 카드 형식을 반환하고 요청하지 않는 한 대화형 설명으로 전환하지 않습니다.

고정 출력 계약

첫 번째 줄 레이블 다음에 정확히 다음 네 줄을 반환합니다:

Agent Pulse
status: <idle|light|busy|blocked|unknown>
interruptibility: <high|medium|low>
acceptNewTask: <yes|caution|no>
reason: <short reason>

규칙:

  • 기본적으로 추가 문단 없음
  • 기본적으로 글머리 기호 없음
  • 사용자가 이유를 묻지 않는 한 긴 설명 없음
  • 가능한 경우 reason을 12단어 미만으로 유지

상태 의미

  • idle: 적극적으로 점유되지 않음; 방해하기 쉬움
  • light: 활성 상태이지만 부하가 없음; 작업 수락 가능
  • busy: 현재 점유 중; 방해를 최소화해야 함
  • blocked: 종속성/도구/사람을 기다리는 중
  • unknown: 신호가 불충분하거나 충돌함

의사 결정 워크플로우

1. 저비용 신호 수집

먼저 저비용 신호만 사용합니다:

  • 실행 중인 작업 또는 스트림
  • 대기 중인 메시지
  • 차단 또는 대기 상태
  • 최근 활동 시간
  • 명백한 백로그 징후
  • 진행 중인 활성 프로젝트
  • 아직 전달되지 않은 보류 중인 작업 항목
  • 현재 무거운 도구가 실행 중이 아니더라도 이미 시작된 작업
  • 릴리스 중요 또는 곧 마감되는 작업
  • 볼 수 있는 경우 현재 도구 또는 실행 활동
  • 에이전트가 사용자 또는 외부 종속성을 기다리고 있는지 여부

OpenClaw 스타일 환경의 경우, 내성보다는 가시적인 런타임 신호를 선호합니다. 좋은 소스에는 최근 도구 활동, 보류 중인 백그라운드 실행, 이미 진행 중인 전달되지 않은 작업, 필요한 경우 빠른 session_status 확인이 포함됩니다. 일상적인 비동기 완료 알림이나 펄스 쿼리 자체를 작업 부하 증거로 간주하지 마십시오.

2. 번들 스크립트로 평가

scripts/pulse_eval.py를 사용하여 신호 JSON을 펄스 결과로 매핑합니다.

3. 고정 카드 반환

트리거가 Agent Pulse 또는 /pulse인 경우, 고정 카드만 출력합니다. 트리거가 자연어인 경우, 사용자가 명확하게 설명을 원하지 않는 한 고정 카드가 여전히 선호됩니다.

가드레일

  • 모델 판단보다 결정론적 규칙을 선호
  • 정밀도를 과장하지 않음
  • 증거 없이 숨겨진 내부 상태를 추론하지 않음
  • 신호가 약한 경우 unknown 사용
  • no는 진정으로 과부하 상태이거나 진행 중인 작업이 위험한 경우에만 사용
  • 사전 예방적으로 실행하지 않음; 기본적으로 명시적 펄스 트리거 필요
  • 펄스 쿼리 자체를 작업 부하 증거로 간주하지 않음

배포 기본값

사용자/환경 전반에서 의도된 제품 동작을 재현하려면:

  • 명시적 펄스 요청에서만 트리거
  • 기본적으로 고정 펄스 카드 반환
  • 자기 영향 상태보다 베이스라인 상태 선호
  • 규칙을 먼저 사용하고, 모델 추론은 두 번째로 사용
  • 사용자가 이유를 묻지 않는 한 출력을 간결하게 유지

리소스

scripts/

  • scripts/pulse_eval.py는 간단한 신호를 펄스 결과로 변환합니다.
  • scripts/render_pulse.py는 정확한 고정 출력 카드를 렌더링합니다.

references/

  • references/rules.md에는 분류 임계값 및 출력 정책이 포함되어 있습니다.
  • references/openclaw-signals.md는 OpenClaw 스타일 런타임을 위한 실용적인 신호 매핑 레시피를 보여줍니다.

관련 스킬