fishskylky-tech/feishu-am-workbench

Feishu AM Workbench

개요

이 스킬은 Feishu Base, 문서, 할 일을 중심으로 구성된 개인 AM(Account Manager) 워크플로우입니다. 혼합 입력을 구조화된 계정 뷰로 변환하고, 워크벤치 전반에 걸친 업데이트를 제안하며, 명시적인 사용자 확인 후에만 기록합니다. 워크벤치는 네 가지 계층으로 구성됩니다: 客户主数据(인덱스), 상세 테이블(계약/액션 플랜/핵심 담당자/연락 기록/경쟁사), 客户档案(내러티브 아카이브), Feishu 할 일(실행 알림).

사용 가능한 시나리오 (7가지)

시나리오	목적	전문가 카드
post-meeting-synthesis	회의 -> 구조화된 계정 판단	입력 + 출력
customer-recent-status	4가지 렌즈 고객 현황 조회	입력
archive-refresh	정식 아카이브 업데이트	입력 + 출력
todo-capture-and-update	할 일 후속 처리	출력
cohort-scan	고객 코호트 분석	입력
meeting-prep	7차원 회의 브리핑	입력 + 출력
proposal	5차원 제안/보고서	입력 + 출력

핵심 워크플로우 (10단계)

1. 고객 의도 및 후보 고객명 식별
2. 쓰기 작업 계획 전에 客户主数据에서 하나의 客户ID 확인
3. 실시간 데이터 접근을 위해 Feishu 워크벤치 게이트웨이 사용
4. 회의 노트/녹취록에 대해 실시간 우선 게이트 실행
5. 쓰기 범위 결정 전에 회의 유형 분류
6. 라우팅 전에 모든 관련 엔티티 추출
7. 필요한 최소 컨텍스트만 읽기
8. 쓰기 계획 전에 실시간 스키마 사전 점검 실행
9. 사실과 판단 분리
10. 계정 분석 + 구조화된 변경 계획 생성; 확인 대기

하드 규칙

• 客户ID 확인을 위해 항상 客户主数据를 진실 공급원으로 사용
• 고객 매칭이 모호한 경우 중단하고 명확히 요청
• 고객 마스터 테이블을 보호 대상으로 취급 — 허용된 필드만 업데이트
• 추측한 필드명이 아닌 실제 Base 스키마 사용
• Base 쓰기 전: 테이블/필드 존재 여부 및 타입 일치 확인
• 날짜는 절대값으로 처리 — 상대적 표현 사용 금지
• 원시 녹취록을 공식 회의 노트 문서로 저장하지 않음
• 추론된 비즈니스 판단을 객관적 사실로 제시하지 않음
• 각 고객은 하나의 표준 아카이브 문서만 가져야 함
• 客户主数据의 전략 필드는 신중하게 변경

출력 패턴

1. 회의 프레이밍 및 컨텍스트 복구
2. 확인된 사실 및 판단
3. 구조화된 요약
4. 권장 모드 업데이트
5. 미해결 질문 또는 차단된 항목
6. 사용자 확인 후: 쓰기 결과 및 변경 요약

쓰기 순서

1. 먼저 구조화된 Feishu 테이블 업데이트
2. 테이블 상태가 올바른 후 지원 문서(아카이브, 회의 노트) 생성/업데이트
3. 마지막으로 할 일 항목 생성/업데이트
4. 이후 단계가 실패하면 완료된 쓰기와 남은 실패를 보고

폐쇄 루프

1. 사용자 입력이 상세 기록 생성/업데이트
2. 상세 기록과 공개 입력이 고객 아카이브로 정제됨
3. 고객 아카이브가 客户主数据 전략 변경의 의사 결정 기준이 됨
4. 할 일 항목은 실행을 돕지만 구조화된 상세 기록을 대체하지 않음

범위

이 스킬은 사용자의 개인 계정 관리 책을 위한 것이며, 일반 CRM이 아닙니다. 정확성, 신중한 쓰기, 교차 테이블 무결성 유지를 우선시합니다.

필요시 다음 참조 자료 읽기

빠른 개요: references/INDEX.md 참조

• references/entity-extraction-schema.md — 혼합 입력 파싱 전
• references/master-data-guardrails.md — 고객 마스터 데이터 변경 전
• references/update-routing.md — 추출된 각 항목의 위치 결정 전
• references/feishu-runtime-sources.md — 런타임 설정 및 전제 조건
• references/feishu-workbench-gateway.md — Feishu 워크벤치 접근
• references/meeting-context-recovery.md — 회의 노트/녹취록 작업
• references/meeting-live-first-policy.md — 회의 작업
• references/meeting-type-classification.md — 회의 유형 및 쓰기 상한선
• references/customer-archive-rules.md — 고객 아카이브 업데이트 전
• references/task-patterns.md — 일반 워크플로우

전문가 카드

각 시나리오에는 scenes/{scene_name}/expert-cards.yaml에 전문가 카드 구성이 있습니다. 이는 주요 시나리오 노드에서 입력/출력 감사를 제공합니다.