From d41b1dae67447dc2e1bd23b8193f8d02a5744ce5 Mon Sep 17 00:00:00 2001 From: toki Date: Sat, 23 May 2026 18:50:36 +0900 Subject: [PATCH] sync: agent-ops from agentic-framework v1.1.26 --- .../common/analyze-roadmap-position/SKILL.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/agent-ops/skills/common/analyze-roadmap-position/SKILL.md b/agent-ops/skills/common/analyze-roadmap-position/SKILL.md index 8cc2d4f..66e86a3 100644 --- a/agent-ops/skills/common/analyze-roadmap-position/SKILL.md +++ b/agent-ops/skills/common/analyze-roadmap-position/SKILL.md @@ -1,7 +1,7 @@ --- name: analyze-roadmap-position -version: 1.0.0 -description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확인 요청에 대해 활성 Milestone과 코드 상태를 함께 읽어 현재 작업 지점과 남은 일을 추정하는 읽기 전용 스킬" +version: 1.0.1 +description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확인 요청에 대해 활성 Milestone과 코드 상태를 함께 읽어 현재 작업 지점, Milestone 문서 링크, 남은 일을 추정하는 읽기 전용 스킬" --- # 작업 지점 분석 @@ -9,6 +9,7 @@ description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확 ## 목적 현재 브랜치, 변경 파일, 코드 구조, 활성 Milestone 문서를 함께 분석해 지금 작업이 어느 Milestone에 걸쳐 있는지와 남은 작업 후보를 보고한다. +결과에는 추정한 Milestone의 문서 링크를 항상 함께 출력한다. `current.md`만 보고 현재 작업 위치를 단정하지 않고, 실제 코드 상태와 요청 내용을 근거로 판단한다. ## 언제 호출할지 @@ -28,6 +29,7 @@ description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확 - [ ] `agent-ops/roadmap/current.md` 존재 여부 확인 - [ ] `current.md`의 활성 Milestone 목록이 가리키는 문서 존재 여부 확인 +- [ ] 활성 Milestone 이름과 문서 경로를 결과 출력에 쓸 Markdown 링크로 기록 - [ ] git 저장소이면 현재 브랜치, `git status --short`, 변경 파일 목록 확인 - [ ] 변경 파일이 있으면 `agent-ops/rules/project/rules.md`의 도메인 매핑 기준으로 관련 domain rule 확인 @@ -36,6 +38,7 @@ description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확 1. **활성 Milestone 창 확인** - `agent-ops/roadmap/current.md`를 읽고 활성 Milestone 후보와 선택 규칙을 파악한다. - 활성 Milestone 문서를 모두 읽되, 목록이 많으면 사용자 요청이나 변경 파일과 관련 높은 문서부터 읽는다. + - 읽은 Milestone은 `: ` 형태로 보존하고, 결과 보고에서는 `[]()` Markdown 링크로 출력한다. - `current.md`가 없거나 형식이 맞지 않으면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 불확실성을 보고한다. 2. **작업 흔적 확인** @@ -57,20 +60,25 @@ description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확 5. **결과 보고** - 추정 Milestone과 신뢰도 + - 추정 Milestone 문서 링크 - 판단 근거 - 구현된 것으로 보이는 부분 - 남은 작업 - 확인 필요 항목 - 읽은 주요 파일 +Milestone을 하나로 확정할 수 없으면 후보 Milestone마다 링크를 출력한다. +Milestone 문서 경로를 찾지 못한 경우에도 링크 항목을 생략하지 말고 `링크 확인 불가: <이유>`와 확인한 로드맵 파일 경로를 함께 적는다. + ## 실행 결과 검증 - [ ] `current.md`만 근거로 현재 위치를 단정하지 않았는가 - [ ] 활성 Milestone 문서의 목표와 범위 제외 항목을 확인했는가 +- [ ] 추정 Milestone마다 문서 링크를 출력했는가 - [ ] 변경 파일 또는 사용자 요청과 Milestone 판단 근거가 연결되어 있는가 - [ ] 남은 작업을 `확인됨`, `추정됨`, `확인 필요`로 구분했는가 - [ ] 로드맵 파일을 수정하지 않았는가 -- 검증 실패 시: 부족한 근거를 명시하고 신뢰도를 낮춘다. +- 검증 실패 시: 부족한 근거를 명시하고 신뢰도를 낮춘다. Milestone 링크 누락은 출력 전 반드시 보정한다. ## 출력 형식 @@ -78,6 +86,7 @@ description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확 ## 현재 작업 분석 - 추정 Milestone: +- Milestone 링크: [](agent-ops/roadmap/milestones/.md) - 신뢰도: <높음 | 중간 | 낮음> ## 근거