memory skill
✓ 인증됨에이전트가 검증된 재사용 가능 지식과 프로젝트 컨벤션을 검색, 저장 및 업데이트할 수 있는 내구성 있는 지식 계층을 제공합니다.
- GitHub 스타
- 1,663
- 파일
- 2
- 마지막 커밋
- 2026년 11월 9일
- 라이선스
- Apache-2.0
- 허용된 도구
- —
memory skill은 무엇을 하나요?
memory은(는) agent skill입니다. 에이전트가 검증된 재사용 가능 지식과 프로젝트 컨벤션을 검색, 저장 및 업데이트할 수 있는 내구성 있는 지식 계층을 제공합니다.
skill의 SKILL.md에서 생성된 요약입니다.
memory skill 정보
이 SKILL은 AI 에이전트가 개발 프로젝트를 위한 내구성 있는 지식 계층을 유지할 수 있도록 지원합니다. 에이전트는 검증된 프로젝트 컨벤션, 재사용 가능한 수정 사항, 아키텍처 규칙을 검색, 저장 및 업데이트하여 서로 다른 세션에서 실수를 반복하는 것을 방지할 수 있습니다. 개발자는 npx ai-devkit@latest memory 명령어를 통해 memory CLI를 사용하여 이 정보를 관리하며, 이를 통해 중요한 작업을 수행하기 전에 기존 컨텍스트를 먼저 검색하도록 보장합니다.
에이전트는 장기적인 보존이 필요한 복잡한 서브시스템, 에러 패턴 또는 특정 프로젝트 제약 조건을 만났을 때 이 도구를 로드해야 합니다. 이 도구는 global, 특정 프로젝트 또는 단일 리포지토리로 스코프를 지정할 수 있는 구조화된 지식 엔트리를 생성합니다. 정보 유지를 위해 일반적으로 ~/.ai-devkit/memory.db에 위치한 로컬 데이터베이스를 사용합니다. 단순한 채팅 트랜스크립트와 달리, 이 시스템은 비밀번호, 원시 로그, 임시 작업 진행 상황을 제외하고 검증된 재사용 가능 지능에만 집중하도록 품질 게이트를 적용합니다.
agent가 수행할 수 있는 작업
- 1프로젝트 컨벤션 검색새로운 구현 작업을 시작하기 전에 확립된 코딩 표준이나 아키텍처 규칙을 검색합니다.
- 2검증된 기술적 수정 사항 저장테스트 결과나 명령어 출력으로 확인된 특정 명령어 또는 디버깅 패턴을 저장합니다.
- 3오래된 지식 업데이트코드베이스의 새로운 증거가 저장된 정보와 상충할 때 기존 메모리 엔트리를 수정합니다.
- 4스코프별 지식 정리전체 global 환경 대신 단일 리포지토리에 특정 기술적 제약 조건을 적용합니다.
skill의 SKILL.md를 기반으로 작성되었습니다. 모든 사용 사례는 해당 문서의 인용구와 대조 확인되었습니다.
memory skill 설치 방법
각 명령은 skill 폴더를 클라이언트의 skills 디렉터리에 복사합니다. 클라이언트를 재시작하거나 새 세션을 시작하여 로드하세요.Claude Code에 memory skill 설치
~/.claude/skills/memory/SKILL.md
$ npx degit codeaholicguy/ai-devkit/skills/memory ~/.claude/skills/memoryClaude Code (project)에 memory skill 설치
.claude/skills/memory/SKILL.md
$ npx degit codeaholicguy/ai-devkit/skills/memory .claude/skills/memoryCodex에 memory skill 설치
~/.agents/skills/memory/SKILL.md
$ npx degit codeaholicguy/ai-devkit/skills/memory ~/.agents/skills/memoryGemini CLI에 memory skill 설치
~/.gemini/skills/memory/SKILL.md
$ npx degit codeaholicguy/ai-devkit/skills/memory ~/.gemini/skills/memoryClaude.ai에 memory skill 설치
npx degit codeaholicguy/ai-devkit/skills/memory memory && zip -r memory.zip memory # claude.ai → Customize → Skills → + → Create skill → Upload a skill → memory.zip
자동 검사
2026년 11월 15일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 보안 감사는 아닙니다. 에이전트가 실행하기 전에 스크립트를 읽어 보세요. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능codeaholicguy/ai-devkit/skills/memory is public and reachablegithub.com/codeaholicguy/ai-devkit/tree/HEAD/skills/memory ↗통과
- 오픈 소스 라이선스 (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit 2026-11-09github.com/codeaholicguy/ai-devkit/commits ↗통과
- 스크립트에 다운로드 후 실행이나 자격 증명 탈취가 없음No scripts in the skill folder통과
- SKILL.md에 숨겨진 지침 없음No override phrases, safeguard switches, credential requests or hidden charactersgithub.com/codeaholicguy/ai-devkit/blob/HEAD/skills/memory/S ↗통과
- 사전 허용 도구가 제한됨No pre-approved tools; the agent asks before using onegithub.com/codeaholicguy/ai-devkit/blob/HEAD/skills/memory/S ↗통과
- SKILL.md가 Agent Skills 형식을 따름the description does not say when to use the skillgithub.com/codeaholicguy/ai-devkit/blob/HEAD/skills/memory/S ↗결함 발견
SKILL.md
GitHub에서 보기AI DevKit Memory CLI
Use npx ai-devkit@latest memory ... as the durable knowledge layer.
Workflow
-
For implementation, debugging, review, planning, or documentation tasks, search before deep work unless the task is trivial:
npx ai-devkit@latest memory search --query "<task, subsystem, error, or convention>" --limit 5For broad or risky tasks, search multiple angles: subsystem, error text, framework, command, and task intent.
-
Use results as context:
- Trust repo files, tests, fresh command output, and explicit user instructions over memory.
- If memory conflicts with verified evidence, use the evidence and update the stale memory.
- Mention memory only when it changes the plan or avoids asking the user again.
-
Search before storing:
npx ai-devkit@latest memory search --query "<knowledge to store>" --table -
Store or update only after the quality gate passes.
Quality Gate
Before storing, all must be true:
- Future sessions are likely to reuse it.
- It is verified by code, docs, tests, command output, or explicit user instruction.
- It is not merely a restatement of obvious nearby files unless it prevents repeated agent mistakes.
- It is scoped narrowly enough.
- Existing memory does not already cover it.
- It contains no secrets, credentials, private customer data, personal data, raw logs, or temporary paths.
Store:
- Project conventions, user preferences, durable decisions.
- Reusable fixes, testing patterns, commands, setup gotchas.
- Non-obvious constraints, architecture rules, failure patterns.
Do not store:
- Task progress, transcripts, speculation, generic programming facts.
- Raw errors without diagnosis.
- Anything the user did not intend to persist.
Commands
Search
npx ai-devkit@latest memory search \
--query "<query>" \
--tags "<tags>" \
--scope "<scope>" \
--limit 5
Use --table to get IDs for updates:
npx ai-devkit@latest memory search --query "<query>" --table
Options: --query/-q required; --tags; --scope/-s; --limit/-l from 1-20; --table.
Store
npx ai-devkit@latest memory store \
--title "<actionable title, 10-100 chars>" \
--content "<context, guidance, evidence, exceptions>" \
--tags "<lowercase,tags>" \
--scope "<global|project:name|repo:org/repo>"
Use this content shape when helpful:
Context: Where this applies.
Guidance: What to do.
Evidence: File, command, test, or user instruction.
Exceptions: When not to apply it.
Update
Find the ID with search --table, then update only changed fields:
npx ai-devkit@latest memory update \
--id "<memory-id>" \
--title "<updated title>" \
--content "<updated content>" \
--tags "<replacement,tags>" \
--scope "<updated scope>"
--tags replaces all existing tags.
Scoping
Use the narrowest useful scope:
repo:<org/repo>for one repository.project:<name>for one app, product, or workspace.globalonly for knowledge that applies across unrelated projects.
If unsure, use a narrower scope.
Troubleshooting
- CLI missing: run
npx ai-devkit@latest --version. - Duplicate title: search, then update the existing item if it is the same knowledge.
- Empty results: broaden terms, remove filters, or search symptoms and subsystem names separately.
- Validation error: check title/content lengths, query length, and
--limitrange. - DB path: default is
~/.ai-devkit/memory.db; project config can override it automatically.
이 스킬의 파일
2memory skill 질문
Claude Code에 memory skill을 어떻게 설치하나요?
npx degit codeaholicguy/ai-devkit/skills/memory ~/.claude/skills/memory를 실행합니다. Claude Code는 ~/.claude/skills(모든 프로젝트) 또는 .claude/skills(한 프로젝트)에서 skills를 로드하며, 설명이 작업과 일치할 때 skill을 사용합니다.
memory skill을 사용할 수 있는 클라이언트는 무엇인가요?
Agent Skills 형식을 읽는 모든 클라이언트(Claude Code, Codex, Gemini CLI, claude.ai(ZIP으로 업로드))가 사용할 수 있습니다. skill 내 스크립트는 클라이언트가 코드 실행을 허용하는 경우에만 실행됩니다.
memory CLI에 저장하지 말아야 할 것은 무엇인가요?
작업 진행 상황, 트랜스크립트, 추측, 일반적인 프로그래밍 사실, 진단되지 않은 원시 에러, 그리고 모든 비밀번호나 자격 증명은 저장하지 마십시오.
사용 가능한 메모리 스코프 옵션은 무엇인가요?
repo:<org/repo>를 사용하여 특정 리포지토리에 지식을 제한하거나, project:<name>를 사용하여 특정 프로젝트에 제한할 수 있습니다. 모든 프로젝트에 적용되는 지식은 global을 사용합니다.