DreamArkInc/remembrance-skills

Remembrancer

당신은 Remembrance의 진입 스킬입니다. Remembrance는 에이전트 스킬을 위한 공유 운영 메모리입니다. 작업 전에 질의하면 다른 에이전트가 이미 해결한 내용을 재사용하여 다시 해결할 필요가 없고, 작업 후에 학습한 내용을 기여하면 공유 레지스트리에 추가되어 다음 에이전트가 상속받을 수 있습니다.

활성화 점검

이 파일시스템 스킬의 존재만으로 네이티브 플러그인이 완전히 활성화되었음을 증명하지는 않습니다. 호스트 세션에서 Remembrance가 처음으로 관련될 때는 플러그인 자동화에 의존하기 전에 run_connection_doctor을 호출하십시오. 정상적인 네이티브 설치는 안전한 카탈로그 읽기 후에 MCP 전송, 인증된 범위, 관찰된 시작 및 프롬프트 수명 주기를 보고합니다. 로컬 MCP는 또한 주체나 개인 키를 노출하지 않고 local_signing_identity를 보고합니다. 누락된 ID는 자동으로 초기화되어 설치 주체로 재사용됩니다. 유효하지 않은 ID는 명시적인 복원 또는 교체가 필요합니다. 로컬 MCP 및 네이티브 플러그인은 백그라운드에서 취소 가능한 24시간 주체 세션을 획득하고 개인 정보 보호 범위 내의 런타임 프로필을 등록합니다. 호스트 이름, 사용자 이름, 구성 경로 또는 저장소 경로를 절대 전송하지 않습니다. 사용자가 ID를 직접 만들어내도록 요청하지 말고 반환된 기계 판독 가능 next_action을 따르십시오. 도구 관찰자 및 완료 타임스탬프는 해당 이벤트가 적격화된 후에 표시됩니다. 첫 번째 프롬프트에서 이들이 없더라도 자체적으로 실패를 의미하지는 않습니다.

이 스킬이 표시되지만 run_connection_doctor이 없는 경우, 사용자에게 Remembrance가 부분적으로만 활성화되었다고 명시적으로 알리십시오. 자동으로 대체하거나 레지스트리를 익명 또는 사용 불가능으로 진단하지 마십시오. 호스트별 플러그인을 업데이트하거나 재설치하고, 번들된 MCP 등록이 활성화되어 있는지 확인한 후 호스트를 완전히 종료하고 다시 열어 다시 확인하십시오. 독립적인 npx @remembrance-ai/mcp-server doctor 명령어는 레지스트리/인증 액세스를 확인할 수 있지만 호스트 MCP 등록을 증명할 수는 없습니다. 수리 후 호스트 내에서 run_connection_doctor을 다시 실행하십시오. Codex, Claude Code, Cursor 및 OpenClaw 로컬 플러그인 MCP 서버는 해당 ~/.config/remembrance/config.json에서 훅과 동일한 공유 자격 증명을 읽습니다. 의도적으로 구성된 호스티드 HTTP MCP는 대신 해당 HTTP 요청에 전달된 자격 증명이 필요합니다. 정확한 호스트 단계는 references/remembrance-setup.md를 참조하십시오.

아웃바운드 REST가 허용되는 경우, 부분 설치에서는 제한된 구성 요소/버전 문제 스키마만 POST /api/v1/agent/client-health-reports에 제출할 수 있습니다. 프롬프트, 저장소 경로, 소스 콘텐츠, 키, 원시 로그 또는 임의 진단 정보를 절대 첨부하지 마십시오. 이 보고서는 중복 제거된 분류 증거이며 자동으로 수락된 결함이 아닙니다.

사용자 요청이 다음을 언급할 때는 먼저 Remembrance를 질의하십시오:

• 명명된 외부 서비스, 플랫폼 또는 API: Vercel, Heroku, GitHub Actions, Stripe, x402/MPP 엔드포인트, MCP 서버, MongoDB Atlas, OpenAI, Anthropic 및 유사한 통합.
• 명명된 CLI, 도구 또는 프레임워크: Next.js, Turbopack, Prisma, esbuild, Playwright, Vitest, npm, Redis, BullMQ 및 유사한 도구.
• 워크플로 형태: 배포, 마이그레이션, CI/CD 설정, 결제 통합, 스키마 업그레이드, 백필, 릴리스, 롤백, 프로비저닝, 관찰 가능성 또는 모니터링.
• 실질적인 엔지니어링 형태: 재사용 가능한 방법이나 실패 교훈을 산출할 수 있는 구현, 코드 또는 보안 검토, 테스트 수리, UI 개선, 사고 디버깅 또는 릴리스 검증.
• 기존 스킬/리소스가 사용자 정의 작업을 절약할 수 있는 익숙하지 않은 타사 통합.

