Skip to content

feat: agent/skill reuse-design guideline (Phase 3-0, 4-0)#17

Open
myeongseoklee wants to merge 1 commit into
revfactory:mainfrom
myeongseoklee:feat/agent-skill-reuse-guideline
Open

feat: agent/skill reuse-design guideline (Phase 3-0, 4-0)#17
myeongseoklee wants to merge 1 commit into
revfactory:mainfrom
myeongseoklee:feat/agent-skill-reuse-guideline

Conversation

@myeongseoklee
Copy link
Copy Markdown

Summary

  • 하네스를 반복 구축할 때 역할이 겹치는 에이전트/스킬이 다른 이름으로 누적되는 문제를 방지하기 위한 가이드라인 추가
  • Phase 3-0 / 4-0에 신규 에이전트·스킬 생성 전 중복 검토 단계를 명시
  • agent-design-patterns.md에 "에이전트 재사용 설계" 섹션을 추가하여 스킬 측 가이드(skill-writing-guide.md §9)와 대칭 맞춤

Motivation

Phase 1.3에 기존 에이전트/스킬과의 중복 분석이 있지만, Phase 선택 매트릭스상 "에이전트 추가"·"스킬 추가/수정" 시나리오에서 Phase 1이 건너뛰어진다. 결과적으로 신규 생성 직전 단계에 중복을 확인하는 actionable 지침이 없어, 하네스를 반복 구축하면 유사한 에이전트/스킬이 누적되기 쉽다.

skill-writing-guide.md의 "일반화하라" 원칙(§2)은 스킬 내부 콘텐츠의 일반화를 다루는 것이며, 스킬/에이전트 단위 중복 회피와는 별개 문제다.

Scope of change

  • skills/harness/SKILL.md — Phase 2-3 포인터 확장, Phase 3-0 신규, Phase 4-0 신규, Phase 선택 매트릭스 수정, 산출물 체크리스트 2줄 추가
  • skills/harness/references/agent-design-patterns.md — "에이전트 재사용 설계" 섹션 신규
  • skills/harness/references/skill-writing-guide.md — §9 "스킬 재사용 설계" 신규
  • CHANGELOG.md[Unreleased] 섹션 추가

Tests

문서·가이드 변경이므로 자동 실행 테스트 없음. 다음을 수동으로 확인:

  • SKILL.md Phase 3-0/4-0 포인터 문구와 references 섹션 제목 일치 확인 (grep 통과)
  • git diff main | grep -i 'opus\|model:' 결과 없음 — model: "opus" 미접촉 확인

CHANGELOG

Y — [Unreleased] 섹션 추가

SemVer impact

minor (feat:) — 기존 동작에 영향 없는 additive 변경


🤖 Generated with Claude Code

- 신규 에이전트/스킬 생성 전 중복 검토 단계를 명시 (Phase 3-0, 4-0)
- agent-design-patterns.md에 "에이전트 재사용 설계" 섹션 추가
- skill-writing-guide.md에 §9 "스킬 재사용 설계" 추가
- Phase 선택 매트릭스와 산출물 체크리스트 정합

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants