OpenClaw에서 채팅이나 이슈 목록을 차분 반영하기 knowledge-source-ingest
機械翻訳 / Machine-translated
원문: OpenClaw에서 채팅이나 이슈 목록을 차분 반영하기 knowledge-source-ingest(cccskills)
스킬 페이지: knowledge-source-ingest
이 글의 결론
OpenClaw에서 채팅이나 이슈 목록을 Knowledge에 정기적으로 반영하고 있다면, knowledge-source-ingest가 도움이 됩니다.
범위를 구분하여 취득한 데이터를 이전 분과 비교하고, 추가·변경·삭제를 확인한 후 반영할 수 있는 스킬입니다.
취득 범위와 스냅샷도 매번 기록으로 남습니다.
이 글에서는 반환되는 결과의 내용, 도입 방법, 요청문 예시, 반영 전 확인 사항을 설명합니다.
이 스킬을 사용하면, 취득한 데이터를 이전 분과 대조한 「차분 계획」이 먼저 반환됩니다.
Knowledge에 반영하는 것은 그 이후입니다.
요청 예시는 다음과 같습니다.
9월 21일부터 28일까지의 Discord 채널 내보내기를 매니페스트로 만들고, 이전 분과 비교해 주세요
에이전트는 먼저 Discrawl용 읽기 전용 어댑터로 지정 기간의 메시지를 추출합니다.
기간의 구분은 「시작 시각 이상, 종료 시각 미만」입니다.
추출된 결과는 게시자의 고정 ID를 포함한 JSONL 파일로 저장됩니다.
사람이 읽고 확인하고 싶을 때를 위해, 행 번호로 인용할 수 있는 읽기 쉬운 트랜스크립트도 별도로 생성되는 구조입니다.
다음으로, 각 메시지의 ID와 내용의 해시값을 나열한 매니페스트(취득 내용의 목록)가 생성됩니다.
이어서 범위가 겹치는 과거 매니페스트와 비교하여, 커버 완료·미커버 기간과 다음 5가지 목록을 반환합니다.
| 구분 | 처리 |
|---|---|
| 추가 | 새 항목으로 반영 |
| 변경 | 기존 페이지나 기술과 대조하여 수정 |
| 삭제 | 정보 소스에서 삭제된 것으로 관측된 상태로 취급하며, Knowledge는 삭제하지 않음 |
| 변경 없음 | 저장된 데이터와 기록을 재사용 |
| 미해결 | 부분 취득 등으로 존재 여부를 판단할 수 없어, 미해결 상태로 남김 |
반영이 완료되면 스냅샷 페이지가 공개됩니다.
이 페이지에 기록되는 것은 취득 범위·관측 시각·건수·해시값과, 완전 취득 여부입니다.
마지막으로 각 페이지와 첨부 파일을 다시 읽어, 해시와 범위가 일치하는지 확인합니다.
이 스킬의 역할은 외부 데이터를 「어디서, 어떤 범위로, 언제 취득했는지」를 관리하는 것입니다.
취득한 대화나 문서의 내용을 정리하는 작업은 별도의 반영 스킬에 넘깁니다.
정보 소스는 표시 이름이 아닌 제공처와 소스 키의 조합으로 식별합니다.
따라서 채널 이름이 바뀌어도 동일한 정보 소스로 취급할 수 있습니다.
정보 소스마다 기준이 되는 페이지를 1개 갖고, 매번 반영 시 재사용하는 구조입니다.
취득할 때마다 매니페스트가 첨부된 스냅샷 페이지가 생성됩니다.
매니페스트에 남는 것은 항목의 ID와 해시값이며, 본문 자체는 포함되지 않습니다.
완전 취득 스냅샷만이, 그 범위 내에서 「항목이 사라졌다」는 것을 나타낼 수 있습니다.
부분 취득의 경우나 취득 상황이 불명확한 경우, 발견되지 않는 항목은 미해결 상태로 남습니다.
비교 전에 수행하는 것은, 동일 정보 소스의 과거 스냅샷을 Knowledge에서 찾는 것입니다.
첨부된 해시를 검증한 후, 범위가 겹치는 것을 모두 비교에 사용합니다.
대화 기억에 의존하지 않기 때문에, 날짜를 넘겨 운용해도 이전 상태를 착각하지 않습니다.
문서나 대화는 knowledge-ingest에, 회의는 knowledge-meeting-ingest에 넘겨집니다.
채팅은 답글 연결 단위로 묶어, knowledge-entities에서 사람·회사·프로젝트·개념 페이지를 보강합니다.
새로운 동향을 반영하는 곳은 가장 구체적인 기존 페이지의 현황란입니다.
그 란만 수정하며, 반영할 때마다 절을 추가하지 않습니다.
설치는 다음 명령어로 수행합니다.
실행 시, Claude Code나 Codex 등 설치할 에이전트를 선택할 수 있습니다.
npx skills add https://github.com/openclaw/openclaw --skill knowledge-source-ingest
에이전트에게 설치를 요청할 경우, 다음 문구를 그대로 전송해 주세요.
次の Agent Skill をインストールしてください。
https://github.com/openclaw/openclaw/tree/main/extensions/knowledge/skills/knowledge-source-ingest
まず SKILL.md と付属ファイルの中身を確認し、不審な処理(外部への送信、認証情報の読み取りなど)がないことを確かめてから、Claude Code なら ~/.claude/skills/knowledge-source-ingest/、Codex なら ~/.agents/skills/knowledge-source-ingest/ に配置してください。
저장 위치는 모든 프로젝트에서 사용할지, 특정 프로젝트에서만 사용할지에 따라 선택합니다.
| 에이전트 | 전체 프로젝트 공통 | 프로젝트 단위 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/ | .agents/skills/ |
요청문에는 대상 정보 소스와 기간, 원하는 확인 사항을 명확히 쓰면 잘 전달됩니다.
이슈 목록의 추가·변경·삭제 항목을 확인할 수 있는 계획을 만들어 주세요
승인된 읽기 수단으로 취득한 이슈 목록에서 매니페스트가 생성되고, 이전 분과 비교한 계획 파일이 반환됩니다.
계획 파일에 나열되는 것은 추가·변경·삭제·변경 없음·미해결 목록과, 커버 완료·미커버 기간입니다.
취득한 회의 데이터를 Knowledge의 회의 반영으로 넘겨 주세요
회의 데이터는 knowledge-meeting-ingest로 전달됩니다.
이 스킬 측은 정보 소스 식별과 취득 범위 기록을 담당하며, 스냅샷을 의존 출처로 남깁니다.
지난번에는 사람이나 프로젝트 정리를 생략했으니, 저장된 데이터에서 이어서 해 주세요
저장된 원본 데이터를 재사용하여, 생략했던 보강 작업을 이어서 진행합니다.
매니페스트에 변화가 없어도, 보강이 완료되었다고는 할 수 없기 때문입니다.
반영 전에, 삭제로 판정된 항목과 취득 범위 기록을 반드시 확인해 주세요.
삭제는 어디까지나 정보 소스 측에서 관측된 상태에 불과합니다.
Knowledge 기술의 수정이나 취소는 근거가 갖춰졌을 때에 한합니다.
도입 전에 확인해 두고 싶은 사항은 다음과 같습니다.
반영한 대화에서 사람이나 조직 정보를 정리하려면, knowledge-entities를 조합합니다.
대화나 자료에 등장하는 사람·회사·프로젝트·개념을 특정하고, 근거가 있는 Knowledge 페이지와 상호 링크를 정리하는 스킬입니다.
채팅 반영 시에는 knowledge-source-ingest에서 호출되는 위치로 사용됩니다.
만들지 않습니다.
스케줄러나 상주 연결 프로세스는 제공되지 않습니다.
에이전트가 승인을 받아 실행하는 흐름을 지원하는 스킬입니다.
정기 반영을 만들 경우에는 knowledge-automation을 먼저 사용합니다.
사용할 수 있습니다.
이슈 목록, 피드, 메일함 등 범위를 구분하여 취득할 수 있는 정보 소스가 대상입니다.
단, 동봉된 어댑터는 Discrawl용만입니다.
그 외에는 승인된 읽기 수단으로 취득한 후, 범용 매니페스트 도구로 처리합니다.
삭제되지 않습니다.
삭제는 정보 소스에서 관측된 상태로 취급되며, Knowledge를 삭제해도 된다는 의미는 아닙니다.
수정이나 취소는 근거가 갖춰졌을 때만 수행합니다.
남지 않습니다.
매니페스트에 들어가는 것은 항목의 ID와 내용의 해시값입니다.
원본 데이터는 허용된 범위 내에서 증거로 별도 저장합니다.
knowledge-source-ingest는 OpenClaw의 Knowledge에 채팅이나 이슈 목록을 반복적으로 반영하는 분을 위한 스킬입니다.
범위를 구분하여 취득하고, 이전 분과의 차분을 목록으로 확인한 후 반영합니다.
취득 범위와 스냅샷이 매번 남기 때문에, 다음 반영 시에도 동일한 기준으로 비교할 수 있습니다.
도입 방법과 부속 파일은 cccskills 페이지에서 확인할 수 있습니다.
이 글은 cccskills의 읽을거리 「OpenClaw에서 채팅이나 이슈 목록을 차분 반영하기 knowledge-source-ingest」의 전재입니다.
스킬의 상세 내용과 설치 방법은 cccskills의 knowledge-source-ingest 페이지에 있습니다.