소스 수집 스킬
채팅 채널, 이슈 스트림, 피드, 메일함과 같이 후속 실행이 이전 범위와 중복될 수 있는 경계 있는 컬렉션에 사용합니다.
공유 규칙,
게시, 그리고
매니페스트 프로토콜을 읽으십시오.
획득 후 문서와 대화를 knowledge-ingest로 라우팅하면 knowledge-entities를 사용하여 엔터티 보강을 수행합니다.
회의는 knowledge-meeting-ingest를 통해 라우팅합니다.
이 스킬은 소스 정체성과 범위를 소유하며, 수집 워크플로는 보존된 내용을 유용한 연결 지식으로 전환합니다.
반복 수집 작업을 생성하려면 먼저 knowledge-automation을 사용하십시오.
계약
- 내용을 읽기 전에 안정적인 공급자/소스 키를 확인합니다. 표시 이름은 레이블일 뿐, 정체성이 아닙니다.
source_role: canonical,provider,source_key가 포함된 하나의 정식source페이지를 유지합니다. 매 실행마다 이를 재사용합니다.- 각 경계 관찰에 대해 생성된 매니페스트를
source_role: snapshot, 정확한 범위, 관찰 시간, 매니페스트 해시, 개수, 완전성, 워터마크, 그리고 정식 소스 페이지에 대한 종속성이 포함된source페이지의 첨부 파일로 보존합니다. - 매니페스트는 소스 텍스트가 아닌 안정적인 항목 ID와 내용 해시를 보존합니다. 승인된 경우 원본/내보낸 내용을 증거로 별도로 보존합니다.
- 계획을 수립하기 전에 동일한 공급자/소스 키에 대한 이전 스냅샷 페이지를 쿼리합니다. 매니페스트를 다운로드하고 첨부 파일 해시를 확인한 후 모든 중복 스냅샷을 계획자에게 전달합니다. 대화 메모리에 의존하지 마십시오.
- 변경되지 않은 소스 바이트와 기존 레코드를 재사용합니다. 요청 시 보존된 소스에서 이전에 생략된 보강을 계속 진행합니다. 매니페스트가 변경되지 않았다고 해서 엔터티 보강이 이미 발생한 것은 아닙니다. 추가된 항목을 수집합니다. 기존 페이지/주장에 대해 변경된 항목을 조정합니다. 삭제를 관찰된 소스 상태로 처리하되 Knowledge를 지우는 권한으로 처리하지는 않습니다. 증거가 정당화되는 경우에만 수정하거나 철회합니다.
- 완전한 스냅샷은 정확한 범위 내에서 부재를 입증할 수 있습니다. 부분적이거나 알 수 없는 스냅샷은 그럴 수 없습니다. 확인되지 않은 누락 ID는 확인되지 않은 상태로 남습니다.
절차
knowledge_status와knowledge_ontology를 검사하여 의도한 저장소 범위와source필드를 확인한 다음, Knowledge에서 공급자/소스 키를 기준으로 정식 소스와 이전 스냅샷을 검색합니다. 소유자 전용 수집이 예기치 않게 대화 범위로 확인되거나 다시 시작 후 빈 저장소가 되는 경우, 쓰기 전에 중단하고 의도한 승인된 범위를 복원합니다. 이전 범위가 잘못된 범위에 없다고 추론하지 마십시오.- 승인된 리더로 경계 있는 내보내기를 획득합니다. Discrawl의 경우, 설정된 읽기 전용 아카이브, 알려진 경우 정확한 채널 ID,
[since,before)RFC3339 범위를 사용하여scripts/discrawl-normalize.mjs를 실행합니다. 정규화된 페이로드에는 안정적인 작성자 ID와 아카이브에서 관찰된 표시 필드가 포함됩니다. 원시 JSONL을 보존하고, 사람 검토나 줄 인용이 필요할 때 줄 안정적인 읽기 가능한 트랜스크립트를 별도로 생성합니다. scripts/source-manifest.mjs snapshot을 사용하여 결정론적 매니페스트를 생성합니다. 스냅샷 페이지를 게시하기 전에 첨부하고 반환된 SHA-256을 기록합니다.- 모든 중복 이전 매니페스트를 다운로드하고
scripts/source-manifest.mjs plan을 실행합니다. 포함/미포함 간격과 추가/변경/삭제/변경 없음/미해결 목록을 검사합니다. - 3~5개의 실질적인 항목이나 토론을 테스트한 다음
knowledge-ingest(회의의 경우knowledge-meeting-ingest)를 통해 수집합니다. 채팅의 경우 관련 메시지를 답장 컨텍스트와 함께 그룹화하고,knowledge-entities를 사용하여 기여에서 관련 인물, 회사, 프로젝트, 개념을 보강합니다. 지원되는 개발 내용을 채널 요약뿐만 아니라 상태, 날짜별 타임라인, 컨텍스트 백링크로 전달합니다. 소스 인용에 안정적인 외부 ID를 사용하고 보존된 스냅샷을 종속성으로 사용합니다. 토론당 하나의 사본을 업로드하는 대신 원본을 재사용합니다. - 파생 레코드를 게시하거나 업데이트한 다음 스냅샷 페이지를 게시합니다. 스냅샷은 획득 및 매니페스트 생성이 선언된 간격을 포괄하는 경우에만
complete입니다. 파생 추출은 여전히 부분적일 수 있으며 그렇게 보고되어야 합니다. - 정식 페이지, 스냅샷 페이지, 첨부 파일, 파생 레코드, 소스 종속 연결을 다시 읽습니다. 해시와 정확한 범위를 확인합니다.
Discrawl 예제
node scripts/discrawl-normalize.mjs --config /approved/discrawl.yaml \
--channel 1234567890 --since 2026-09-21T00:00:00-07:00 \
--before 2026-09-28T00:00:00-07:00 --output messages.jsonl
node scripts/source-manifest.mjs snapshot --provider discord \
--source-key discord:GUILD_ID:1234567890 \
--coverage-start 2026-09-21T00:00:00-07:00 \
--coverage-end 2026-09-28T00:00:00-07:00 \
--input messages.jsonl --output manifest.jsonl.gz --summary snapshot.json
node scripts/source-manifest.mjs plan --current manifest.jsonl.gz \
--previous prior-1.jsonl.gz --previous prior-2.jsonl.gz --output plan.json
Knowledge 페이지 텍스트에 자격 증명, 아카이브 경로, 원시 개인 콘텐츠를 포함하지 마십시오. 스케줄러, 커넥터 데몬, 플러그인 소유 수집 작업이 생성되지 않습니다. 스킬과 스크립트는 승인된 에이전트 실행 워크플로를 지원합니다.