gzb1128/skill-forge

수동 트리거 스킬. disable-model-invocation: true로 설정되어 모델이 작업 중간에 이 워크플로우를 자동으로 호출하지 못하게 합니다. 이 플러그인에서 설치한 경우 세션 종료 시 /agent-docs:learn으로 의도적으로 호출하세요. 후크, 백그라운드 작업, 자동 트리거 동작, 런타임 저장소, 벡터 데이터베이스, MCP 통합 또는 외부 메모리 시스템을 추가하지 마십시오.

이 세션에서 발생한 일을 검토하고 적절한 AGENTS.md 파일을 위한 검증 가능하고 검토 가능한 메모리 제안을 생성합니다. 사용자가 제안된 diff를 보고 명시적으로 승인할 때까지 파일을 편집하지 마십시오.

비유도성 원칙

코드베이스 자체에서 유도할 수 없는 정보만 기록하십시오. Hidden Knowledge 항목을 제안하기 전에 다음 질문을 하십시오:

다음 에이전트나 인간이 코드를 읽거나, git log를 실행하거나, 기존 문서를 확인하여 이것을 발견할 수 있습니까?

그렇다면, 숨겨진 지식으로 기록하지 마십시오. 기준이 높습니다. 대부분의 지식은 AGENTS.md가 아닌 소스, 커밋 메시지 또는 기존 문서에 속합니다.

1단계: 후보 인사이트 추출

현재 세션을 검토하고 후보 인사이트를 나열하십시오. 후보는 일반적으로 숨겨진 의존성, 오해를 유발하는 실패, 프로젝트 특유의 해결책, 중요한 순서, 명령어 발견 또는 문서 격차에서 비롯됩니다.

아직 아무것도 작성하지 마십시오. 먼저 각 후보를 분류하십시오.

2단계: 후보 분류

분류	대상	규칙
Hidden Knowledge	가장 가까운 관련 AGENTS.md의 ## Hidden Knowledge 아래	유도할 수 없는 숨겨진 의존성, 오해를 유발하는 오류, 해결책, 특이 사항 또는 중요한 순서에만 해당
Quick Reference	루트 AGENTS.md 빠른 참조 테이블	빌드, 테스트, 린트, 실행, 코드 생성, 정리 또는 기타 일반적인 명령어
Rule	제안된 대상만 보고	팀 규칙 또는 경계; /agent-docs:learn에서 docs/rules/를 생성하거나 수정하지 마십시오
Doc	제안된 대상만 보고	더 긴 설계, 문제 해결, 런북 또는 라이브러리 노트; /agent-docs:learn에서 문서를 생성하거나 수정하지 마십시오
Skip	기록 금지	유도 가능, 일회성, 중복, 오래됨, 일반적 또는 검증 불가능

숨겨진 지식 후보

비유도성 테스트를 통과한 후보만 숨겨진 지식이 될 수 있습니다:

1. 숨겨진 의존성: 명확하게 연결되지 않았지만 함께 변경해야 하는 파일 또는 모듈.
2. 오해를 유발하는 오류: 잘못된 위치나 원인을 가리키는 오류 메시지.
3. 해결책 및 특이 사항: 표준 패턴과 다른 프로젝트별 동작.
4. 중요한 순서: 특정 순서로 발생해야 하는 작업.

건너뛰기 기준

다음에 해당하는 후보는 건너뛰십시오:

• 코드 패턴, 아키텍처 또는 소스를 읽어서 볼 수 있는 파일 구조.
• git log 또는 git blame이 이미 기록하고 있는 Git 기록 또는 최근 변경 사항.
• 수정 사항이 이제 코드에 있고 커밋 메시지가 컨텍스트를 전달해야 하는 디버깅 솔루션.
• AGENTS.md, docs/rules/ 또는 README에 이미 존재하는 내용.
• 표준 언어 또는 프레임워크 동작.
• 빠른 참조에 속하는, 명확하지 않은 명령어.
• 일시적으로 실패한 시도를 포함한 임시 세션 세부 정보.
• 검증되지 않은 주장.

3단계: 각 보유 후보 검증

모든 보유 후보는 제안되기 전에 명시적인 증거가 필요합니다:

후보가 언급하는 대상	검증 증거
파일 경로	ls 또는 파일을 읽어 경로가 존재하는지 확인
함수, 타입, 명령어 또는 심볼	검색 또는 언어 인식 조회로 존재 확인
동작 또는 제약 조건	가장 작은 관련 명령어를 실행하거나, 소스를 검사하거나, 직접 실행이 안전하지 않은 이유를 설명
기존 AGENTS.md 내용	대상 섹션을 읽고 오래되었거나 중복된 항목 확인

검증에 실패하면 후보를 Skip으로 분류하고 실패한 검사를 설명하십시오. 검증을 안전하게 수행할 수 없으면 검증되지 않은 것으로 보고하고 쓰기를 제안하지 마십시오.

4단계: 대상 선택

영향을 받는 범위에 가장 가까운 AGENTS.md를 선택하십시오:

인사이트 범위	대상 파일
전체 프로젝트에 영향	루트 AGENTS.md
특정 패키지에 영향	<package>/AGENTS.md
복잡한 모듈에 영향	<package>/<module>/AGENTS.md, 하위 패키지 기준이 충족되는 경우에만

Hidden Knowledge의 경우 대상 AGENTS.md의 끝 부분에 ## Hidden Knowledge 섹션을 추가하거나 추가하십시오. 각 인사이트를 1-3줄로 유지하십시오.

Quick Reference의 경우 루트 AGENTS.md 테이블에 행 업데이트를 제안하십시오.

Rule 및 Doc의 경우 제안된 대상만 보고하십시오. 이 명령어로 규칙 문서, 설계 문서, 문제 해결 문서, 런북 또는 라이브러리 문서를 생성하거나 수정하지 마십시오.

5단계: 먼저 제안된 변경 사항 표시

파일을 편집하기 전에 모든 제안을 다음 형식으로 표시하십시오:

## 학습 제안

### 1. `<분류>` -> `<대상 파일>`

**이유:** <향후 세션에 도움이 되는 한 줄 이유>

**검증:** <경로/심볼/명령어/동작 증거>

**조치:** <추가/업데이트/건너뛰기/보고전용>

```diff
- <승인된 기존 항목을 업데이트하는 경우에만 기존 줄>
+ <정확한 제안된 추가 또는 교체>
```

### 건너뛴 후보

1. `<후보>` -> <이유>로 건너뜀

### 보고 전용 제안

1. `<후보>` -> <제안된 대상>에 속함, `/agent-docs:learn`에서 처리되지 않음

diff 및 승인 단계를 건너뛰지 마십시오. 사용자가 빠르게 적용을 요청하더라도 사용자는 정확한 제안된 변경 사항을 보고 먼저 승인해야 합니다.

6단계: 승인된 변경 사항만 적용

승인 후:

1. 사용자가 승인한 제안만 적용하십시오.
2. 기존 AGENTS.md 구조를 유지하고 추가 사항을 간결하게 유지하십시오.
3. /agent-docs:learn에서 일반 정리를 수행하지 마십시오. 오래되었거나 중복되었거나 잘못 배치된 기존 메모리는 /agent-docs:remember를 사용하십시오.
4. 무엇이 변경되었는지, 어디서 변경되었는지, 어떤 후보가 건너뛰어졌는지 보고하십시오.

절차

1. 대화 기록을 검토하여 후보 인사이트를 찾습니다.
2. 각 후보를 Hidden Knowledge, Quick Reference, Rule, Doc 또는 Skip으로 분류합니다.
3. Hidden Knowledge 후보에 비유도성 테스트를 적용합니다.
4. 모든 보유 후보를 검증하고 증거를 기록합니다.
5. 올바른 AGENTS.md 대상 또는 보고 전용 대상을 선택합니다.
6. 제안된 diff와 건너뛴 후보를 표시합니다.
7. 명시적인 사용자 승인을 기다립니다.
8. 승인된 AGENTS.md 변경 사항만 적용합니다.
9. 최종 쓰기, 건너뛰기 및 남은 보고 전용 제안을 보고합니다.