toki/proto-socket
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

sync: agent-ops from agentic-framework v1.1.32

Browse source
This commit is contained in:
toki 2026-05-24 09:19:20 +09:00
parent 9dabb42506
commit fd442bb910
10 changed files with 68 additions and 36 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
.clinerules
View file

@ -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회 읽는다. 파일이 없으면 무시한다.

2
.cursorrules
View file

@ -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회 읽는다. 파일이 없으면 무시한다.

2
AGENTS.md
View file

@ -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회 읽는다. 파일이 없으면 무시한다.

2
CLAUDE.md
View file

@ -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회 읽는다. 파일이 없으면 무시한다.

2
GEMINI.md
View file

@ -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회 읽는다. 파일이 없으면 무시한다.

2
agent-ops/.version
View file

@ -1 +1 @@
1.1.31
1.1.32

1
agent-ops/rules/common/rules-roadmap.md
View file

@ -35,6 +35,7 @@
## 작업 지점 분석
- 현재 작업 지점이나 남은 작업 분석 요청은 `analyze-roadmap-position` 스킬로 처리한다.
- 분석 답변은 `agent-ops/skills/common/_templates/roadmap-position-report-template.md` 섹션과 필드 순서를 따른다.
- 이때 `current.md`만으로 단정하지 말고 코드, git 상태, diff, 활성 Milestone 문서를 함께 본다.
## Milestone 아카이브

2
agent-ops/rules/common/rules.md
View file

@ -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회 읽는다. 파일이 없으면 무시한다.

38
agent-ops/skills/common/_templates/roadmap-position-report-template.md Normal file
View file

@ -0,0 +1,38 @@
# 현재 작업 분석
- 추정 Milestone: <milestone-name 또는 복수 후보>
- Milestone 링크: [<milestone-name>](agent-ops/roadmap/milestones/<milestone-slug>.md)
- 신뢰도: <높음 | 중간 | 낮음>
- 구현 잠금: <해제 | 잠금 | 정보 없음>
- 한 줄 결론: <현재 작업 지점과 가장 중요한 다음 판단을 1문장으로 요약>
## 판단 근거
- 브랜치: <branch-name 또는 확인 불가>
- 변경 파일: <없음 | N개, 핵심 경로 요약>
- 로드맵 근거: <Milestone 목표/범위/필수 기능/완료 기준과 연결된 근거>
- 코드/테스트 근거: <코드, 테스트, diff, 문서에서 확인한 근거>
## 구현된 것으로 보이는 부분
- 확인됨: [<item-id 또는 해당 없음>] <코드/문서/테스트 근거가 있는 완료 후보>
## 남은 작업
- 확인됨: [<item-id 또는 신규 id 필요>] <코드/문서/테스트 근거로 남았다고 볼 수 있는 작업>
- 추정됨: [<item-id 또는 신규 id 필요>] <구조상 필요해 보이나 추가 확인이 필요한 작업>
- 확인 필요: [<item-id 또는 신규 id 필요>] <사용자 판단, 범위 결정, 제품 의도가 필요한 작업>
## 위험/불확실성
- <없음 또는 신뢰도를 낮춘 이유, 누락된 근거, 잠금/링크/템플릿 문제>
## 다음 행동
- 우선순위 1: <가장 먼저 할 작업 또는 확인>
- 우선순위 2: <다음 작업 또는 확인>
- 사용자 확인 필요: <없음 또는 사용자 결정이 필요한 질문>
## 읽은 주요 파일
- <path>

51
agent-ops/skills/common/analyze-roadmap-position/SKILL.md
View file

@ -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-name 또는 복수 후보>
- Milestone 링크: [<milestone-name>](agent-ops/roadmap/milestones/<milestone-slug>.md)
- 신뢰도: <높음 | 중간 | 낮음>
- 구현 잠금: <잠금 | 해제 | 정보 없음>
## 근거
- <변경 파일, 브랜치, 요청 내용, Milestone 범위와 연결된 근거>
## 구현된 것으로 보이는 부분
- <코드/문서 근거가 있는 항목>
## 남은 작업
- 확인됨: [<item-id>] <항목>
- 추정됨: [<item-id>] <항목>
- 확인 필요: [<item-id 또는 신규 id 필요>] <항목>
## 읽은 주요 파일
- <path>
```
- 템플릿 경로: `agent-ops/skills/common/_templates/roadmap-position-report-template.md`
- 템플릿을 그대로 복사해 placeholder를 채운다.
- 섹션 제목과 필드명을 임의로 번역, 축약, 삭제하지 않는다.
- 값이 없는 필드는 `없음`, `확인 불가`, `확인 필요` 중 하나로 채운다.
## 금지 사항