Skip to content

refactor(skills): deep-dive — 요청한 완료 지점까지 한 조사 담당이 이어 가고, 넘기기 전에 작성한 주장을 원문·계산과 대조한다 - #39

Merged
rainstorm0907 merged 1 commit into
rubato/basefrom
feat/deep-dive-endpoint-revision
Oct 31, 2026
Merged

rainstorm0907 merged 1 commit into
rubato/basefrom
feat/deep-dive-endpoint-revision

Conversation

@rainstorm0907

Copy link
Copy Markdown
Collaborator

무엇이 바뀌나

harness/skills/deep-dive의 세 파일이다. 정본 ~/.agents/skills/deep-dive는 같은 내용으로 이미 바뀌었고, 이 PR은 배포용 사본을 맞춘다. bundle-skills.sh를 돌리면 설치본과 사본이 이미 갈라져 있던 다른 스킬 60여 개도 함께 바뀌어서, 그 변경은 되돌리고 deep-dive만 담았다.

  • SKILL.md: 고정 기본 경로를 요청한 완료 지점으로 바꾼다. 질문 세우기, 결정적 원문 읽기와 조건 보존, 위임, 종료 판단을 한 조사 담당이 이어서 맡는다. 넘기기 전에 작성한 제목·요약·권고의 핵심 주장을 근거 대목·계산·적용 가정과 대조한다. 사용자 우선순위·취향·경험에 달린 선택을 돌려준다.
  • DESIGN_NOTES.md: 모양, 경과(6–8번), 사용자 결정의 현재 상태.
  • cases/photo-map.md: 실제 조사 후속 사례 한 절.

어떻게 확인했나

  • 정본 위치·로더·설명 파싱: 설치 엔진 loadSkillsFromDir로 진단 없이 읽힘(설명 226자, 그대로).
  • 고정 자료 2×2: 같은 요청과 자료로 기존/개정 × 리드 직접/전체 위임 네 번. 각 실행이 실제로 연 스킬 파일과 해시를 기록했다. 확인 항목 대부분은 같았다. 개정안은 다음 담당이 열 수 있는 기록 파일을 남겼다. 사용자 판단에 달린 선택이 빠지는 회귀가 보여서 복원했다.
  • 실제 조사 1건: 사진 수에 따른 지도 영상 구성. 위임 담당이 후보 스킬을 읽고 질문을 다시 세웠고, 원문을 직접 읽고, 수집은 Aside에 맡긴 뒤 결정적 주장을 다시 확인했다. 검토에서 제목·요약·권고의 범위 확대와 시간 검산 누락이 나와, 넘기기 전 점검 문장을 바꾸고 같은 담당이 기록을 고쳤다.

기록 자료(실행별 브리프·반환문·대화·평가)는 로컬 ~/reports/deep-dive-review-20261031/에 있다.

…대신 질문·원문 열람·조건 보존·위임·종료로 묶고, 넘기기 전에 작성한 주장을 원문과 계산에 대조한다

- 기본 경로와 "아무 단계에서나 멈춤"을 요청한 완료 지점으로 바꾼다. 단계는 중간 보고로 보이게 두고, 사용자가 멈추라고 한 단계에서만 멈춘다(사용자 결정 2026-10-31).
- 완료 지점이 없으면 근거만 넘기고, 사용자의 우선순위·취향·경험에 달린 선택을 돌려준다.
- 한 조사 담당(리드 또는 조사 전체를 맡은 에이전트)이 질문·원문·잠정 해석을 함께 쥐고, 찾은 것에 따라 다음 검색과 읽는 깊이를 바꾼다.
- 결정적 주장은 원문을 보고, 열람 범위와 주장·관찰·추론을 나눠 적는다. 모든 요약과 인계에서 판단을 바꾸는 조건을 붙여 둔다.
- 위임: 스킬을 읽을 수 있는 위임자는 스킬을 가리키고, 못 읽는 세션에는 규칙을 붙여 넣는다. 수집자는 담당이 기록할 자료를 돌려준다. Outpost는 자기 패킷 규칙을 따른다.
- 넘기기 전: 작성한 제목·요약·권고의 핵심 주장을 근거 대목이나 계산, 적용 가정과 대조하고 고친 내용을 기록과 전달문에 함께 반영한다.
- 근거: 고정 자료 2×2(기존/개정 × 리드 직접/전체 위임)와 실제 조사 1건. 실제 조사에서 조건은 정확히 적었지만 제목·요약·권고가 더 강한 규칙으로 바뀌고 자기 권고의 시간 검산을 빠뜨린 사례를 cases/photo-map.md 후속으로 남긴다.
@rainstorm0907
rainstorm0907 merged commit 76187fc into rubato/base Oct 31, 2026
1 check failed
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.

1 participant