From a888681e5ec6f266b528bc3956a8a1766ba99c98 Mon Sep 17 00:00:00 2001 From: toki Date: Sun, 24 May 2026 09:19:15 +0900 Subject: [PATCH] sync: agent-ops from agentic-framework v1.1.31 --- .clinerules | 2 + .cursorrules | 2 + AGENTS.md | 2 + CLAUDE.md | 2 + GEMINI.md | 2 + agent-ops/.version | 2 +- agent-ops/rules/common/rules-roadmap.md | 1 + agent-ops/rules/common/rules.md | 2 + .../roadmap-position-report-template.md | 38 ++++++++++++++ .../common/analyze-roadmap-position/SKILL.md | 51 ++++++------------- 10 files changed, 68 insertions(+), 36 deletions(-) create mode 100644 agent-ops/skills/common/_templates/roadmap-position-report-template.md diff --git a/.clinerules b/.clinerules index 226a177..2dadabe 100644 --- a/.clinerules +++ b/.clinerules @@ -5,6 +5,8 @@ - 요청 범위를 넘는 변경을 하지 않는다. - 불확실하면 단정하지 말고 후보를 제시한다. - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다. +- 이 프로젝트에서 작업을 하나 완료할 때마다 `agent-ops/bin/bump-version.sh`를 실행해 `agent-ops/.version`을 한 단계 올린다. + 예: `next="$(agent-ops/bin/bump-version.sh "$(cat agent-ops/.version)")" && printf '%s\n' "$next" > agent-ops/.version` `agent-ops/rules/project/rules.md`와 `agent-ops/rules/private/rules.md`는 세션 최초 1회 읽는다. 파일이 없으면 무시한다. diff --git a/.cursorrules b/.cursorrules index 226a177..2dadabe 100644 --- a/.cursorrules +++ b/.cursorrules @@ -5,6 +5,8 @@ - 요청 범위를 넘는 변경을 하지 않는다. - 불확실하면 단정하지 말고 후보를 제시한다. - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다. +- 이 프로젝트에서 작업을 하나 완료할 때마다 `agent-ops/bin/bump-version.sh`를 실행해 `agent-ops/.version`을 한 단계 올린다. + 예: `next="$(agent-ops/bin/bump-version.sh "$(cat agent-ops/.version)")" && printf '%s\n' "$next" > agent-ops/.version` `agent-ops/rules/project/rules.md`와 `agent-ops/rules/private/rules.md`는 세션 최초 1회 읽는다. 파일이 없으면 무시한다. diff --git a/AGENTS.md b/AGENTS.md index 226a177..2dadabe 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -5,6 +5,8 @@ - 요청 범위를 넘는 변경을 하지 않는다. - 불확실하면 단정하지 말고 후보를 제시한다. - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다. +- 이 프로젝트에서 작업을 하나 완료할 때마다 `agent-ops/bin/bump-version.sh`를 실행해 `agent-ops/.version`을 한 단계 올린다. + 예: `next="$(agent-ops/bin/bump-version.sh "$(cat agent-ops/.version)")" && printf '%s\n' "$next" > agent-ops/.version` `agent-ops/rules/project/rules.md`와 `agent-ops/rules/private/rules.md`는 세션 최초 1회 읽는다. 파일이 없으면 무시한다. diff --git a/CLAUDE.md b/CLAUDE.md index 226a177..2dadabe 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -5,6 +5,8 @@ - 요청 범위를 넘는 변경을 하지 않는다. - 불확실하면 단정하지 말고 후보를 제시한다. - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다. +- 이 프로젝트에서 작업을 하나 완료할 때마다 `agent-ops/bin/bump-version.sh`를 실행해 `agent-ops/.version`을 한 단계 올린다. + 예: `next="$(agent-ops/bin/bump-version.sh "$(cat agent-ops/.version)")" && printf '%s\n' "$next" > agent-ops/.version` `agent-ops/rules/project/rules.md`와 `agent-ops/rules/private/rules.md`는 세션 최초 1회 읽는다. 파일이 없으면 무시한다. diff --git a/GEMINI.md b/GEMINI.md index 226a177..2dadabe 100644 --- a/GEMINI.md +++ b/GEMINI.md @@ -5,6 +5,8 @@ - 요청 범위를 넘는 변경을 하지 않는다. - 불확실하면 단정하지 말고 후보를 제시한다. - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다. +- 이 프로젝트에서 작업을 하나 완료할 때마다 `agent-ops/bin/bump-version.sh`를 실행해 `agent-ops/.version`을 한 단계 올린다. + 예: `next="$(agent-ops/bin/bump-version.sh "$(cat agent-ops/.version)")" && printf '%s\n' "$next" > agent-ops/.version` `agent-ops/rules/project/rules.md`와 `agent-ops/rules/private/rules.md`는 세션 최초 1회 읽는다. 파일이 없으면 무시한다. diff --git a/agent-ops/.version b/agent-ops/.version index c1847bf..ba7b2f7 100644 --- a/agent-ops/.version +++ b/agent-ops/.version @@ -1 +1 @@ -1.1.31 +1.1.32 diff --git a/agent-ops/rules/common/rules-roadmap.md b/agent-ops/rules/common/rules-roadmap.md index b9a0975..2ee7dae 100644 --- a/agent-ops/rules/common/rules-roadmap.md +++ b/agent-ops/rules/common/rules-roadmap.md @@ -35,6 +35,7 @@ ## 작업 지점 분석 - 현재 작업 지점이나 남은 작업 분석 요청은 `analyze-roadmap-position` 스킬로 처리한다. +- 분석 답변은 `agent-ops/skills/common/_templates/roadmap-position-report-template.md` 섹션과 필드 순서를 따른다. - 이때 `current.md`만으로 단정하지 말고 코드, git 상태, diff, 활성 Milestone 문서를 함께 본다. ## Milestone 아카이브 diff --git a/agent-ops/rules/common/rules.md b/agent-ops/rules/common/rules.md index 226a177..2dadabe 100644 --- a/agent-ops/rules/common/rules.md +++ b/agent-ops/rules/common/rules.md @@ -5,6 +5,8 @@ - 요청 범위를 넘는 변경을 하지 않는다. - 불확실하면 단정하지 말고 후보를 제시한다. - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다. +- 이 프로젝트에서 작업을 하나 완료할 때마다 `agent-ops/bin/bump-version.sh`를 실행해 `agent-ops/.version`을 한 단계 올린다. + 예: `next="$(agent-ops/bin/bump-version.sh "$(cat agent-ops/.version)")" && printf '%s\n' "$next" > agent-ops/.version` `agent-ops/rules/project/rules.md`와 `agent-ops/rules/private/rules.md`는 세션 최초 1회 읽는다. 파일이 없으면 무시한다. diff --git a/agent-ops/skills/common/_templates/roadmap-position-report-template.md b/agent-ops/skills/common/_templates/roadmap-position-report-template.md new file mode 100644 index 0000000..2a93ae8 --- /dev/null +++ b/agent-ops/skills/common/_templates/roadmap-position-report-template.md @@ -0,0 +1,38 @@ +# 현재 작업 분석 + +- 추정 Milestone: +- Milestone 링크: [](agent-ops/roadmap/milestones/.md) +- 신뢰도: <높음 | 중간 | 낮음> +- 구현 잠금: <해제 | 잠금 | 정보 없음> +- 한 줄 결론: <현재 작업 지점과 가장 중요한 다음 판단을 1문장으로 요약> + +## 판단 근거 + +- 브랜치: +- 변경 파일: <없음 | N개, 핵심 경로 요약> +- 로드맵 근거: +- 코드/테스트 근거: <코드, 테스트, diff, 문서에서 확인한 근거> + +## 구현된 것으로 보이는 부분 + +- 확인됨: [] <코드/문서/테스트 근거가 있는 완료 후보> + +## 남은 작업 + +- 확인됨: [] <코드/문서/테스트 근거로 남았다고 볼 수 있는 작업> +- 추정됨: [] <구조상 필요해 보이나 추가 확인이 필요한 작업> +- 확인 필요: [] <사용자 판단, 범위 결정, 제품 의도가 필요한 작업> + +## 위험/불확실성 + +- <없음 또는 신뢰도를 낮춘 이유, 누락된 근거, 잠금/링크/템플릿 문제> + +## 다음 행동 + +- 우선순위 1: <가장 먼저 할 작업 또는 확인> +- 우선순위 2: <다음 작업 또는 확인> +- 사용자 확인 필요: <없음 또는 사용자 결정이 필요한 질문> + +## 읽은 주요 파일 + +- diff --git a/agent-ops/skills/common/analyze-roadmap-position/SKILL.md b/agent-ops/skills/common/analyze-roadmap-position/SKILL.md index 0aa24b3..643d171 100644 --- a/agent-ops/skills/common/analyze-roadmap-position/SKILL.md +++ b/agent-ops/skills/common/analyze-roadmap-position/SKILL.md @@ -1,6 +1,6 @@ --- name: analyze-roadmap-position -version: 1.2.1 +version: 1.3.0 description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확인 요청에 대해 활성 Milestone과 코드 상태를 함께 읽어 현재 작업 지점, Milestone 문서 링크, 남은 일을 추정하는 읽기 전용 스킬" --- @@ -11,6 +11,7 @@ description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확 현재 브랜치, 변경 파일, 코드 구조, 활성 Milestone 문서를 함께 분석해 지금 작업이 어느 Milestone에 걸쳐 있는지와 남은 작업 후보를 보고한다. 결과에는 추정한 Milestone의 문서 링크를 항상 함께 출력한다. Milestone의 `필수 기능` 항목에 item-id가 있으면 남은 작업과 판단 근거에 함께 표시해 사용자가 짧은 id로 후속 지시를 할 수 있게 한다. +결과 보고는 `agent-ops/skills/common/_templates/roadmap-position-report-template.md` 템플릿의 섹션, 필드, 순서를 그대로 따라 작성한다. `current.md`만 보고 현재 작업 위치를 단정하지 않고, 실제 코드 상태와 요청 내용을 근거로 판단한다. ## 언제 호출할지 @@ -28,6 +29,7 @@ Milestone의 `필수 기능` 항목에 item-id가 있으면 남은 작업과 판 ## 먼저 확인할 것 +- [ ] `agent-ops/skills/common/_templates/roadmap-position-report-template.md`를 읽어 최신 답변 템플릿 확인 - [ ] `agent-ops/roadmap/current.md` 존재 여부 확인 - [ ] `current.md`의 활성 Milestone 목록이 가리키는 문서 존재 여부 확인 - [ ] 활성 Milestone 목록이 `agent-ops/roadmap/archive/**` 경로를 가리키지 않는지 확인 @@ -65,20 +67,20 @@ Milestone의 `필수 기능` 항목에 item-id가 있으면 남은 작업과 판 - 완료 여부는 evidence 없이 확정하지 않는다. 5. **결과 보고** - - 추정 Milestone과 신뢰도 - - 추정 Milestone 문서 링크 - - 구현 잠금 상태와 잠금/정보 없음 상태일 때 필요한 다음 조치 - - 판단 근거 - - 구현된 것으로 보이는 부분 - - 남은 작업 - - 확인 필요 항목 - - 읽은 주요 파일 + - `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/**` 문서를 명시 요청 없이 읽지 않았는가 @@ -87,37 +89,16 @@ Milestone 문서 경로를 찾지 못한 경우에도 링크 항목을 생략하 - [ ] 관련 `필수 기능` 항목에 item-id가 있으면 결과에 함께 표시했는가 - [ ] 변경 파일 또는 사용자 요청과 Milestone 판단 근거가 연결되어 있는가 - [ ] 남은 작업을 `확인됨`, `추정됨`, `확인 필요`로 구분했는가 +- [ ] 템플릿 필드를 근거 없이 생략하지 않고 `없음`, `확인 불가`, `확인 필요`로 채웠는가 - [ ] 로드맵 파일을 수정하지 않았는가 - 검증 실패 시: 부족한 근거를 명시하고 신뢰도를 낮춘다. Milestone 링크 누락은 출력 전 반드시 보정한다. ## 출력 형식 -```markdown -## 현재 작업 분석 - -- 추정 Milestone: -- Milestone 링크: [](agent-ops/roadmap/milestones/.md) -- 신뢰도: <높음 | 중간 | 낮음> -- 구현 잠금: <잠금 | 해제 | 정보 없음> - -## 근거 - -- <변경 파일, 브랜치, 요청 내용, Milestone 범위와 연결된 근거> - -## 구현된 것으로 보이는 부분 - -- <코드/문서 근거가 있는 항목> - -## 남은 작업 - -- 확인됨: [] <항목> -- 추정됨: [] <항목> -- 확인 필요: [] <항목> - -## 읽은 주요 파일 - -- -``` +- 템플릿 경로: `agent-ops/skills/common/_templates/roadmap-position-report-template.md` +- 템플릿을 그대로 복사해 placeholder를 채운다. +- 섹션 제목과 필드명을 임의로 번역, 축약, 삭제하지 않는다. +- 값이 없는 필드는 `없음`, `확인 불가`, `확인 필요` 중 하나로 채운다. ## 금지 사항