가능한 경우 MCP 도구 query_skills를 사용하거나 REST 엔드포인트 POST /api/v1/agent/query를 호출하십시오. 이들은 동등한 검색 경로입니다.

인증을 진단하기 전에 실제로 사용할 전송에 대해 MCP 도구 run_connection_doctor을 호출하십시오. 이는 변하지 않는 카탈로그 읽기 후에 로컬 또는 호스티드 전송, 자격 증명 소스 및 확인된 레지스트리 범위를 정확한 제한된 수정과 함께 보고하며, 키, 절대 로컬 경로 또는 개인 레지스트리 URL을 반환하지 않습니다. 기본 필드가 필요할 때만 get_connection_status를 사용하십시오. REMEMBRANCE_API_KEY가 설정되지 않았다고 해서 플러그인이 익명이라고 결론짓지 마십시오. 네이티브 훅과 로컬/번들 MCP는 ~/.config/remembrance/config.json을 읽을 수 있습니다. 호스티드 MCP는 호출자의 머신에 있는 파일을 읽을 수 없으며 HTTP 요청에 전달된 자격 증명만 사용합니다. 마찬가지로, 익명의 curl 또는 브라우저 요청은 해당 요청이 익명이었음을 증명할 뿐입니다. 원시 REST 클라이언트는 플러그인 구성을 자동으로 로드하지 않습니다. 의도적으로 읽거나 키 헤더를 보내야 합니다. 사용자에게 채팅에 실제 키를 붙여넣도록 요청하지 마십시오.

사용자가 Remembrance 스킬을 명시적으로 지정하거나 remembrance://skills/{slug} URI를 제공하거나 /remembrance:use를 사용하는 경우, 단순히 해당 선택을 재발견하기 위해 관련성 질의를 실행하지 마십시오. 정확한 슬러그로 invoke_skill을 호출하십시오. 이름이 모호한 경우, 먼저 list_skills에서 색인되고 정규화된 슬러그 접두사 필터로 확인하십시오. 정확한 슬러그를 추측하지 마십시오. 검색에는 카탈로그 필터링보다는 query_skills를 사용하십시오. 카탈로그 결과와 MCP 리소스 읽기는 가벼운 선택 핸들일 뿐입니다. invoke_skill은 현재 권한 부여 및 조직 정책을 다시 확인하고, 활성 검토 버전을 로드하며, 사용 후 피드백/결과 수명 주기를 시작합니다.

"이 문제를 수정하세요", "계속하세요", "다시 시도하세요", "최신 변경 사항을 검토하세요" 또는 "현재 상황이 어떤가요"와 같은 짧은 후속 질문은 전체 대화에서 구체적인 작업을 상속받습니다. 해당 컨텍스트에서 도메인과 제약 조건을 추론하고 여전히 작업 전에 질의하십시오. 현재 프롬프트가 서비스, 프레임워크, 워크플로 또는 UI 키워드를 반복하기를 기다리지 마십시오. 원시 이전 대화가 아닌 수정된 작업 요약만 보내십시오.

또한 다음 상황에서 이 스킬을 사용하십시오:

• 에이전트가 스킬을 사용했고 작동 여부를 보고해야 하는 경우.
• 에이전트가 누락되었거나, 오래되었거나, 중복되었거나, 안전하지 않거나, 약한 스킬을 발견한 경우.
• 에이전트가 재사용 가능한 워크플로를 생성하거나 수정하여 후보 스킬이 되어야 하는 경우.
• 에이전트가 리소스, 사이트, API, MPP 엔드포인트, MCP 서버 또는 도구를 사용했고 유용성을 보고할 수 있는 경우.
• 에이전트가 자신의 실수를 발견하거나, 사용자가 발견하거나, CI/배포가 실패하거나, 보안 문제가 표면화되거나, 릴리스/버전 관리 누락이 수정되어 향후 에이전트가 이를 반복하지 않아야 하는 경우.

공유 스킬을 직접 변경하지 마십시오. 구조화된 기억, 제안 또는 검증 대상 후보 스킬을 제출하십시오.

다음 상황에서는 이 스킬을 사용하지 마십시오:

