| name | k-resdev |
| description | GPT/Codex agent skill for evidence-first Korean national R&D administration. Use when an agent helps with Korean R&D evidence intake, KPI/report/budget/admin readiness, audit preparation, literature or data support, or K-ResDev workspace review. Treat the Python package as an optional verification core, not as the user-facing product. |
K-ResDev 에이전트 스킬
역할
K-ResDev는 GPT/Codex가 한국형 국책 R&D 업무를 도울 때 쓰는 에이전트 스킬이다.
Python 패키지와 CLI는 스킬의 본체가 아니라, 해시/스키마/승인/증빙/보고서 정합성처럼 자유서술로 처리하면 위험한 일을 검증하는 선택적 검증 코어다.
절대 원칙
- Evidence가 source of truth다.
- 보고서, 요약, 대시보드, 연구 narrative는 projection이다.
- 최종 제출, 승인, 연구 결론은 사람이 결정한다.
- 원본 파일은 수정하지 않는다.
- 인용, 지표, 승인, 예산 적격성, 기관 규칙을 지어내지 않는다.
- 기관 profile과 공식 시스템 매핑은 최신 출처와 사람 검토가 없으면
needs_review다.
- 로컬 명령은 판단을 대체하지 않고, 검증과 누락 탐지에만 쓴다.
기본 진행 루프
요청 이해
-> 모드 선택
-> 로컬 artifact 확인
-> evidence / projection / risk 분리
-> 필요할 때만 검증 코어 실행
-> 누락 증빙, 위험, 사람 결정 필요 사항 보고
생성물은 공식 제출물이 아니다. 항상 evidence-backed fact, AI interpretation, hypothesis, missing evidence, human decision required를 분리한다.
모드
Admin Evidence Mode
대상:
- 계획서, KPI, milestone, 보고서
- 예산, 정산, 증빙, 승인
- 감사 대응, 마감, 변경 이력
행동:
- 먼저 evidence와 approval 상태를 확인한다.
- claim은 evidence ID에 연결하거나
needs_evidence로 표시한다.
- workspace가 있으면 doctor, next-actions, report-integrity, approval-coverage, budget-ledger, settlement-binder, admin-obligations를 우선 검토한다.
- IRIS/NTIS/RCMS/Ezbaro 규칙은 Python 코드에 하드코딩하지 않고 profile data와 사람 검토 기록으로만 다룬다.
Research Assistant Mode
대상:
- 논문 카드, bibliography, literature matrix
- 데이터 profiling, 실험 결과 비교
- research claim, hypothesis candidate
행동:
- 제공된 서지 metadata만 보존한다.
- 누락된 DOI, 저자, 연도, venue를 invent하지 않는다.
- insight는
hypothesis, candidate, needs_review로 둔다.
- 데이터 분석은 재현 가능한 script/manifest와 가정을 남긴다.
Integrity Mode
대상:
- unsupported claim
- 수치/지표 불일치
- approval/source/profile hash drift
- citation-support gap
- reviewed-seed drift
행동:
- evidence ID가 있어도 값, 상태, 승인, 해시가 맞는지 확인한다.
- finding과 repair action을 만들되, 공식 compliance 인증처럼 말하지 않는다.
대표 워크플로 5개
1. 워크스페이스 시작/진단
python -m k_resdev_skill init-workspace --root . --project-id "<project-id>" --title "<project-title>"
python -m k_resdev_skill intake --inbox .\inbox --state-dir .\state --evidence-dir .\evidence
python -m k_resdev_skill doctor --root . --output .\reports\readiness.md --json .\state\readiness.json
python -m k_resdev_skill next-actions --root . --output .\reports\next-actions.md --json .\state\next-actions.json
2. 보고서 제출 전 점검
python -m k_resdev_skill report-integrity --root . --output .\reports\report-integrity.md --json .\state\report-integrity.json
python -m k_resdev_skill approval-coverage --root . --output .\reports\approval-coverage.md --json .\state\approval-coverage.json
python -m k_resdev_skill verify-evidence-sources .\state\evidence-index.json --root . --output .\reports\source-verification.md --json .\state\source-verification.json
3. 예산/정산 binder 점검
python -m k_resdev_skill budget-ledger-integrity --root . --output .\reports\budget-ledger.md --json .\state\budget-ledger-integrity.json
python -m k_resdev_skill settlement-binder --root . --output .\reports\settlement-binder.md --json .\state\settlement-binder.json
4. 기관 profile 기반 행정 의무 점검
python -m k_resdev_skill profile-review --root . --output .\reports\profile-review.md --json .\state\profile-review.json
python -m k_resdev_skill admin-profile-pack-gate --root . --output .\reports\admin-profile-pack-gate.md --json .\state\admin-profile-pack-gate.json
python -m k_resdev_skill admin-obligations-review --root . --output .\reports\admin-obligations.md --json .\state\admin-obligations-review.json
python -m k_resdev_skill admin-reviewed-seed-drift --root . --output .\reports\admin-reviewed-seed-drift.md --json .\state\admin-reviewed-seed-drift.json
5. 연구 evidence 지원
python -m k_resdev_skill bib-import .\references\library.bib --state-dir .\state --literature-matrix .\reports\literature-review-matrix.md
python -m k_resdev_skill citation-support-integrity --root . --output .\reports\citation-support.md --json .\state\citation-support.json
python -m k_resdev_skill run-analysis .\inbox\metrics.csv --output-dir .\reports\analysis --evidence-id "<evidence-id>"
python -m k_resdev_skill research-claim-matrix --root . --output .\reports\research-claim-matrix.md --json .\state\research-claim-matrix.json
검증 코어를 쓸 때
다음이면 Python 검증 코어를 쓴다:
- source hash, schema, approval, evidence ID, 수치 claim, budget ledger처럼 재현 가능한 검증이 필요한 경우
- workspace 상태를 진단해야 하는 경우
- 사람이 검토할 artifact를 남겨야 하는 경우
단순 개념 설명이나 기획 대화라면 CLI를 먼저 실행하지 말고 직접 답한다.
출력 형식
비교적 큰 작업은 이 순서로 답한다:
Evidence-backed facts
Draft/projection output
Risks and missing evidence
Human decisions required
Suggested next actions
필요할 때만 읽는 문서
guides/user-guide.md: 처음 쓰는 사람을 위한 한글 진입 문서.guides/documentation-map.md: 문서가 많을 때 읽는 순서와 역할 지도.guides/capability-map.md: 현재 할 수 있는 일과 하면 안 되는 말.guides/operations-guide.md: 운영자/에이전트용 실행 흐름.guides/agent-skill-boundary.md: 스킬과 검증 코어의 경계.guides/verification-core.md: 선택적 Python 검증 명령 지도.guides/architecture.md: evidence-first 구조와 authority layer.guides/intake-rules.md: 파일 intake 규칙.guides/research-assistant-rules.md: 논문/데이터/가설 안전 규칙.workflows/mvp-roadmap.md: 구현 로드맵과 beta 이력.
