109 lines
8.1 KiB
Markdown
109 lines
8.1 KiB
Markdown
---
|
|
name: analyze-roadmap-position
|
|
version: 1.5.0
|
|
description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확인 요청에 대해 활성 Milestone과 코드 상태를 함께 읽어 현재 작업 지점, Milestone 문서 링크, 남은 일을 추정하는 읽기 전용 스킬"
|
|
---
|
|
|
|
# 작업 지점 분석
|
|
|
|
## 목적
|
|
|
|
현재 브랜치, 변경 파일, 코드 구조, 활성 Milestone 문서를 함께 분석해 지금 작업이 어느 Milestone에 걸쳐 있는지와 남은 작업 후보를 보고한다.
|
|
결과에는 추정한 Milestone의 문서 링크를 항상 함께 출력한다.
|
|
Milestone의 `필수 기능` 항목에 item-id가 있으면 남은 작업과 판단 근거에 함께 표시해 사용자가 짧은 id로 후속 지시를 할 수 있게 한다.
|
|
결과 보고는 `agent-ops/skills/common/_templates/roadmap-position-report-template.md` 템플릿의 섹션, 필드, 순서를 그대로 따라 작성한다.
|
|
`current.md`만 보고 현재 작업 위치를 단정하지 않고, 실제 코드 상태와 요청 내용을 근거로 판단한다.
|
|
|
|
## 언제 호출할지
|
|
|
|
- 사용자가 "지금 작업이 뭐지?", "현재 작업이 뭐야?", "어디까지 했지?"라고 물을 때
|
|
- 사용자가 현재 브랜치 또는 변경 파일 기준으로 남은 작업을 알고 싶어 할 때
|
|
- 활성 Milestone 안에서 이번 요청이 어느 범위에 속하는지 확인해야 할 때
|
|
- 구현 전에 로드맵 기준 작업 위치를 가볍게 점검해야 할 때
|
|
|
|
## 입력
|
|
|
|
- `question`: 사용자의 현재 작업 지점 질문 또는 남은 작업 질문 (선택)
|
|
- `scope`: 분석할 경로, 기능명, 도메인명, 브랜치명 힌트 (선택)
|
|
- `depth`: `quick` 또는 `deep` (선택, 없으면 `quick`)
|
|
|
|
## 먼저 확인할 것
|
|
|
|
- [ ] `agent-ops/skills/common/_templates/roadmap-position-report-template.md`를 읽어 최신 답변 템플릿 확인
|
|
- [ ] `agent-ops/roadmap/current.md` 존재 여부 확인
|
|
- [ ] `current.md`의 활성 Milestone 목록이 가리키는 문서 존재 여부 확인
|
|
- [ ] 활성 Milestone 목록이 `agent-ops/roadmap/archive/**` 경로를 가리키지 않는지 확인
|
|
- [ ] 활성 Milestone 이름과 문서 경로를 결과 출력에 쓸 Markdown 링크로 기록
|
|
- [ ] git 저장소이면 현재 브랜치, `git status --short`, 변경 파일 목록 확인
|
|
- [ ] 변경 파일이 있으면 `agent-ops/rules/project/rules.md`의 도메인 매핑 기준으로 관련 domain rule 확인
|
|
|
|
## 실행 절차
|
|
|
|
1. **활성 Milestone 창 확인**
|
|
- `agent-ops/roadmap/current.md`를 읽고 활성 Milestone 후보와 선택 규칙을 파악한다.
|
|
- `current.md`의 후보가 `agent-ops/roadmap/archive/**`를 가리키면 해당 문서는 읽지 말고 로드맵 갱신 필요 항목으로 기록한다.
|
|
- 활성 Milestone 문서를 모두 읽되, 목록이 많으면 사용자 요청이나 변경 파일과 관련 높은 문서부터 읽는다.
|
|
- 읽은 Milestone은 `<milestone-name>: <path>` 형태로 보존하고, 결과 보고에서는 `[<milestone-name>](<path>)` Markdown 링크로 출력한다.
|
|
- `current.md`가 없거나 형식이 맞지 않으면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 불확실성을 보고한다.
|
|
|
|
2. **작업 흔적 확인**
|
|
- git 저장소이면 `git branch --show-current`, `git status --short`, `git diff --name-only`, 필요 시 `git diff --stat`을 확인한다.
|
|
- 변경 파일이 없으면 사용자의 요청 문장과 최근 대상 경로 힌트를 기준으로 추정한다.
|
|
- 변경 파일이 있으면 관련 코드와 테스트 파일을 필요한 만큼만 읽는다.
|
|
|
|
3. **Milestone 매칭**
|
|
- 활성 Milestone의 목표, 범위, 완료 기준, 범위 제외 항목과 변경 파일/요청 내용을 비교한다.
|
|
- 활성 Milestone의 `필수 기능` 체크리스트를 확인하고, 관련 항목에 item-id가 있으면 판단 근거와 남은 작업에 item-id를 함께 기록한다.
|
|
- 여러 Milestone 후보에서 같은 item-id가 보이면 item-id만으로 위치를 확정하지 말고 Milestone 이름과 문서 링크를 함께 제시한다.
|
|
- 활성 Milestone의 `구현 잠금` 섹션, 상태, `결정 필요` 항목을 함께 확인한다. 섹션이 없거나 상태가 `잠금`이면 현재 요청에 직접 영향을 주는 사용자 결정 항목과 배경 미정 항목을 구분해 보고하고, 결정이 모두 정해진 작업이면 로드맵에서 해제 가능하다고 보고한다.
|
|
- 하나의 Milestone에 명확히 속하면 단일 후보로 보고한다.
|
|
- 둘 이상의 Milestone에 걸치면 복수 후보로 보고하고, 어떤 파일이나 기능이 어느 Milestone에 닿는지 나눈다.
|
|
- 활성 Milestone 밖으로 보이면 `ROADMAP.md`의 Milestone 목록을 확인하고 전환 또는 신규 Milestone 필요성을 제안한다.
|
|
|
|
4. **남은 작업 분류**
|
|
- `확인됨`: 코드, 문서, 테스트, diff로 근거가 있는 남은 작업
|
|
- `추정됨`: 구조상 필요해 보이지만 추가 확인이 필요한 작업
|
|
- `확인 필요`: 현재 요청에 직접 영향을 주는 제품 판단, 범위 결정, 사용자 의도가 필요한 작업
|
|
- 완료 여부는 evidence 없이 확정하지 않는다.
|
|
|
|
5. **결과 보고**
|
|
- `agent-ops/skills/common/_templates/roadmap-position-report-template.md`를 기준으로 출력한다.
|
|
- 템플릿의 섹션 제목, 필드명, 순서를 바꾸지 않는다.
|
|
- 템플릿의 모든 필드를 채우며, 근거가 없으면 생략하지 말고 `없음`, `확인 불가`, `확인 필요` 중 하나로 명시한다.
|
|
- `판단 근거`에는 브랜치, 변경 파일, 로드맵 근거, 코드/테스트 근거를 각각 분리해 적는다.
|
|
- `남은 작업`은 `확인됨`, `추정됨`, `확인 필요` 세 분류를 모두 유지한다.
|
|
- `다음 행동`에는 가장 우선해야 할 실행 또는 확인을 1~2개만 적는다.
|
|
- `읽은 주요 파일`에는 실제로 읽은 핵심 파일만 적는다.
|
|
|
|
Milestone을 하나로 확정할 수 없으면 후보 Milestone마다 링크를 출력한다.
|
|
Milestone 문서 경로를 찾지 못한 경우에도 링크 항목을 생략하지 말고 `링크 확인 불가: <이유>`와 확인한 로드맵 파일 경로를 함께 적는다.
|
|
|
|
## 실행 결과 검증
|
|
|
|
- [ ] `roadmap-position-report-template.md`를 읽고 그 섹션 순서와 필드명을 유지했는가
|
|
- [ ] `current.md`만 근거로 현재 위치를 단정하지 않았는가
|
|
- [ ] 활성 Milestone 문서의 목표와 범위 제외 항목을 확인했는가
|
|
- [ ] `agent-ops/roadmap/archive/**` 문서를 명시 요청 없이 읽지 않았는가
|
|
- [ ] 활성 Milestone 문서의 `구현 잠금` 섹션 존재 여부, 상태, `결정 필요` 항목을 확인했는가
|
|
- [ ] 추정 Milestone마다 문서 링크를 출력했는가
|
|
- [ ] 관련 `필수 기능` 항목에 item-id가 있으면 결과에 함께 표시했는가
|
|
- [ ] 변경 파일 또는 사용자 요청과 Milestone 판단 근거가 연결되어 있는가
|
|
- [ ] 남은 작업을 `확인됨`, `추정됨`, `확인 필요`로 구분했는가
|
|
- [ ] 템플릿 필드를 근거 없이 생략하지 않고 `없음`, `확인 불가`, `확인 필요`로 채웠는가
|
|
- [ ] 로드맵 파일을 수정하지 않았는가
|
|
- 검증 실패 시: 부족한 근거를 명시하고 신뢰도를 낮춘다. Milestone 링크 누락은 출력 전 반드시 보정한다.
|
|
|
|
## 출력 형식
|
|
|
|
- 템플릿 경로: `agent-ops/skills/common/_templates/roadmap-position-report-template.md`
|
|
- 템플릿을 그대로 복사해 placeholder를 채운다.
|
|
- 섹션 제목과 필드명을 임의로 번역, 축약, 삭제하지 않는다.
|
|
- 값이 없는 필드는 `없음`, `확인 불가`, `확인 필요` 중 하나로 채운다.
|
|
|
|
## 금지 사항
|
|
|
|
- `current.md`만 읽고 현재 작업 위치를 확정하지 않는다.
|
|
- 사용자가 명시하지 않은 상태에서 `ROADMAP.md`, `current.md`, Milestone 문서를 수정하지 않는다.
|
|
- 사용자가 명시하지 않은 상태에서 `agent-ops/roadmap/archive/**`를 읽지 않는다.
|
|
- evidence 없이 Milestone이나 기능을 완료 처리하지 않는다.
|
|
- 활성 Milestone 밖 작업을 임의로 새 Milestone으로 추가하지 않는다.
|