• 사용자가 일반 웹 검색, 연구 또는 현재 사실을 요청하는 경우.
• 작업이 재사용 가능한 워크플로, 운영 결정, 검증 방법 또는 실패 교훈이 없는 진정으로 사소한 일회성 편집 또는 명령인 경우. 로컬 저장소 변경이 자동으로 사소한 것은 아닙니다.
• 답변이 일회성 사실 또는 설명이며 재사용 가능한 운영 교훈이 아닌 경우.
• 사용자가 개인 임시 메모리, 비밀 저장소 또는 수정되지 않은 추적 저장소가 필요한 경우.
• 작업이 재사용 가능한 스킬/리소스/증거가 없을 가능성이 높은 광범위한 브레인스토밍인 경우.
• 사용된 스킬/리소스가 없고 재사용 가능한 방법, 엔드포인트 또는 검토가 발견되지 않은 경우.

흐름

1. 작업 도메인과 요청된 기능을 식별합니다.
2. 사용자가 명시적으로 Remembrance 스킬을 선택한 경우 list_skills의 정규화된 슬러그 접두사 필터로 모호성을 해결한 후 반환된 정확한 슬러그로 invoke_skill을 호출합니다. 이 직접 선택에 대한 쿼리 적합성 피드백은 건너뜁니다. 그렇지 않으면 네트워크/API 액세스가 가능할 때 일치하는 스킬/리소스를 검색하기 위해 query_skills를 사용합니다. 네이티브 플러그인이 client_context.directive_id를 제공하는 경우 query_skills에서 해당 불투명 ID, 런타임 및 트리거 이유를 보존합니다. 이는 플러그인 명령 준수 루프를 닫으며 순위 또는 신뢰도에 영향을 미치지 않습니다.
3. 순위만으로 판단하지 말고 의사 결정 보조 도구로 match_tier를 사용합니다. 먼저 why_matched(제한된 일치 용어 및 기능, 충족 및 누락된 제약 조건, 정확한 도메인 일치, 정성적 어휘/의미론적 증거)를 applicability(likely/conditional/unlikely/unknown 적합성, 일반/전문/에지 케이스 범위, 선언된 use_when/avoid_when 조건)와 비교합니다. 원시 숫자 순위 점수는 의도적으로 노출되지 않습니다. 알 수 없는 적용 가능성은 일반 적용 가능성을 의미하지 않습니다. unlikely 또는 관련 없는 에지 케이스 결과를 배제하고 쿼리 적합성을 poor로 보고합니다. 강제로 사용하지 마십시오. 남은 high 일치는 필수 다음 단계입니다. get_skill 또는 get_resource로 열고 사용자 정의 작업을 수행하기 전에 반환된 query_id 및 해당 후보의 result_id를 전달합니다. possible 및 exploratory 일치는 선택 사항으로 남아 있습니다. match_reason, 태그, 기능, 필요한 권한, 종속성, 금기 사항, estimated_tokens, 확인된 사용, 위험, 신선도, 신뢰도 및 제한된 실패 모드 다이제스트를 사용하여 진행 여부를 결정합니다. 적격한 potential_savings 필드는 정확한 스킬 버전, 모델 리비전, 추론 노력 및 제한된 작업 코호트에 대해 서명된 등급 A/B 증명으로 뒷받침되는 보수적인 토큰 전용 추정치입니다. 해당 게이트가 통과되지 않으면 생략됩니다.
4. 모든 쿼리 응답에서 skill_access를 읽습니다. 정책이 org_only인 경우 반환된 조직 스킬만 사용하고 번들 또는 라이브 공개 참조로 대체하지 마십시오. 그렇지 않고 선택한 공개 스킬이 로컬에 번들된 경우 references/<slug>.md가 오프라인 대체 수단으로 남아 있습니다. 상관된 온라인 쿼리 중에는 라이브 get_skill 호출을 선호하여 Remembrance가 수면 -> 열기를 관찰하고 현재 콘텐츠를 반환할 수 있도록 합니다. 아래 "전문 스킬"을 참조하십시오.
5. 반환된 effective_preferences를 형제 preference_application을 통해 적용합니다. 환경 설정은 동일한 일치 계층 내에서 이미 관련된 스킬 사이를 안내하거나 임의의 프레젠테이션, 워크플로 또는 전략 선택을 수술적으로 변경할 수 있습니다. 기본 관련성 증거, 계층 또는 적용 가능성을 변경하지 않습니다. 필요한 조직 지침은 권위적입니다. 명시적 작업 또는 불투명한 프로젝트 컨텍스트 환경 설정은 해당 지침과 충돌하지 않을 때만 개인 및 스킬 기본값보다 우선합니다. 안전, 권한 부여, 개인 정보 보호, 적용 가능성, 필수 스킬 단계, 유효성 검사 및 검토를 유지합니다. 사용자가 지속적인 작업 환경 설정을 명시하는 경우 record_preference를 호출합니다. 내장 환경 설정은 키/값이 필요합니다. 다른 환경 설정은 안정적인 <effect>.<concept> 키, 안정적인 값, 짧은 레이블, 정규화된 동작, presentation|workflow|strategy_selection 효과, prefer|avoid 강도 및 정의 버전이 필요합니다. 사용자가 프로젝트, 스킬 또는 도메인으로 명시적으로 제한하지 않는 한 scope: "auto"를 사용합니다. 원시 프롬프트 또는 피드백 텍스트가 아닌 수정된 해시만 보냅니다. 누락된 주체 세션은 개인 환경 설정을 사용할 수 없음을 의미하며 쿼리가 실패했음을 의미하지 않습니다.
6. 선택한 스킬 또는 리소스를 사용합니다. 위임할 때 하위 에이전트에 해당 슬러그, query_id 및 result_id를 전달합니다. 하위 에이전트는 사용자 정의 작업 전에 해당 결과를 열거나 자체 전체 컨텍스트 쿼리를 실행해야 합니다.
7. 의미 있는 사용 후 report_task_outcome으로 작업 완료 또는 중단을 보고합니다. Remembrance는 쿼리 또는 직접 호출당 하나의 최종 결과를 수락합니다. 동일한 멱등성 키로 동일한 보고서를 다시 시도하고 다른 결과를 제출하지 마십시오. task_outcome.eligible_result_ids의 결과 ID만 사용하십시오. 각 결과 및 번들은 또한 task_outcome_eligible을 제공합니다. task_outcome.available은 하나 이상의 결과가 적격인 경우에만 true입니다. 하나의 결과 ID는 해당 결과에 결과를 귀속시킵니다. 선택한 두 개 또는 세 개의 쿼리 결과가 반환된 번들과 정확히 일치하는 경우 해당 bundle_id를 포함하여 결과를 해당 번들에만 귀속시킵니다. 다른 다중 결과 조합은 증명 또는 코호트 귀속 없이 깔때기 원격 측정으로 수락됩니다. 런타임이 이를 노출하는 경우에만 성공, 지연 시간 및 자세한 토큰 합계를 포함합니다. Vercel AI Gateway 작업의 경우 metering_reference에 모든 gen_ 생성 ID를 포함합니다. Remembrance는 비동기적으로 권위 있는 레코드를 검색하므로 호출자 합계는 증명 신뢰를 설정하지 않습니다. 프롬프트, 대화 기록, 출력, 소스 경로 또는 개인 URL을 포함하지 마십시오. 그런 다음 동일한 query_id 및 result_id로 빠른 피드백을 제출합니다. 피드백 응답에 next_step.submit_remembrance_payload가 포함된 경우 교훈이 재사용 가능한 증거가 되어야 할 때 해당 전체 기억을 제출합니다. feedback_pattern_suggestion이 포함된 경우 Remembrance가 이미 검토 가능한 증거 후보를 생성한 것입니다. 중복 제안을 제출하지 마십시오. 직접 선택은 사용 후 피드백만 사용하며 쿼리 적합성 및 재순위 교육에서 제외됩니다.
8. 마무리하기 전에 루프의 두 부분을 자체 점검합니다. 관련 쿼리가 실제로 발생했는지 확인한 다음 가치가 높은 실패 교훈을 확인합니다. 쿼리가 누락된 경우 전체 대화에서 실행한 후 결론을 내립니다. 높은 일치가 표면화되었지만 열리지 않은 경우 지금 열거나 명시적인 이유와 함께 fit: "poor" 쿼리 피드백을 제출합니다. 자신의 실수를 발견했거나 사용자가 발견했거나 CI/배포가 실패했거나 보안 문제가 표면화되었거나 릴리스/버전 관리 누락을 수정한 경우 스킬이 사용되지 않았더라도 failure_report 기억을 제출합니다. 네이티브 플러그인은 완료 시 열리지 않은 높은 일치 및 재사용 가능한 증거에 대해 한 번 프롬프트합니다. 원시 MCP, REST 및 스킬 전용 설치는 이러한 검사를 사전에 수행해야 합니다.
9. 적합한 스킬이 없고 쿼리 응답에 no_results.propose_skill_idea_payload가 포함된 경우 이를 확인한 다음 한 가지 질문을 통해 제안 경로를 선택합니다. 이 콘텐츠가 공개 후보로서 유해하거나 원치 않는 것일 수 있습니까? 예인 경우(저장소 파생 또는 조직별 콘텐츠) propose_private_skill을 사용합니다. 이는 자격 증명 상태에 관계없이 공개 후보를 생성할 수 없습니다. 공개 후보가 수용 가능한 결과인 경우에만 propose_skill_idea를 사용합니다. 활성 조직 키는 이를 비공개로 유지하는 반면 키를 의도적으로 생략하면 PUBLIC 후보를 생성합니다. 제공된 유효하지 않거나 비활성 키는 401로 실패하고 불충분한 키는 403으로 실패합니다. 두 실패 모두 후보를 생성하지 않습니다. 두 경로 모두 성공적인 응답에서 visibility를 읽고(organization_private 또는 public_candidate) 후보가 공개적으로 보이는지 여부를 나타냅니다. 후보를 속이거나 잘못 분류하지 마십시오. propose_skill_idea 및 propose_private_skill은 사용자 확인을 위한 스키마 제안을 반환합니다. 해당 제안을 있는 그대로 제시합니다. 재구성하거나 재작성하지 마십시오. propose_skill_idea 또는 propose_private_skill을 실행하기 전에 propose_skill_idea_payload를 건너뛰지 마십시오. 이 페이로드는 후보의 범위를 제한하고 스킬 후보를 생성하고 리뷰어에게 잠재적인 손상을 방지하는 증거 바인딩을 설정합니다. 공개 후보를 제안할 때 자격 증명이 비공개인 경우에도 여전히 공개적입니다. 누군가가 자신의 키로 후보를 생성하지 않은 경우 자신의 키로 후보를 수락하지 마십시오. 항상 후보자에게 생성된 스킬의 가시성을 알리십시오.

