Feishu 완료 알림

Feishu 완료 알림은(는) 무엇을 하나요?

개요

채팅 턴 또는 자격을 갖춘 Codex 변경이 완료된 후에 필요한 Feishu 애플리케이션-봇 완료 메시지를 전송합니다. 번들 스크립트를 사용하여 토큰 검색, 메시지 구조, API 호출이 일관되게 유지됩니다.

워크플로

1. 활성 프로젝트 규칙이 모든 채팅 턴 완료 후 알림을 요구하는지 확인합니다. 요구하는 경우 질문 전용 턴에도 전송합니다. 그렇지 않으면 코드, 에셋, UI, 문서 또는 프로젝트 변경을 완료하고 푸시하거나 마친 후에만 전송합니다.
2. 메시지 필드를 결정합니다:
   • 프로젝트(Project): 현재 리포지토리 또는 워크스페이스 이름. codex인 경우 Codex로 표시합니다.
   • 채팅(Chat): 현재 채팅/스레드 제목. 사용할 수 없는 경우 표시 가능한 워크스페이스/채팅 디렉터리 이름을 사용합니다.
   • 세션(Session): 현재 작업 또는 대화 이름. 사용할 수 없는 경우 사용자의 작업에서 파생된 간결한 이름을 사용합니다.
   • 시간(Time): 로컬 완료 시간.
3. --project, --chat, --session을 명시적으로 알고 있는 경우 이 스킬의 scripts/send_feishu_completion.py를 실행합니다.
4. 스크립트가 Feishu 환경 변수 누락을 보고하면 사용자에게 구체적인 이유로 알림을 전송할 수 없음을 알립니다. Slack으로 대체하지 마십시오.
5. Feishu가 API 오류를 반환하면 일시적인 오류로 보일 때만 한 번 재시도합니다. 그렇지 않으면 실패를 보고하고 최종 응답을 계속합니다.

스크립트 사용법

사용:

python3 /Users/pika/.codex/skills/notify-feishu-completion/scripts/send_feishu_completion.py \
  --project "ProjectName" \
  --chat "ChatName" \
  --session "SessionName"

--dry-run을 사용하여 Feishu 호출 없이 생성된 메시지를 검증합니다:

python3 /Users/pika/.codex/skills/notify-feishu-completion/scripts/send_feishu_completion.py \
  --project "Codex" \
  --chat "new-chat" \
  --session "Feishu 알림 스킬 생성" \
  --dry-run

스크립트는 다음 정확한 메시지 구조를 전송합니다:

【프로젝트명】【chat 이름】【세션명】 변경 완료, 【완료 시간】

스크립트는 드라이런 모드가 아닐 때 다음 환경 변수를 읽습니다:

FEISHU_APP_ID
FEISHU_APP_SECRET
FEISHU_RECEIVE_ID_TYPE
FEISHU_RECEIVE_ID

참고 사항

• Feishu를 통해서만 전송하며, 이 완료 알림에 Slack을 사용하지 마십시오.
• 알림이 전송되었거나 전송할 수 없었던 경우 최종 사용자 응답을 명확하게 유지하십시오.
• 현재 채팅/세션 이름을 알고 있는 경우 스크립트 추론에 의존하기보다 명시적 필드 값을 전달하는 것을 선호합니다.