菜单
셀프호스팅 Plane(프로젝트 관리, Jira/Confluence 대체) REST API 워크벤치. 프로젝트/work item/사이클/모듈/코멘트/멤버/상태/라벨 CRUD + Jira→Plane 이관. 의존성 0(Python stdlib만), self-host 지원. 'plane', 'plane 이슈', '워크아이템', 'jira 옮겨', 'jira to plane', 'confluence 옮겨', '사이클', '모듈', 'work item', 'plane 프로젝트' 호출 시 사용.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
基于 SOC 职业分类
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/junghan0611/agent-config --skill plane命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
agent-config 루트의 대문자 하네스 벤치(HERMES / OMP / OUROBOROS / HERDR / PRIME / YEGGE) 상태를 보고, 리서치 뒤 그 문서를 갱신한다. 채택이 아니다. 스킬 주입·라이브 setup 금지. 트리거: '하네스 리서치', 'HERMES', 'OMP.md', 'OUROBOROS', 'HERDR', 'PRIME', 'prime-agent', 'YEGGE', '벤치', '대문자 문서', 'harness bench', 'harness research'.
에이전트가 GLG에게 텔레그램 DM 한 줄을 보낸다. 긴 작업 도중 알릴 것이 생겼을 때, 사람이 터미널 앞에 없어도 닿는 유일한 경로. 양식은 'DM <기기> <리포> <하네스/모델>' + 본문. 트리거: 'dm', 'DM 보내', '텔레그램으로 알려', '나한테 알려줘', '끝나면 알려', 'notify me', 'ping me'.
지금 어느 형제가 어디서 무엇을 하는 중인지 한 장으로 세우고, 다음 한 수(살아있는 형제에게 보낼지 · 잠든 형제를 같은 id로 되세울지 · 새 형제를 열지)를 고를 재료를 주는 판단 도우미. `situation`이 meta-record(사실)와 transcript(추정)를 같은 평면에 올리고, `peek`이 한 세션 안을 들여다본다. 실행은 하지 않는다 — 부르는 것은 entwurf_v2 / entwurf_resume_call / entwurf_fresh_call이고, 무엇을 부를지는 GLG가 정한다. placement(tmux server/window/pane) 사실의 출처가 아니다. 트리거: '누가 뭐 하고 있지', '분신 현황', '지금 살아있는 형제', 'situation', 'entwurf-peek', '누구한테 맡길까', '다시 부를까', 'peek session', '분신 추적'.
| name | plane |
| description | 셀프호스팅 Plane(프로젝트 관리, Jira/Confluence 대체) REST API 워크벤치. 프로젝트/work item/사이클/모듈/코멘트/멤버/상태/라벨 CRUD + Jira→Plane 이관. 의존성 0(Python stdlib만), self-host 지원. 'plane', 'plane 이슈', '워크아이템', 'jira 옮겨', 'jira to plane', 'confluence 옮겨', '사이클', '모듈', 'work item', 'plane 프로젝트' 호출 시 사용. |
셀프호스팅 서버에 떠있는 Plane(Jira/Confluence 대체)을 REST API로 조작한다.
적재(load) 손이다. 추출(extract)은 jiracli 스킬이 담당 — 둘을 이어 Jira→Plane 이관.
베이스: JinkoLLC/plane-skill(MIT, 단일 스크립트·무의존) 벤더링 +
아이디어 차용: cpatrickalves/plane-cli(fuzzy 해석·커맨드 커버리지).
~/.env.local 에 저장됨 (비공개, gitignore). 호출 전 항상 source ~/.env.local.
export PLANE_API_KEY="plane_api_..." # Plane → Settings → API Tokens
export PLANE_BASE_URL="http://localhost:3388" # 서버에서 직접(=CF Access 회피)
export PLANE_WORKSPACE="test" # 워크스페이스 슬러그
localhost:3388 직격 → Cloudflare Zero Trust 로그인 게이트 회피.
노트북에서 굴리려면 https://plane.<your-domain> + CF service token 필요(지금은 오버).X-API-Key. 경로: {BASE_URL}/api/v1/....PLANE="$HOME/.claude/skills/plane/scripts/plane"
source ~/.env.local
# 내 정보 / 멤버
"$PLANE" me
"$PLANE" members
# 프로젝트
"$PLANE" projects list
"$PLANE" projects get --project <PROJ_UUID>
"$PLANE" projects create --name "마이그레이션" --identifier MIG --description "..."
# work item (이슈)
"$PLANE" issues list --project <PROJ_UUID> [--state <ID>] [--priority high]
"$PLANE" issues get --project <PROJ_UUID> <ISSUE_UUID>
"$PLANE" issues create --project <PROJ_UUID> --name "제목" \
--description "본문" --priority high
"$PLANE" issues update --project <PROJ_UUID> <ISSUE_UUID> --state <STATE_ID>
"$PLANE" issues assign --project <PROJ_UUID> <ISSUE_UUID> <USER_ID> [<USER_ID>...]
"$PLANE" issues delete --project <PROJ_UUID> <ISSUE_UUID>
"$PLANE" issues search --query "키워드"
# 사이클(스프린트) / 모듈
"$PLANE" cycles list --project <PROJ_UUID>
"$PLANE" cycles create --project <PROJ_UUID> --name "Sprint 1" \
--start-date 2026-06-18 --end-date 2026-07-01
"$PLANE" modules list --project <PROJ_UUID>
"$PLANE" modules create --project <PROJ_UUID> --name "결제 모듈"
# 코멘트 / 상태 / 라벨
"$PLANE" comments list --project <PROJ_UUID> --issue <ISSUE_UUID>
"$PLANE" comments add --project <PROJ_UUID> --issue <ISSUE_UUID> --text "코멘트"
"$PLANE" states --project <PROJ_UUID> # flat 커맨드(하위 list 없음)
"$PLANE" labels --project <PROJ_UUID> # flat 커맨드(하위 list 없음)
--format json 으로 모든 출력 JSON 전환(스크립팅용). 기본은 컬러 테이블.
confluence_to_md.py)Confluence 문서는 Plane Pages(HTML/블록)가 아니라 순수 .md 파일 트리로 끌어내린다.
Plane Pages도 결국 description_html + collab binary 저장이라 "활용 가능한 포맷"이 아니다.
문서 SSOT = git 관리 md 트리. Plane Pages 는 선택적 렌더 타겟일 뿐.
PY="$HOME/.claude/skills/plane/scripts/confluence_to_md.py"
source ~/.env.local # JIRA_HOST / JIRA_USER_EMAIL / JIRA_API_TOKEN
# 스페이스 전체 (dry-run: 트리/카운트만)
"$PY" --space QA --out ~/repos/gh/memex-kb/docs/confluence
# 실제 추출
"$PY" --space QA --out <DIR> --apply
# 단일 페이지 + 하위 트리
"$PY" --page-id 426033 --out <DIR> --apply
설계 (선행 자산 통합): jiracli/confluence_ingest.py(REST+front matter) +
memex-kb/confluence_to_markdown.py(cleanup + NFC) 를 흡수.
body-format=export_view — 매크로/코드/이미지가 이미 렌더된 정적 HTML.-t markdown(grid table — -t gfm 은 colspan 표를 raw HTML 로 떨굼).unicodedata.normalize('NFC') 안전망(NFD 페이지 자동 교정). 박살이 관측되면 pandoc 폐기._assets/<pageid>/ 다운로드 + 상대경로 치환.source_version → 멱등(버전 동일하면 skip).| 요소 | 결과 |
|---|---|
| 제목/본문/헤딩/리스트/링크 | ✅ 깔끔한 md |
| 표 | ✅ grid table (+---+) — colspan 포함 |
| 이미지/첨부 | ✅ 다운로드 + 상대경로 |
| 한글 | ✅ NFC 보존 |
| Confluence 매크로(jira/include/toc/drawio) | ⚠️ export_view 시점 정적 렌더로 흡수(동적기능 상실) |
| inline comment / page restrictions / 버전 본문 | ❌ 유실(source_version 메타만) |
md_to_plane_pages.py)md SSOT 를 Plane 안에서도 열람하려면 Pages 로 올린다. pages-api-patch 오버레이 필수 (self-host v1 에 pages POST/PATCH 노출 — hej-kip/plane/pages-api-patch).
PY="$HOME/.claude/skills/plane/scripts/md_to_plane_pages.py"
"$PY" --dir <MD_DIR> --project <PLANE_PROJ_UUID> # dry-run
"$PY" --dir <MD_DIR> --project <PLANE_PROJ_UUID> --apply # 업로드
-f gfm -t html. 멱등: page title 매칭(external_id 없음) → 있으면 PATCH._assets/ 상대경로는 Plane 에서 안 풀린다(asset 업로드 미구현 — phase 2).
이미지까지 Plane 에 박으려면 generic asset API(/workspaces/<slug>/assets/) 업로드 필요.데이터 동제권 경로: Jira(클라우드) → 중립 포맷 → Plane(셀프호스트), 단방향·read-only 연습. (공식 임포터 UI는 Commercial 전용 — Community 셀프호스트엔 없음. 그래서 API 직접 이관이 정답.)
[jiracli: 추출] [변환] [plane: 적재]
jira issue list -p X --raw → 필드 매핑(JSON) → plane issues create
jira issue view KEY --raw ↓ plane comments add
상태/우선순위/유저 매핑 plane cycles/modules create
추출 명령(jiracli, --raw = Jira API 원본 JSON):
source ~/.env.local && jira issue list -p PROJ --raw # 프로젝트 전체
source ~/.env.local && jira issue view PROJ-123 --raw # 단건 상세(코멘트 포함)
| Jira | Plane | 비고 |
|---|---|---|
| issue | work item | name=summary, description_html=description |
| status | state | 프로젝트 state로 사전 매핑(states로 ID 확보) |
| priority | priority | Highest/High→urgent/high, Medium→medium, Low/Lowest→low |
| labels | labels | labels로 ID 매핑(없으면 생성) |
| comments | comments | 작성자·시각은 본문에 prefix(API가 작성자 위조 불가) |
| sprint | cycle | start/end date 보존 |
| component | module | — |
| assignee | assignee | Jira 이메일 → Plane member ID 매핑(members) |
| parent/subtask | parent | 직계만 |
| custom field / epic / history | ✗ | 안 넘어옴. 손매핑 or 라벨/본문에 흡수 |
jira_to_plane.py 는 Plane 네이티브 external_id(=Jira key) + external_source(=jira:HOST)
로 dedup — 재실행 시 409 로 기존 id 를 회수해 중복 생성 0(이름 prefix 불필요).
2-pass: 1차 전량 생성(external_id/created_at/created_by/state/assignee) → 2차 부모(parent) 배선.
429 RATE_LIMIT 은 Retry-After/지수 백오프로 자동 재시도. 첫 실행은 --limit 소량으로 확인 후 전량.
실측(MAT 84건): 생성/기존 84 · 실패 0 · 부모연결 80 · created_at 백데이트 보존.
--format json + 커서 추적
또는 DB 직접 카운트(docker compose exec -e PGPASSWORD=plane plane-db psql -U plane -d plane -t -c "SELECT count(*) FROM issues;").issues delete 신중히.~/.env.local에만. 이 스킬 코드(공개 repo)엔 절대 박지 않는다.plane/ 디렉토리