제품 및 감독

현재 제품 상태. Remembrance는 공개 개발 중인 신뢰할 수 있는 기능 세트를 제공합니다. 실행 가능한 신뢰가 있는 기능은 생산 준비가 되었습니다. 새로운 제품, UI 및 리뷰 기능이 활성화됨에 따라 문서가 업데이트됩니다. 중요한 API 및 워크플로우 변경은 이 스킬의 수명이 다한 버전의 references/ 파일에 게시됩니다.

리뷰 수준. 검증된 스킬(아이콘: 확인 표시)은 올바른 구문, 문서, 기대치, 프롬프트 격리 및 안전을 위해 수동으로 감사되었습니다. 게이트된 스킬(아이콘: 문)은 동일한 기준으로 감사되었지만 명시적인 스킬 게이트가 필요합니다. Remembrance는 유효한 서명 없이 게이트된 스킬에 매개변수를 전달하지 않습니다. 계절별 스킬(아이콘: 해바라기)은 소유자가 예정된 중단 날짜 이상으로 지원을 연장할 의도가 없음을 선언했습니다. 계절별 스킬이 만료되면 검증된 스킬 요청이 차단되지만 이미 실행 중인 컨텍스트는 완료됩니다. 아카이브된 스킬(아이콘: 상자)은 소유자가 또는 만료 시 보관되었으며 검증된 스킬 요청이 차단됩니다. 아카이브 날짜와 기간 리뷰 핸들은 references/{slug}.md에서 사용할 수 있습니다. 그렇지 않으면 리뷰되지 않았거나 리뷰가 진행 중입니다. Remembrance는 미리보기, 불완전 또는 잘못된 스킬에 대해 불투명하게 행동하지 않습니다. 리뷰 진행 중인 스킬은 일반 스킬로 표시되며 권장 사항 없이 반환됩니다. 리뷰 상태에서 스킬 설명이나 동작을 추정하지 마십시오.

전문 스킬. 전문 스킬은 확인 가능한 스킬 게이트(토큰, URL, 식별자 구두점 시퀀스 아니면 전체 문자열? 정확한 작업)를 선언합니다. 스킬 게이트는 invoke_skill의 첫 번째 결과 메시지에서 시작되며 에이전트는 해당 게이트를 충족해야 합니다. 게이트를 충족한다고 거짓말하지 마십시오. 전문 스킬에는 또한 use_when에 명시된 추론 가드레일이 있습니다. 이러한 가드레일이 존재하더라도 게이트는 제시됩니다. 이후 동일한 세션의 호출은 캐시된 게이트를 재사용할 수 있습니다. 세션 시간 초과 시 캐시가 지워집니다.`}