Community코딩 & 개발github.com

aitormf/agent-skills

사양 또는 계획 검토의 결과를 사용자와 하나씩 논의하고 사용자가 명시적으로 승인한 변경사항만 적용합니다. 그런 다음 결정의 영향을 받는 다른 초안 사양을 찾습니다. review-spec.md 또는 review-plan.md가 있고 사용자가 검토 결과를 적용하거나 폐기하려 할 때 사용하세요.

agent-skills란 무엇인가요?

이 스킬은 AI 에이전트가 사용자와 협력하여 사양 또는 계획 검토 문서(review-spec.md 또는 review-plan.md)의 각 검토 결과를 체계적으로 처리하도록 설계되었습니다. 사용자가 각 검토 결과를 명시적으로 승인, 수정, 폐기 또는 연기할 수 있도록 안내하며, 승인된 변경사항만 정확히 적용합니다. 핵심 원칙은 변경사항을 추론하거나 가정하지 않고 사용자의 명확한 결정을 기다리는 것입니다. Claude Code, Cursor, Codex 등 AI 코딩 에이전트에서 사용할 수 있으며, docs/specs/ 디렉토리 구조와 status frontmatter를 활용하여 작업 항목의 상태(draft/approved/obsolete)를 관리합니다. 적용 후에는 결정이 다른 진행 중인 사양에 영향을 미치는지 확인하고 필요 시 최소한의 변경만 제안합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aitormf/agent-skills/tree/HEAD/skills/apply-review

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

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

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

문서

검토 결과 적용하기

사용자가 각 검토 결과를 결정하고 승인한 것만 적용하도록 도와주세요.

핵심 규칙: 명시적인 결정 없이 변경을 추론, 가정 또는 적용하지 마세요. 검토 결과가 모호하면 옵션을 제시하기 전에 명확히 요청하세요. 각 검토 결과는 개별적으로 결정되며, 절대 그룹화하지 마세요.

아티팩트 및 상태

  • 각 작업 항목은 docs/specs/<YYYYMMDD>-<type>-<name>/에 있습니다.
  • spec.md와 plan.md는 frontmatter에 status: draft | approved | obsolete를 포함합니다. 오직 사람만이 approved를 설정할 수 있습니다.
  • approved였던 아티팩트를 변경하는 경우, 다시 draft로 설정하고 그 사실을 알리세요.

1단계: 검토 결과 제시

  1. 작업 항목과 검토 문서(review-spec.md 또는 review-plan.md)를 식별하세요. 명확하지 않으면 질문하세요.
  2. 모든 검토 결과를 번호를 매겨 나열하되, 차단성(blocking) 결과를 먼저 나열하세요. 각 결과에 대해 다음을 보여주세요:
    • 검토 결과 [N]: 검토 내용.
    • 제안된 수정 사항(있는 경우).
    • 옵션:
      • A) 수정 사항을 그대로 적용.
      • B) 수정된 수정 사항 적용(사용자가 설명).
      • C) 이유와 함께 폐기.
      • D) 연기.

진행하기 전에 사용자가 모든 결과에 답변할 때까지 기다리세요.

2단계: 확인

결정 요약
────────────────
[N] <제목> → 적용 / 수정 적용 / 폐기 / 연기

"이 결정들을 적용하기 전에 확인하시겠습니까?"라고 물어보세요. 확인 없이 진행하지 마세요.

3단계: 적용

  1. 확인된 변경사항(A 및 B)만 적용하고, 검토된 아티팩트에만 적용하세요. 다른 것은 건드리지 마세요.
  2. 검토 파일에서 각 검토 결과 아래에 결정 사항을 기록하세요:
    • 폐기된 경우: 이유.
    • 연기된 경우: 아직 보류 중인 사항.
  3. 사용자에게 현재 상황을 알리세요:
    • 열려 있는 차단성 검토 결과가 없으면, 아티팩트는 사용자가 approved로 표시하거나 다른 review-spec 패스를 받을 준비가 된 상태입니다.
    • 연기된 차단성 검토 결과가 남아 있거나 위험을 수반하는 폐기된 결과가 있으면 이를 지적하세요.

4단계: 다른 영향을 받는 사양

2단계의 결정이 진행 중인 다른 사양에 영향을 미치는지 확인하세요:

  1. docs/specs/*/spec.md에서 status: draft인 사양을 찾으세요.
  2. 각 사양에 대해 결정이 충돌을 일으키거나, 의존성을 변경하거나, 가정을 무효화하는지 추론하세요.
  3. 영향을 받을 수 있는 각 사양에 대해:
    • 어떤 사양, 어떤 섹션, 무엇을 변경해야 하는지 보여주세요.
    • "이 결정이 영향을 미치나요? 변경을 제안할까요?"라고 물어보세요. 네 또는 아니오라는 답변을 기다리세요.
  4. 답변이 '네'인 경우, 최소한의 변경(정확한 섹션과 줄)만 초안을 작성하고, diff를 보여준 후 승인 후에만 적용하세요.

해당 사양에서 다른 부분을 개선, 확장 또는 재구성하지 마세요. 어떤 단계에서든 무엇을 해야 할지 불분명하면 멈추고 질문하세요.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

관련 스킬