Improve (개선)
경로: ${CLAUDE_SKILL_DIR}은 이 SKILL.md가 포함된 폴더를 의미하며, ${CLAUDE_SKILL_DIR}/../..은 그보다 두 레벨 위에 있는 편집기의 .claude/ 폴더입니다.
모든 질문은 질문 상자에 표시합니다: AskUserQuestion 도구를 호출하세요(2-4개 옵션, 권장 옵션을 먼저 표시). 해당 도구가 없는 에이전트의 경우에만 번호가 매겨진 질문을 텍스트로 표시하세요.
이 스킬은 저장소 체크아웃 환경에서 유지보수자를 위해 실행됩니다. 여기서의 수정은 모든 사용자의 다음 업데이트에 반영됩니다. S="${CLAUDE_SKILL_DIR}/scripts"입니다. Mac 및 Linux에서는 python3, Windows에서는 py로 스크립트를 실행합니다.
0. 실행 주체 확인
python3 "$S/improve.py" mode
maintainer: AI_EDITOR_MAINTAINER=1 환경 변수가 설정된 저장소의 git 체크아웃인 경우에만 해당하며, 1단계로 진행합니다.
user: 편집기 자체 파일은 매 업데이트마다 교체되므로 절대 편집하지 마세요(SKILL.md, reference, script 또는 PRINCIPLES.md 없음). 아래와 같이 수집 및 선택한 후, 각 수락 항목을 업데이트로 덮어쓰지 않는 사용자 고유 레이어(저장소의 docs/customise.md)에 저장합니다:
taste.py add ... --set을 사용한 설정python3 "${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py" rule "<rule>"을 사용한 단어 규칙custom/captions/<name>.json과taste.py set captions.preset <name>을 사용한 캡션 모양custom/templates/<type>.json을 사용한 템플릿 기본값
그런 다음 taste.py suggest를 실행하여 유지보수자가 모든 사용자를 위해 수정할 수 있도록 합니다. 여기서 중단합니다.
1. 수집
python3 "$S/improve.py" collect [--edits D] [--no-gh]
한 줄에 하나의 규칙, 가장 많이 반복된 순서대로 표시: 발생 횟수, 출처(제안, taste 회귀, 미리보기 교정, 리뷰 노트, GitHub 이슈), 소유자 이름, 최대 세 개의 예시. 여러 사용자가 말했거나 적용 후 다시 말한 규칙이 먼저 표시됩니다.
2. 선택
큐의 맨 위를 표시하고 질문 상자에서 지금 수정할 항목을 묻습니다(다중 선택, 가장 많이 반복된 순서대로, 권장 사항을 먼저 표시). 각 항목에 대해 불명확한 경우 다음 중 하나를 함께 묻습니다:
- 모든 사용자 (권장)
- 일부 크리에이터의 스타일만 (규칙이 아닌 style.json 필드에 속함)
- 수정하지 않음 (닫기)
3. 각 항목을 다음 순서대로 수정
- 규칙.
${CLAUDE_SKILL_DIR}/../../PRINCIPLES.md의 적절한 제목 아래에 한 줄로 작성하고, 어디에서 강제되는지 명시합니다. 동일한 규칙을 소유한 SKILL.md 또는 reference에도 작성합니다. 일반적이어야 하며 특정 비디오에 관한 내용이 아니어야 합니다: "0:12의 줌이 끊겼다"가 아닌 "줌은 최소 0.5초 동안 부드럽게 전환". - 강제화. 누구도 기억하지 않아도 규칙이 유지되도록 하는 최소한의 코드: 검사(
check.py,quality.py,product.py check,ai_tells.py)에서 FAIL, 이를 위반할 스크립트에서의 거부(gates.py), 이를 생성할 수 없는 기본값, 또는 저장소 규칙에 대한tests/check_plugins.py의 한 줄. 기존 검사를 강화하는 것이 새 검사를 추가하는 것보다 선호됩니다. - 테스트. 해당 스크립트의
demo()(또는tests/)에 있는 assert 문을 작은 합성 예제로 만듭니다. 수정 전에 실행하여 실패를 확인하고, 수정 후에 실행하여 통과를 확인합니다. 에이전트만 따를 수 있는 규칙(질문, 설명)은 대신evals/에 평가 케이스를 추가합니다:prompt.md와tool_used또는llm채점기. - 기록.
docs/feedback-matrix.md: 규칙, 작성 위치, 강제화 내용, 테스트 내용.
4. 모든 항목 실행
python3 tests/check_plugins.py
python3 .claude/lib/ai_editor/okf.py check
그런 다음 tests/demos.sh(모든 스크립트의 데모), node tests/test_record.mjs, 그리고 렌더러가 설정된 경우 tests/smoke.py 및 tests/golden.py를 실행합니다. 모두 통과해야 넘깁니다. 커밋하지 마세요. 유지보수자가 diff를 검토하고 커밋합니다.
이제 수정된 GitHub 이슈에 대해, 수정 사항을 한 줄로 요약하고 이슈를 닫겠다는 제안(gh issue close <n> --comment "...")을 묻고 난 후에만 제공합니다.
절대 하지 말 것
- 절대 사용자의 taste.md, taste.json, rules.json 또는 suggestions.jsonl을 편집하지 마세요: 그들은 사용자의 것입니다.
- 절대 개인 데이터를 저장소에 넣지 마세요: 피드백에서 나온 이름, 핸들, 이메일, 파일 이름 또는 영상이 없어야 합니다. 일반 규칙과 합성 예제를 작성하세요.
tests/check_plugins.py는 알려진 개인 이름에서 실패합니다. 모든 예제를 넣기 전에 읽으세요. - 절대 메모만으로 작업을 마무리하지 마세요. 강제화와 테스트가 없는 규칙은 완료된 것이 아닙니다.
파일
scripts/improve.py:mode,collect,demo. 읽기 전용입니다.${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py: 사용자의<library>/custom/폴더(사용자 모드에서 여기에 씁니다).${CLAUDE_SKILL_DIR}/../../skills/taste/scripts/taste.py:suggest및issue가 사용자 측을 작성하는 곳입니다.