Community코딩 & 개발github.com

marcosbarrosdemiranda/claude-skill-fluxo-de-entrega

프로젝트 파일 변경 후 문서화, Git 동기화, Obsidian 메모리 저장을 자동으로 수행하는 스킬입니다.

claude-skill-fluxo-de-entrega란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code 등)가 작업을 완료한 후, 변경된 모든 파일을 문서화하고 Git을 통해 동기화하며, 구조화된 기록을 Obsidian 볼트에 저장하는 전체 워크플로를 자동화합니다. 개발자는 'finaliza', 'commita', 'salvar memória' 등의 명령어를 통해 또는 작업 완료 시 자동으로 이 스킬을 트리거할 수 있습니다. 지원 플랫폼은 Obsidian과 Git 기반 프로젝트이며, YAML 프론트매터, Conventional Commits, 링크 그래프 등을 활용해 지식 관리와 협업을 강화합니다. 핵심 단계는 1) 문서 업데이트, 2) git pull --rebase 후 Conventional Commit, 3) dev 브랜치로 push, 4) 프로덕션 배포 여부 확인, 5) Obsidian에 히스토리, 상태, 인덱스 저장 및 세션 관리입니다. 이 스킬을 통해 세션 간 작업 연속성, 자동화된 변경 추적, 그리고 장기적인 프로젝트 메모리를 확보할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/marcosbarrosdemiranda/claude-skill-fluxo-de-entrega/tree/HEAD/.claude/skills/fluxo-de-entrega

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Fluxo de Entrega e Memória Integrada ao Obsidian

이 스킬은 작업 전달, 세션 간 동기화 및 Obsidian(VAULT_MEMORIA)에 구조화된 메모리 저장의 전체 주기를 관리합니다.

필수 단계 순서

  1. 문서화

    • 영향을 받은 문서(README.md, 주석, CHANGELOG.md - 날짜와 설명 포함)를 업데이트하세요.
    • 변경할 문서가 없으면 최소한 CHANGELOG.md에 기록하세요.
  2. 커밋 및 동기화

    • 테스트 실행(있는 경우). 실패하면 중단하세요.
    • 비밀 정보(.env, 토큰, 비밀번호)가 없는지 확인하세요.
    • dev 브랜치에서 git pull --rebase 실행. 충돌이 있으면 중단하고 파일을 표시하세요(다른 세션의 변경을 절대 폐기하지 마십시오).
    • Conventional Commits(feat, fix, docs, refactor, chore...)을 사용하여 변경된 모든 내용을 커밋하고, 명확한 포르투갈어 메시지를 작성하세요(해당하는 경우 - parcial 표시).
  3. GitHub에 푸시

    • dev 브랜치로 푸시(없으면 생성). 절대 push --force를 사용하지 마십시오.
  4. 프로덕션에 대해 묻기

    • 질문: "이 버전을 프로덕션에 올리시겠습니까?"
    • 예인 경우: 테스트 실행, dev에서 main으로 병합 후 배포.
    • 아니오인 경우: 5단계로 진행.
  5. Obsidian에 기록 저장 (압축 및 동기화)

    • 상세 기록 (historico/AAAA-MM-DD.md) : 상단에 YAML 프론트매터(날짜, 프로젝트, 태그( #feat|#fix|#config|#decisao ), 커밋)를 포함합니다. 레코드는 ## HH:MM - 제목 #tag, 요청, 완료된 작업, 결정 사항, 파일, 커밋, 프로덕션, 문제점, 보류 사항 형식입니다. 그래프를 채우기 위해 [[ ]] 링크를 사용하세요.
    • 압축된 상태 (ESTADO.md) : 프로젝트의 ESTADO.md 재작성(최대 60줄, 전보체 스타일):
      • 현재 상태
      • 최근 10개 변경 사항(각 1줄: 날짜, 요약, 해시)
      • 유효 결정 사항
      • 열린 보류 사항
    • 글로벌 인덱스 (INDICE.md) : 글로벌 Claude/INDICE.md에 한 줄 추가: "AAAA-MM-DD HH:MM [프로젝트] 짧은 요약". 최근 30일만 유지(그 이전은 INDICE-ARQUIVO.md로 이동).
    • 활성 세션 및 메모 : SESSOES-ATIVAS.md 및 RECADOS.md 업데이트. 세션 종료 시 활성 레코드를 제거합니다.

최종 요약

각 단계별 한 줄 요약 표시:

  • 문서화됨: [ok]
  • 동기화/커밋: [ok/해시]
  • 푸시: [ok/dev]
  • 프로덕션: [예/아니오]
  • Obsidian 기록: [ok]

관련 스킬